O webhook é o aviso automático que o Asaas manda para o seu sistema quando algo acontece, como um pagamento confirmado. Sem ele, o sistema só fica sabendo do pagamento quando alguém confere manualmente.
Criar o webhook
Passo 1: Abra a área de webhooks
Clique no ícone de usuário, no canto superior direito, depois em Integrações, e abra a aba Webhooks.
Passo 2: Clique em Adicionar Webhook
Um formulário vai se abrir.
Passo 3: Preencha o formulário
Use os valores da tabela abaixo.
Campos do formulário
- Este Webhook ficará ativo?
- Sim
- Nome do Webhook
- Um nome que identifique o sistema (ex.: Sistema de vendas)
- URL do Webhook
- A URL do quadro Dados que você recebeu
- Quem deve ser avisado se o webhook falhar
- Versão da API
- v3
- Token de autenticação
- Clique em Gerar Token e copie o valor
- Fila de sincronização ativada?
- Sim
- Tipo de envio
- Sequencial
Passo 4: Escolha os eventos
Mais abaixo, em Adicionar Eventos, abra o grupo Cobranças e marque: PAYMENT_CREATED (cobrança criada), PAYMENT_CONFIRMED (pagamento confirmado), PAYMENT_RECEIVED (pagamento recebido), PAYMENT_OVERDUE (cobrança vencida), PAYMENT_DELETED (cobrança removida) e PAYMENT_REFUNDED (pagamento estornado).
Passo 5: Salve e avise
Clique em Salvar, no fim do formulário, e avise a equipe que integra o seu sistema, enviando o token de autenticação. Ela faz um pagamento de teste para confirmar que o aviso chegou.
Fontes
- Asaas. Criar novo Webhook pela aplicação web
- Asaas. Eventos de Webhooks