Webhooks
Descripción
Esta sección centraliza todo lo que necesitas para configurar y probar el flujo completo de webhooks en la plataforma de Pagos-como-Servicio (PaaS) de Passport. Desde la creación de la suscripción hasta la validación end-to-end (E2E) de pagos salientes y entrantes.
Configuración de Webhook en el Tablero de Control
Antes de recibir notificaciones, debes registrar tu Webhook en el Tablero de Control de Passport. A continuación detallo cada campo de la pantalla de “Crear Webhook”:
El administrador de la Fintech debe:
- Ingresar al Tablero de Control de Passport.
- Acceder a Plataforma > Webhooks
- Seleccionar Crear Webhook +
- Configurar el Webhook
- Hacer click en Guardar
Crear Webhook
Configuración de Webhooks
Detalles de los Parámetros de Configuración
| Campos | Descripción |
|---|---|
| URL Callback | Dirección HTTPS a la que Passport enviará las notificaciones. Debe ser accesible públicamente. |
| Token de Segredo | Clave que usarás para calcular/verificar la firma HMAC-SHA256. ¡Guárdala en secreto! |
| Modo de Entrega | Mecanismo de retry que quieras usar (“Una Vez" o “Reintentar”). |
| Webhook Activado | Selector SI/NO para habilitar o deshabilitar las notificaciones. |
| Eventos | Tipo de Eventos: Confirmado, Entrante, Liquidado, Rechazado. |
Comportamiento de 'Reintento' en los Webhooks
Cuando el Modo de Entrega está configurado como 'Reintentar' tras un fallo del webhook, la plataforma intentará reenviarlos hasta 12 veces. El primer intento se realiza 1 segundo después del evento de fallo, es decir:
- 1_2*_0 = 1s para el primer reintento.
- 1_2*_1 = 2s para el segundo.
- 1_2*_2 = 4s para el tercero.
- 1_2*_3 = 8s para el cuarto.
Selección de Eventos
Bajo el título Eventos elige la categoría Pagos y marca uno o varios (el nombre del evento en la notificación está en paréntesis):
Recomendamos activar todos los eventos para usar correctamente los escenarios de pagos entrantes y salientes.
Confirmado (payment.confirmed)
- El pago entrante o saliente fue confirmado por el Banco Originador o Receptor.
Iniciado (payment.inbound)
- El pago se envió exitosamente a la red Bre-B.
Liquidado (payment.settled)
- El pago se completó en el banco receptor.
Rechazado (payment.rejected)
- El pago fue rechazado, revisa el cuerpo de respuesta para más detalles.