Skip to main content

Visão Geral

Existem duas formas de receber notificações via webhook na Autorizou:
  1. Webhook Global: Configurado na Dashboard e recebe todos os eventos selecionados
  2. 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/autorizou
string
required
Descrição para identificar o webhook Útil quando você tem múltiplos webhooks configurados Exemplo: Webhook principal de produção
array
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/json
string
required
Status inicial do webhook Opções: - enabled - Ativo e enviando notificações
  • disabled - Desabilitado manualmente Padrão: enabled
O status suspended é atribuído automaticamente pelo sistema após 3 falhas consecutivas
string
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_abc123def456xyz789

Gerenciando 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
Use o histórico de disparos para debug e monitoramento da integração

Status do Webhook

Um webhook pode ter os seguintes status:
Ativo Webhook está funcionando normalmente e enviando notificações Este é o status padrão ao criar um webhook
Desabilitado Webhook foi desabilitado manualmente Não envia notificações até ser reativado Útil para manutenção temporária
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 Dashboard

Notification URL por Pagamento

Além dos webhooks globais, você pode especificar uma notification_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 campo content_type_header define como o payload será enviado:

application/json (Recomendado)

Processamento:

application/x-www-form-urlencoded

Processamento:

Troubleshooting

Webhook não está recebendo notificações

Na Dashboard, confirme que o status está enabled e não suspended
Confirme que os eventos que você espera estão selecionados na configuração
Verifique se sua URL está acessível: - HTTPS válido (certificado não expirado) - Porta 443 aberta - Firewall permite conexões externas
Acesse o histórico de disparos na Dashboard para ver detalhes dos erros

Webhook foi suspenso

Se seu webhook foi marcado como suspended:
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 enabled

Recebendo 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:
Isso permite:
  • 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