> 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-mpos.md).

# Crear Transacción Compra Mpos

{% hint style="info" %}
POST /TransaccionCompra/Mpos
{% 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á autenticado con datos del negocio, se toma automáticamente; de lo contrario, este campo se vuelve requerido.</td></tr><tr><td valign="top">tlv</td><td valign="top">Sí</td><td valign="top">string</td><td valign="top">TLV de la transacción MPOS. Dato obligatorio.</td></tr><tr><td valign="top">posId</td><td valign="top">Sí</td><td valign="top">string</td><td valign="top">Identificador del POS desde el cual se realiza la transacción.</td></tr><tr><td valign="top">tipoTransaccion</td><td valign="top">Sí</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">datosAdicionales</td><td valign="top">No</td><td valign="top">Objeto (Diccionario)</td><td valign="top">Lista de pares clave/valores asociados a la transacción. Se incluyen en reportes y webhooks. Campos especiales como <em>Email, Celular y Nombre</em> pueden visualizarse en reportes.</td></tr></tbody></table>

### &#x20;Ejemplo Petición

```
{
  "idAplicativo": "string",
  "tlv": "string",
  "posId": "string",
  "tipoTransaccion": 0,
  "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 fue real. Depende de si el negocio asociado 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 y hora en que se realizó la transacción.</td></tr><tr><td valign="top">confirmacionTransaccionTarjetaEmv</td><td valign="top">string</td><td valign="top">Datos de confirmación EMV de la tarjeta.</td></tr><tr><td valign="top">tarjetaParcial</td><td valign="top">string</td><td valign="top">Número parcial de la tarjeta utilizada en la transacción.</td></tr><tr><td valign="top">marca</td><td valign="top">string</td><td valign="top">Marca de la tarjeta (por ejemplo: Visa, MasterCard).</td></tr><tr><td valign="top">tsi</td><td valign="top">string</td><td valign="top">Transaction Status Indicator (TSI) de la transacción.</td></tr><tr><td valign="top">aid</td><td valign="top">string</td><td valign="top">Identificador de la aplicación EMV (AID).</td></tr><tr><td valign="top">rrn</td><td valign="top">string</td><td valign="top">Identificador correlativo de la transacción (Retrieval Reference Number).</td></tr></tbody></table>

### Ejemplo Respuesta:

```
{
  "idTransaccion": "string",
  "esReal": true,
  "esAprobada": true,
  "codigoAutorizacion": "string",
  "mensaje": "string",
  "tipoTransaccion": 0,
  "monto": 0,
  "fechaTransaccion": "2026-03-10T16:33:34.317Z",
  "confirmacionTransaccionTarjetaEmv": "string",
  "tarjetaParcial": "string",
  "marca": "string",
  "tsi": "string",
  "aid": "string",
  "rrn": "string"
}
```