> For the complete documentation index, see [llms.txt](https://docs.wompi.sv/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.wompi.sv/metodos-api/crear-transaccion-compra-banda.md).

# Crear Transacción Compra Banda

{% hint style="info" %}
POST /TransaccionCompra/Mpos/Banda
{% endhint %}

Autenticación: Cuenta Wompi o negocio

Autorización: Requiere permisos adicionales

### Objeto de petición:

<table><thead><tr><th valign="top">Campo</th><th valign="top">Es Requerido</th><th valign="top">Tipo Dato</th><th valign="top">Descripción</th></tr></thead><tbody><tr><td valign="top">idAplicativo</td><td valign="top">Condicional</td><td valign="top">string</td><td valign="top">Identificador del negocio. Si el usuario está logueado con un negocio, se toma automáticamente; de lo contrario, este campo se vuelve requerido.</td></tr><tr><td valign="top">posId</td><td valign="top">Sí</td><td valign="top">string</td><td valign="top">Identificador del POS.</td></tr><tr><td valign="top">numeroTarjeta</td><td valign="top">Sí</td><td valign="top">string</td><td valign="top">Número completo de la tarjeta de crédito para ejecutar la transacción de compra.</td></tr><tr><td valign="top">mesVencimiento</td><td valign="top">Sí</td><td valign="top">int</td><td valign="top">Mes de vencimiento de la tarjeta. Debe estar en el rango de 1 a 12.</td></tr><tr><td valign="top">anioVencimiento</td><td valign="top">Sí</td><td valign="top">int</td><td valign="top">Año de vencimiento de la tarjeta de crédito. Validado por regla específica para MPOS.</td></tr><tr><td valign="top">monto</td><td valign="top">Sí</td><td valign="top">decimal (anulable)</td><td valign="top">Monto de la transacción en dólares. Debe ser mayor a 0.</td></tr><tr><td valign="top">tarjetaBan</td><td valign="top">Sí</td><td valign="top">string</td><td valign="top">Número de tarjeta en formato encTRACK2, retornado por el dispositivo MPOS.</td></tr><tr><td valign="top">llaveTarjetaBan</td><td valign="top">Sí</td><td valign="top">string</td><td valign="top">Llave encTRACK KSN, retornada por el dispositivo MPOS.</td></tr><tr><td valign="top">datosAdicionales</td><td valign="top">No</td><td valign="top">Objeto (Diccionario)</td><td valign="top">Lista de pares clave/valores relacionados a la transacción, utilizados en reportes y webhooks.</td></tr></tbody></table>

### Ejemplo petición:

```
{
  "idAplicativo": "string",
  "posId": "string",
  "numeroTarjeta": "string",
  "mesVencimiento": 0,
  "anioVencimiento": 0,
  "monto": 0,
  "tarjetaBan": "string",
  "llaveTarjetaBan": "string",
  "datosAdicionales": {
    "additionalProp1": "string",
    "additionalProp2": "string",
    "additionalProp3": "string"
  }
}
```

### Objeto de respuesta:

<table><thead><tr><th valign="top">Campo</th><th valign="top">Tipo Dato</th><th valign="top">Descripción</th></tr></thead><tbody><tr><td valign="top">idTransaccion</td><td valign="top">string</td><td valign="top">Identificador único de la transacción.</td></tr><tr><td valign="top">esReal</td><td valign="top">bool</td><td valign="top">Indica si la transacción de compra fue real. Depende de si el negocio está en producción.</td></tr><tr><td valign="top">esAprobada</td><td valign="top">bool</td><td valign="top">Indica si la transacción fue autorizada correctamente.</td></tr><tr><td valign="top">codigoAutorizacion</td><td valign="top">string</td><td valign="top">Código de autorización retornado cuando la transacción es exitosa.</td></tr><tr><td valign="top">mensaje</td><td valign="top">string</td><td valign="top">Mensaje de error retornado cuando la transacción no fue exitosa.</td></tr><tr><td valign="top">tipoTransaccion</td><td valign="top">int</td><td valign="top">Tipo de transacción MPOS. Valores permitidos limitados (por validación) a MPosChip = 4 y MPosContactless = 5.</td></tr><tr><td valign="top">monto</td><td valign="top">decimal</td><td valign="top">Monto de la transacción en dólares.</td></tr><tr><td valign="top">fechaTransaccion</td><td valign="top">DateTimeOffset (anulable)</td><td valign="top">Fecha en la que se realizó la transacción.</td></tr></tbody></table>

### Ejemplo Respuesta

```
{
  "idTransaccion": "string",
  "esReal": true,
  "esAprobada": true,
  "codigoAutorizacion": "string",
  "mensaje": "string",
  "tipoTransaccion": 0,
  "monto": 0,
  "fechaTransaccion": "2026-03-10T16:38:55.964Z"
}
```