Descartar transacción
Cuando creas un link de pago (POST /transactions) y el cliente final no llega a pagar — abandona el webview, cierra la pestaña, o la intención de pago expira — la transacción queda viva en un estado sin pagar. Descártala para cerrarla explícitamente en lugar de dejarla colgando: deja de ser pagable y tu conciliación refleja el resultado real.
Es el mismo endpoint que usa el flujo de pago por API en su paso de descarte.
POST https://mw.migopayments.com/api/v1/integrations/transactions/{transactionId}/dismiss (Producción)
POST https://sb-mw.migopayments.com/api/v1/integrations/transactions/{transactionId}/dismiss (Sandbox)
Consulta la entrada en el spec en vivo: POST /api/v1/integrations/transactions/{transactionId}/dismiss.
Cuándo descartar
- El cliente abrió la
URLdel link de pago pero cerró el webview sin completar el pago. - El link de pago llegó a su propio TTL sin ser pagado.
- La orden del lado del comercio se canceló antes de que el cliente pagara.
Autenticación y hosts
Autentica con tu merchant token en el header Authorization (token crudo; un prefijo Bearer se tolera y se elimina), igual que al crear un link de pago.
| Entorno | Host |
|---|---|
| Sandbox | https://sb-mw.migopayments.com |
| Producción | https://mw.migopayments.com |
Petición
Usa el uid que recibiste al crear la transacción como {transactionId}.
curl -X POST https://sb-mw.migopayments.com/api/v1/integrations/transactions/RULbsGlJRAWFCi6TkuTEa/dismiss \
-H 'Authorization: <merchant-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 actual | Resultado | Forma de la respuesta |
|---|---|---|
CREATED, USED (link no pagado) | Cambia a DISMISSED, sin llamada upstream | 200 OK (texto plano OK) |
APPROVED, DENIED, EXPIRED, DISMISSED | Rechazado (estado no elegible) | 409 con error.code 4020 |
El descarte es idempotente para los estados sin pagar (CREATED, USED → DISMISSED). Para transacciones de rieles de pago alternativos que pasan por IN_PROGRESS y dependen de un hook de cancelación del procesador, consulta la matriz completa en Descartar transacción (pagos alternativos).
Errores
| HTTP | error.code | Causa |
|---|---|---|
| 400 | 5000 | Falta transactionId |
| 404 | 2000 | Transacción no encontrada |
| 409 | 4020 | El estado de la transacción no es elegible para descartar (APPROVED, DENIED, EXPIRED, DISMISSED) |
Consulta el Catálogo de errores para la descripción completa de cada ownCode y su semántica de reintentos.
Recibir el resultado
Un descarte no dispara un cobro, por lo que no genera un estado terminal de pago. El resultado de los links de pago pagados se entrega a tu backend mediante el Merchant Generic Callback.
Relacionado
- Crear un link de pago — el paso de creación de la transacción.
- Flujo de pago por API (requiere PCI) — cobro directo con datos de tarjeta, que también usa este descarte.
- Anulaciones y reembolsos — para transacciones ya pagadas.
- Descartar transacción (pagos alternativos) — el mismo endpoint para rieles alternativos, con la matriz de
IN_PROGRESS.