Reintentos

Política de reintentos

Si tu endpoint no responde 2xx (o hay timeout), Rivopay reintentará hasta 3 veces. El timeout por intento es de 10 segundos.

Intento	Delay
1° intento	inmediato
2° intento	+1 segundo
3° intento	+5 segundos

Firma y ventana temporal en reintentos

La firma y el timestamp se calculan una sola vez y se reutilizan: los reintentos llevan idéntico body, X-Webhook-Signature y X-Webhook-Timestamp, el del primer envío. Por eso la validación de ventana temporal (±5 min) no falla en el 3er intento, y el txId sirve como clave de idempotencia para descartar el payload repetido. Ver Verificación de firma.

Buenas prácticas

Responde rápido, procesa después

Responde 200 inmediatamente y procesa la lógica de negocio de forma asíncrona (cola de mensajes, workers, etc.).

• Siempre responde 200 aunque tengas un error interno
• Sé idempotente — el mismo webhook puede llegar más de una vez; usa txId como clave de idempotencia
• Registra los payloads recibidos para auditoría y debugging
• Responde en menos de 10 segundos o el webhook se considerará fallido