Visão Geral
Existem duas formas de receber notificações via webhook na Autorizou:- Webhook Global: Configurado na Dashboard e recebe todos os eventos selecionados
- Notification URL: URL específica por pagamento (configurada ao criar o pagamento)
A forma recomendada é configurar Webhooks Globais pela Dashboard, que
oferece gerenciamento completo e histórico de disparos.
Configurando via Dashboard
Passo a Passo
1
Acesse a Dashboard
Faça login na Dashboard Autorizou
2
Navegue até Webhooks
No menu lateral, acesse Integrações → Webhooks
3
Criar Novo Webhook
Clique no botão “Criar Webhook”
4
Preencha o Formulário
Configure os campos obrigatórios (veja detalhes abaixo)
5
Salvar
Clique em “Salvar” para ativar o webhook
Campos de Configuração
string
required
URL do seu endpoint que receberá as notificações.Requisitos (validados no momento do envio): deve ser HTTPS e publicamente acessível. Por
segurança (anti-SSRF), a plataforma não entrega para
http:// nem para endereços privados/internos
— localhost, 127.x, 10.x, 172.16–31.x, 192.168.x, link-local (169.254.x). Ao testar, use um
túnel público (ex.: ngrok), não um endereço local.Exemplo: https://seu-site.com.br/webhooks/autorizoustring
required
Descrição para identificar o webhook Útil quando você tem múltiplos webhooks
configurados Exemplo:
Webhook principal de produçãoarray
required
Eventos que você deseja receber notificações Selecione pelo menos um
evento A Dashboard mostra todos os eventos disponíveis organizados por
categoria Ver todos os eventos disponíveis
string
required
Formato do conteúdo enviado no webhook Opções disponíveis: -
application/json (recomendado) - application/x-www-form-urlencoded Padrão:
application/jsonstring
required
Status inicial do webhook Opções: -
enabled - Ativo e enviando notificaçõesdisabled- Desabilitado manualmente Padrão:enabled
O status
suspended é atribuído automaticamente pelo sistema após 3 falhas
consecutivasstring
Chave secreta opcional para validar requisições Recomendado para adicionar uma
camada extra de segurança Guarde em local seguro - não será exibido
novamente Exemplo:
whsec_abc123def456xyz789Gerenciando Webhooks na Dashboard
Visualizar Webhooks
Na página de webhooks você pode:Ver URL e Status
Visualize a URL configurada e status atual
Ver Eventos
Confira quais eventos estão configurados
Editar Webhook
Atualize URL, eventos ou status
Excluir Webhook
Remova webhooks não utilizados
Histórico de Disparos
Para cada webhook, você pode acessar o histórico completo de disparos:- Data e hora de cada disparo
- Evento que disparou
- Status da entrega (delivered, failed, retrying, pending)
- Código HTTP da resposta
- Número de tentativas
- Payload enviado
- Resposta recebida
Status do Webhook
Um webhook pode ter os seguintes status:enabled
enabled
Ativo Webhook está funcionando normalmente e enviando notificações Este
é o status padrão ao criar um webhook
disabled
disabled
Desabilitado Webhook foi desabilitado manualmente Não envia notificações
até ser reativado Útil para manutenção temporária
suspended
suspended
Suspenso Webhook foi suspenso automaticamente pelo sistema após 3
tentativas de entrega falhadas Para reativar: 1. Corrija o problema no
seu endpoint 2. Atualize o webhook para status
enabled na DashboardNotification URL por Pagamento
Além dos webhooks globais, você pode especificar umanotification_url ao criar um pagamento individual.
Quando Usar
- Quando cada pagamento precisa notificar URLs diferentes
- Para integrações com sistemas externos que fornecem URLs únicas
- Para testes ou ambientes temporários
Exemplo ao Criar Pagamento
Se você tiver webhooks globais configurados E uma
notification_url no
pagamento, ambos receberão as notificações.Content Type Header
O campocontent_type_header define como o payload será enviado:
application/json (Recomendado)
application/x-www-form-urlencoded
Troubleshooting
Webhook não está recebendo notificações
1. Verificar status
1. Verificar status
Na Dashboard, confirme que o status está
enabled e não suspended2. Verificar eventos
2. Verificar eventos
Confirme que os eventos que você espera estão selecionados na configuração
3. Testar URL
3. Testar URL
Verifique se sua URL está acessível: - HTTPS válido (certificado não
expirado) - Porta 443 aberta - Firewall permite conexões externas
4. Consultar histórico
4. Consultar histórico
Acesse o histórico de disparos na Dashboard para ver detalhes dos erros
Webhook foi suspenso
Se seu webhook foi marcado comosuspended:
1
Identifique o problema
Consulte o histórico de disparos para ver os erros Erros comuns: - Timeout
(endpoint demorou mais de 30s) - Erro 500 (problema no seu servidor) -
Conexão recusada (endpoint indisponível)
2
Corrija o problema
Resolva o erro identificado no seu endpoint
3
Reative o webhook
Na Dashboard, edite o webhook e altere o status para
enabledRecebendo duplicatas
É normal receber o mesmo evento mais de uma vez devido ao sistema de retry automático. Solução: Implemente processamento idempotente usando o ID do pagamento para evitar processar o mesmo evento múltiplas vezes.Múltiplos Webhooks
Você pode configurar múltiplos webhooks com diferentes conjuntos de eventos: Exemplo de uso:- Separar responsabilidades
- Enviar para sistemas diferentes
- Facilitar manutenção
Próximos Passos
Ver Eventos
Conheça todos os eventos disponíveis
Estrutura de Payloads
Entenda os dados recebidos