Webhooks

Retentativas

Se o seu endpoint não responder 2xx, a entrega é repetida automaticamente com intervalos crescentes, em até 6 tentativas no total.
TentativaQuandoTempo acumulado
1ªImediatamente após o evento0
2ª1 minuto após a falha anterior~1 min
3ª5 minutos depois~6 min
4ª30 minutos depois~36 min
5ª2 horas depois~2h36
6ª (última)6 horas depois~8h36

O que conta como falha

  • Qualquer status HTTP fora da faixa 2xx (inclusive redirecionamentos 3xx).
  • Sem resposta em 10 segundos (timeout).
  • Erros de DNS, TLS ou conexão, e URLs que apontam para endereços privados.

Após a 6ª tentativa sem sucesso, a entrega é marcada como falha definitiva. Nesse caso, recupere o estado das transações com Listar transações.

Dica

Todas as retentativas de uma entrega usam o mesmo X-ReloadBank-Delivery e o mesmo corpo, mas um novo t e uma nova assinatura. Guarde os IDs de entrega já processados para ignorar duplicatas.