Retry e Garantias de Entrega

O GTPayroll implementa retry automático com backoff exponencial para garantir a entrega dos webhooks.

---

Política de retry

Tentativa	Intervalo após falha
1ª	1 minuto
2ª	5 minutos
3ª	30 minutos
4ª	2 horas
5ª	6 horas

Após 5 tentativas sem sucesso, o evento é marcado como cancelado.

---

Critérios de sucesso e falha

Resposta HTTP	Comportamento
2xx	Sucesso — evento marcado como entregue
3xx, 5xx	Falha retentável — retry agendado
4xx	Falha permanente — evento cancelado imediatamente

Respostas 4xx (ex: 400, 401, 403, 404) cancelam o evento imediatamente, sem retry. Certifique-se de que seu endpoint retorna 2xx quando a notificação é recebida com sucesso.

---

Ciclo de vida do evento

QUEUED → [envio] → SUCCESS
                  → FAILURE → [retry 1] → SUCCESS
                                         → FAILURE → [retry 2] → ...
                                                                → CANCELLED (limite atingido)
                  → CANCELLED (4xx)

---

Idempotência

Recomendado: implemente idempotência no seu endpoint. O mesmo evento pode ser enviado mais de uma vez em caso de falha de rede ou timeout. Use o campo sourceId (quando disponível) ou uma combinação de campos do payload para identificar eventos duplicados.