Skip to main content

Regras de Retentativa do Webhook

O que são retentativas de Webhooks?

É comum que, em sistemas distribuídos, ocorram falhas temporárias na entrega de mensagens. Para garantir que as mensagens sejam entregues, a OpenPix realiza retentativas de Webhooks em caso de falha na entrega.

Quais são as regras para que um Webhook seja retentado?

  1. Caso a URL do Webhook retorne um código de erro HTTP acima de 400, a OpenPix retentará o Webhook.
  2. Caso a URL do Webhook não esteja disponível, a OpenPix retentará o Webhook.
  3. Caso ocorra algum erro interno na OpenPix, a OpenPix retentará o Webhook.

Retentativa de Webhooks

São feitas 8 tentativas de chamada do webhook.

A primeira tentativa é feita no momento em que o evento do webhook é disparado, caso ela falhe seguindo as regras acimas, as demais retentativas são feitas em intervalos de tempo exponenciais, de acordo com a seguinte fórmula:

intervalo = 10 * 2 ^ tentativa

Sendo assim, essa é a tabela de retentativas:

TentativaIntervalo (segundos)
110
220
340
480
5160
6320
7640
81280

Caso todas as tentativas falhem, o webhook não será mais retentado.

Porém ainda sim é possível retentar manualmente via plataforma.