Reintentos del webhook
LX CloudPos reintenta de forma agresiva los envíos fallidos para que no pierdas eventos importantes. Hay dos capas: reintentos in-process (en memoria, inmediatos) y reintentos persistentes (cron, distanciados en el tiempo).
In-process (síncronos)
Justo después del envío original, LX CloudPos hace hasta 3 intentos con backoff lineal:
| Intento | Espera previa |
|---|---|
| 1 | 0 s |
| 2 | 2 s |
| 3 | 8 s |
Persistentes (cron)
Si los 3 intentos in-process fallan, el envío queda en cola persistente. Un cron job lo reintenta cada 5 a 10 minutos hasta llegar a 5 intentos totales (3 in-process + 2 cron).
Cuándo reintentamos
| Tu respuesta | ¿Reintentamos? |
|---|---|
2xx (200, 201, 204) | No (éxito) |
4xx excepto 429 | No (error definitivo del receptor) |
429 | Sí (rate limited) |
5xx | Sí (falla transitoria) |
| Timeout (>10 s) | Sí |
| Conexión rechazada | Sí |
Cuándo paramos
- Tras los 5 intentos totales (3 in-process + 2 cron).
- Si recibimos un
4xxdistinto de429en cualquier intento (error definitivo). - Si el
webhookUrlfalla la validación SSRF (URL prohibida).
💡 Cada envío incluye el campo
intentoen el payload y unnonceúnico por intento. Tu lógica de deduplicación tiene que tolerar la re-entrega del mismo evento.