Saltar al contenido principal
Migo Docs

Webhooks y notificaciones

El servicio cr-webhooks recibe los callbacks asíncronos del banco, del colector y de EventBridge. Ninguno de estos endpoints pasa por el TOKEN Authorizer de Migo.

Webhooks disponibles​

EventoMétodoPathEmisor
Respuesta de afiliaciónPOST/webhooks/merchants/{merchant}/users/{user}/banks/{bank}/affiliationsBanco
Actualización de cuentaPOST/webhooks/banks/{bank}/accounts/updatesBanco
Pago de colectorPOST/webhooks/collectors/{collector}/paymentColector externo
Autorización unbankedPOST/webhooks/unbanked/credits/authorizeMO (procesador)
Cancelación automáticaPOST/webhooks/transactions/cancellationMigo (automático)

La respuesta de afiliación está documentada en Afiliación bancaria y OTP, la actualización de cuenta en Consulta de cuenta y la cancelación automática en Ciclo de vida transaccional.

Webhook de pago de colector​

POST v2/credits/webhooks/collectors/{collector}/payment
Content-Type: application/json
Body (colector → Migo)
{
"transactionId": "txn-abc123",
"amount": 500.00,
"currency": "GTQ",
"status": "paid",
"date": "2026-02-01T10:00:00Z",
"reference": "PAY-001",
"fee": 5.00,
"externalEntityId": "ENT-1",
"externalTransactionId": "EXT-1"
}

Requeridos: transactionId, amount, currency, status, date. Opcionales: reference, fee, externalEntityId, externalTransactionId.

Notificaciones internas​

Migo también maneja notificaciones internas (avisos a canales y a comercios) que no son endpoints HTTP y no forman parte de tu integración: ocurren del lado de Migo. No necesitas implementarlas ni consumirlas; se mencionan solo para que sepas que existen.

Los códigos de error que pueden aparecer en el objeto error de un webhook están en el Catálogo de errores.