Webhooks confiables: firma e historial de entregas
Confirma que cada evento vino de ZapZap y mira qué se entregó, con estado e intento.
Crear mi cuentaCómo era antes
Quien recibía el webhook no tenía cómo probar que la llamada venía de ZapZap, y no había dónde ver las entregas ni los fallos.
Cómo funciona ahora
Cada entrega lleva una firma HMAC por número, al estilo de las grandes plataformas de pago, con identificador y hora para que verifiques y evites duplicados. Si tu servidor falla, ZapZap reintenta con intervalos crecientes, y cada reintento se vuelve a firmar con una hora nueva. La pestaña Entregas muestra las últimas entregas, con evento, estado HTTP, tiempo y número de intento.
Qué ganas
- Firma HMAC para probar el origen del evento
- Reintentos automáticos con intervalos crecientes
- Identificadores para tratar eventos repetidos
- Pestaña Entregas con estado, tiempo e intento
Antes
Tu servidor no tenía cómo probar que la llamada era de ZapZap, y no había dónde ver las entregas ni los fallos.
Firma
- Cada número tiene su propio secreto de firma
- Cada llamada lleva la firma, la hora, el identificador de la entrega y el tipo de evento
- En los reintentos, la firma se rehace con una hora nueva
Reintentos
- Si tu servidor falla, ZapZap vuelve a intentar con intervalos crecientes
- Solo al agotar los intentos el webhook cuenta como fallido
Entregas
La pestaña Entregas lista las últimas entregas con evento, estado HTTP, tiempo de respuesta y número de intento.