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
| Evento | Método | Path | Emisor |
|---|---|---|---|
| Respuesta de afiliación | POST | /webhooks/merchants/{merchant}/users/{user}/banks/{bank}/affiliations | Banco |
| Actualización de cuenta | POST | /webhooks/banks/{bank}/accounts/updates | Banco |
| Pago de colector | POST | /webhooks/collectors/{collector}/payment | Colector externo |
| Autorización unbanked | POST | /webhooks/unbanked/credits/authorize | MO (procesador) |
| Cancelación automática | POST | /webhooks/transactions/cancellation | Migo (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
{
"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.