Crear Transacción Compra Mpos

Permite generar una transacción de mpos con los datos enviados

POST /TransaccionCompra/Mpos

Autenticación: Cuenta Wompi o negocio

Autorización: Requiere permisos adicionales

Objeto de petición:

Campo	Es Requerido	Tipo Dato	Descripción
idAplicativo	Condicional	string	Identificador del negocio. Si el usuario está autenticado con datos del negocio, se toma automáticamente; de lo contrario, este campo se vuelve requerido.
tlv	Sí	string	TLV de la transacción MPOS. Dato obligatorio.
posId	Sí	string	Identificador del POS desde el cual se realiza la transacción.
tipoTransaccion	Sí	int	Tipo de transacción MPOS. Valores permitidos limitados (por validación) a MPosChip = 4 y MPosContactless = 5.
datosAdicionales	No	Objeto (Diccionario)	Lista de pares clave/valores asociados a la transacción. Se incluyen en reportes y webhooks. Campos especiales como Email, Celular y Nombre pueden visualizarse en reportes.

Ejemplo Petición

{
  "idAplicativo": "string",
  "tlv": "string",
  "posId": "string",
  "tipoTransaccion": 0,
  "datosAdicionales": {
    "additionalProp1": "string",
    "additionalProp2": "string",
    "additionalProp3": "string"
  }
}

Objeto de respuesta:

Campo	Tipo Dato	Descripción
idTransaccion	string	Identificador único de la transacción.
esReal	bool	Indica si la transacción fue real. Depende de si el negocio asociado está en producción.
esAprobada	bool	Indica si la transacción fue autorizada correctamente.
codigoAutorizacion	string	Código de autorización retornado cuando la transacción es exitosa.
mensaje	string	Mensaje de error retornado cuando la transacción no fue exitosa.
tipoTransaccion	int	Tipo de transacción MPOS. Valores permitidos limitados (por validación) a MPosChip = 4 y MPosContactless = 5.
monto	decimal	Monto de la transacción en dólares.
fechaTransaccion	DateTimeOffset (anulable)	Fecha y hora en que se realizó la transacción.
confirmacionTransaccionTarjetaEmv	string	Datos de confirmación EMV de la tarjeta.
tarjetaParcial	string	Número parcial de la tarjeta utilizada en la transacción.
marca	string	Marca de la tarjeta (por ejemplo: Visa, MasterCard).
tsi	string	Transaction Status Indicator (TSI) de la transacción.
aid	string	Identificador de la aplicación EMV (AID).
rrn	string	Identificador correlativo de la transacción (Retrieval Reference Number).

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"
}