O que são Webhooks?
Webhooks são notificações HTTP automáticas enviadas pela Autorizou para sua aplicação sempre que um evento importante acontece, como a confirmação de um pagamento, uma recusa ou um estorno. Em vez de você precisar ficar consultando nossa API repetidamente para verificar mudanças de status (polling), nós enviamos as informações diretamente para você em tempo real.Por que usar Webhooks?
Tempo Real
Receba notificações instantâneas sobre eventos importantes
Eficiência
Elimine a necessidade de polling constante da API
Escalabilidade
Processe eventos de forma assíncrona e escalável
Confiabilidade
Sistema de retry automático garante a entrega
Como Funcionam na Autorizou
Fluxo de Notificação
Garantias de Entrega
Sistema de Retry Automático
Se seu servidor não responder ou retornar erro, tentamos reenviar automaticamente:- 3 tentativas automáticas
- Intervalo crescente entre tentativas (backoff exponencial)
- Primeira retry: ~1 minuto após falha
- Segunda retry: ~5 minutos após primeira falha
- Terceira retry: ~10 minutos após segunda falha
Requisitos Técnicos
Para receber webhooks, seu endpoint deve:Aceitar requisições POST com JSON
Aceitar requisições POST com JSON
O webhook será enviado como POST com
Content-Type: application/jsonResponder HTTP 200 para sucesso
Responder HTTP 200 para sucesso
Qualquer status 2xx é considerado sucesso. Outros códigos acionam retry.
Responder em até 30 segundos
Responder em até 30 segundos
Se ultrapassar 30 segundos, consideramos timeout e tentamos reenviar.
Usar HTTPS em produção
Usar HTTPS em produção
URLs HTTP só são permitidas em ambiente de testes (sandbox).
Processar de forma idempotente
Processar de forma idempotente
O mesmo evento pode ser enviado mais de uma vez. Use o ID do evento para evitar duplicatas.
Próximos Passos
Configurar Webhooks
Aprenda a configurar webhooks via Dashboard
Eventos Disponíveis
Veja todos os eventos que você pode receber
Estrutura dos Payloads
Entenda a estrutura dos dados recebidos