Skip to main content
A Azentech envia um POST com JSON para a URL cadastrada na inscrição.
Os eventos públicos desta versão são:
  • auth, capture, void e expired para entradas.
  • payment, refund e transfer para saídas.
1

Capture o corpo sem alterações

Preserve os bytes recebidos antes de converter o JSON.
2

Valide a assinatura

Compare x-azentech-webhook-signature em tempo constante. Rejeite a requisição quando a assinatura não corresponder.
3

Registre a entrega

Persista a transação, o evento, a data e o corpo recebido antes de executar efeitos dependentes.
4

Aplique o efeito uma vez

Use uma chave idempotente derivada de transaction.id, event e do evento correspondente na lista.
5

Confirme o recebimento

Responda com HTTP 200 a 226 depois da persistência durável.
Uma inscrição, uma URL ou um processador ausente pode impedir a entrega. A existência do evento no código não confirma que a inscrição do seu estabelecimento está ativa. As transações de origem funding, balancing, settlement ou internal podem ter o nome do evento substituído pela origem na entrega atual. Esses nomes reclassificados não fazem parte dos sete webhooks públicos desta versão. Confirme a configuração quando usar aportes, liquidação ou fluxos internos.