Saltar al contenido principal
Migo Docs

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 URL del 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.

EntornoHost
Sandboxhttps://sb-mw.migopayments.com
Producciónhttps://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 actualResultadoForma de la respuesta
CREATED, USED (link no pagado)Cambia a DISMISSED, sin llamada upstream200 OK (texto plano OK)
APPROVED, DENIED, EXPIRED, DISMISSEDRechazado (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​

HTTPerror.codeCausa
4005000Falta transactionId
4042000Transacción no encontrada
4094020El 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​