Saltar al contenido principal
Migo Docs

Descartar transacción

Cancela una transacción de pago alternativo que el cliente abandonó, o una cuya intención de pago expiró. Idempotente para estados sin pagar (CREATED, USED → DISMISSED); para transacciones en IN_PROGRESS, Migo ejecuta el hook de cancelación del procesador cuando este lo soporta — resolviendo a CANCELLED para procesadores que ejecutan un hook de cancelación dedicado, o a DISMISSED para procesadores que soportan una llamada genérica de cancelación upstream.

POST https://mw.migopayments.com/api/v1/integrations/transactions/{transactionId}/dismiss

Consulta la entrada en el spec en vivo: POST /api/v1/integrations/transactions/{transactionId}/dismiss.

Cuándo descartar​

  • El cliente cerró la pestaña del comercio sin pagar.
  • El QR / botón de pago renderizado por /payments llegó a su propio TTL.
  • La orden del lado del comercio fue cancelada antes de que el cliente pagara.
  • Un push payment de larga duración en IN_PROGRESS debe forzarse a cancelar y el procesador soporta una cancelación upstream.

Petición​

curl -X POST https://mw.migopayments.com/api/v1/integrations/transactions/trx_8f3c2b1d9e7a/dismiss \
-H 'Authorization: Bearer <token>' \
-H 'Content-Type: application/json' \
-d '{ "reason": "user_cancelled" }'

El cuerpo es opcional y sus llaves no son validadas — envía metadatos libres con fines de auditoría.

Matriz de comportamiento​

Estado actualResultadoForma de la respuesta
CREATED, USEDCambia a DISMISSED, sin llamada upstream200 OK (texto plano OK)
IN_PROGRESS (procesador con un hook de cancelación dedicado)Cambia a CANCELLED, se ejecuta el hook de cancelación del procesadorJSON { message, transaction: { uid, status: "CANCELLED" } }
IN_PROGRESS (procesador con una cancelación upstream genérica)Cambia a DISMISSED, se ejecuta la llamada de cancel upstream200 OK (texto plano OK)
IN_PROGRESS (procesador sin ningún hook de cancel)Rechazado405 con error.code 4021
APPROVED, DENIED, EXPIRED, DISMISSEDRechazado (estado no elegible)409 con error.code 4020

yoloQR​

Desde que pides el pago con yoloQR, la transacción se descarta con reglas propias, aunque el QR todavía no se haya emitido. Mientras Migo genera el QR la transacción no admite descarte; una vez emitido, queda en pending:

Estado actualResultadoRespuesta
pendingCambia a cancelled solo en Migo; el proveedor no admite cancelación200, mensaje Transaction cancelled locally y providerCancellation: false
cancelledSin cambios200, mensaje Transaction already cancelled
Cualquier otro, incluida la generación del QR en cursoRechazado409, mensaje Invalid status to cancel transaction
Otra operación cerró la transacción al mismo tiempoSi quedó cancelled, 200; si no, rechazado409, mensaje Transaction state changed before cancellation
Descarte no habilitado para el métodoRechazado405, mensaje Processor not allowed to dismiss transaction
Se canceló, pero falló la notificación posteriorQueda cancelled; Migo la completa500, mensaje Transaction cancelled; finalization requires recovery

Si la transacción no pertenece a tu cuenta, responde 404. Estas respuestas traen success, message y data, sin error.code.

Errores​

HTTPerror.codeCausa
4005000Falta transactionId
4042000Transacción no encontrada
4054021El procesador no permite descartar (sin hook de cancel) para una transacción en IN_PROGRESS
4094020El estado de la transacción no es elegible para descartar (APPROVED, DENIED, EXPIRED, DISMISSED)
500—Configuración del procesador faltante o falló la llamada de cancel upstream

Consulta el Catálogo de errores para la descripción completa de cada ownCode (incluidos 4020 y 4021) y su semántica de reintentos.

Relacionado​