Skip to main content
Os webhooks são a forma recomendada de acompanhar o ciclo de vida de pagamentos e assinaturas sem precisar ficar consultando a API. Sempre que o status de um pagamento muda, a Autorizou envia um POST para a notification_url configurada na cobrança.
Para a referência completa do payload e dos eventos, veja Webhooks › Estrutura do Payload e Webhooks › Eventos.

​
Configurando a URL

Você pode definir a URL de notificação por cobrança, no campo notification_url ao Criar Pedido ou Criar Assinatura.

​
Boas práticas

1

Responda rápido (2xx)

Retorne 200 assim que receber o evento e processe de forma assíncrona. O timeout do remetente é curto.
2

Seja idempotente

O mesmo evento pode chegar mais de uma vez. Use o id do evento/pagamento como chave de deduplicação antes de aplicar efeitos colaterais.
3

Valide a origem

Confirme a assinatura/credencial do webhook antes de confiar no payload.
4

Trate reentregas

Eventos que falham são reenviados. Não trate um reenvio como um novo pagamento.

​
Fluxo típico

​
Conferindo o estado real

Webhooks são notificações, não a fonte da verdade. Em caso de dúvida (ou perda de evento), confirme o estado consultando o pagamento em Consultar Pagamento.