Crear Transacción Compra Banda

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

POST /TransaccionCompra/Mpos/Banda

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á logueado con un negocio, se toma automáticamente; de lo contrario, este campo se vuelve requerido.
posId	Sí	string	Identificador del POS.
numeroTarjeta	Sí	string	Número completo de la tarjeta de crédito para ejecutar la transacción de compra.
mesVencimiento	Sí	int	Mes de vencimiento de la tarjeta. Debe estar en el rango de 1 a 12.
anioVencimiento	Sí	int	Año de vencimiento de la tarjeta de crédito. Validado por regla específica para MPOS.
monto	Sí	decimal (anulable)	Monto de la transacción en dólares. Debe ser mayor a 0.
tarjetaBan	Sí	string	Número de tarjeta en formato encTRACK2, retornado por el dispositivo MPOS.
llaveTarjetaBan	Sí	string	Llave encTRACK KSN, retornada por el dispositivo MPOS.
datosAdicionales	No	Objeto (Diccionario)	Lista de pares clave/valores relacionados a la transacción, utilizados en reportes y webhooks.

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:

Campo	Tipo Dato	Descripción
idTransaccion	string	Identificador único de la transacción.
esReal	bool	Indica si la transacción de compra fue real. Depende de si el negocio 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 en la que se realizó la transacción.

Ejemplo Respuesta

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