Consideraciones clave
Cuando ocurre un evento, Fintoc envía una solicitudPOST con un body JSON a cada webhook endpoint registrado. Analiza el body JSON para acceder al detalle del evento.
Tu webhook endpoint debe procesar la solicitud POST y devolver un código de estado dentro del rango 2xx.
Guarda el evento recibido
Cada evento de webhook enviado por Fintoc tiene unid único. Guarda el id de cada evento en la base de datos de tu aplicación. Usa el id guardado para detectar entregas duplicadas y procesar cada evento una sola vez.
Devuelve un código de estado 2xx antes del timeout
Para confirmar la recepción de un evento, responde con un código de estado HTTP 2xx. Fintoc trata cualquier otro código de estado como un intento fallido.
Responde con un código de estado 2xx antes de que expire el timeout de entrega de Fintoc. Ejecuta de forma asíncrona la lógica que no necesita completarse antes de la confirmación, para que el handler responda antes del timeout.
Maneja los reintentos y las entregas fallidas
Fintoc trata una entrega como un intento fallido si tu endpoint responde con cualquier código de estado fuera del rango2xx o si la solicitud excede el timeout.
Cuando una entrega falla, Fintoc la reintenta automáticamente. La cantidad de intentos de entrega depende del modo del webhook endpoint:
- Modo
test: hasta 3 intentos de entrega en 3 horas. Fintoc reintenta 3 segundos después del primer intento fallido y una última vez 3 horas después. - Modo
live: hasta 17 intentos de entrega en cerca de 3 días. Fintoc usa backoff exponencial, comenzando 3 segundos después del primer intento fallido.
- Fintoc no deshabilita el webhook endpoint automáticamente ni te notifica cuando deja de reintentar un evento.
- Fintoc no ofrece reenvío manual ni un mecanismo de dead-letter para reenviar un evento fallido.