Configuración y Manejo de Webhooks
Política de reintentos
Si Fint no recibe una respuesta con código 2xx de tu servidor, implementamos una política de reintentos escalonada:
- Intentos iniciales: 5 intentos con intervalos de 5 minutos entre cada uno.
- Intentos adicionales: 2 intentos más, uno cada día, si los intentos iniciales fallan.
Aquí tienes un ejemplo detallado de cómo funciona este proceso:
Intento | Tiempo después del evento original |
---|---|
1 | Inmediatamente |
2 | 5 minutos |
3 | 10 minutos |
4 | 15 minutos |
5 | 20 minutos |
6 | 1 día |
7 | 2 días |
Sistema de Logs y Seguimiento
Cuando se envía un webhook, Fint genera automáticamente un log en nuestro sistema. Este log sirve como registro del envío del webhook y nos permite realizar un seguimiento detallado de cada intento de entrega.
Características del Sistema de Logs
-
Registro de intentos: Cada intento de envío del webhook se registra en el log, incluyendo la hora del intento y el resultado.
-
Estado del log: El log tiene un estado que refleja el estado actual del webhook:
ongoing
: El proceso de entrega está en curso.error
: Todos los intentos de entrega han fallado.success
: El webhook se ha entregado exitosamente.
-
Actualización dinámica: El estado del log se actualiza automáticamente según la política de reintentos y las respuestas del servidor destino.
-
Trazabilidad: Este sistema permite una trazabilidad completa del ciclo de vida de cada webhook, desde su generación hasta su entrega exitosa o fallo final.
Cambios de Estado
API de Webhooks Logs
Para acceder y gestionar los logs de webhooks programáticamente, puedes utilizar nuestra API de Webhooks Logs. Esta API te permite obtener información detallada sobre los intentos de entrega, estados y otros datos relevantes de cada webhook enviado a tu servidor.
Documentación de API de Webhooks Logs
Recomendaciones
Para probar el endpoint desde tu aplicación local, te recomendamos usar ngrok. Esta herramienta proporciona una URL HTTPS que crea un túnel a tu aplicación local, facilitando las pruebas.
Si aún no tienes un servidor para probar los webhooks, te sugerimos utilizar webhook.site. Este sitio web te proporciona un endpoint HTTPS que puedes usar para realizar pruebas de webhooks de manera sencilla.