O Webhook (também chamado de callback ou postback) é uma funcionalidade que permite que a sua aplicação receba informações do Asaas em tempo real.
Enquanto ao utilizar a API a sua aplicação se comunica com o Asaas, nos Webhooks o movimento é o contrário: o Asaas notifica a sua aplicação sobre os eventos que ocorrem na sua conta.
Com o Webhook, você realiza a conciliação da situação de cobranças, assinaturas, notas fiscais, transferências e outros recursos diretamente na sua aplicação, sem precisar fazer requisições para checar o status de cada um.
Confira as principais características do Webhook do Asaas:
Formato e envio: Os eventos são enviados em formato JSON por meio de requisições POST.
Modelo de entrega: O envio segue o modelo at least once (um mesmo evento pode ser recebido mais de uma vez). É importante implementar a idempotência na sua aplicação utilizando o campo
iddo evento.Quantidade: É possível configurar até 10 Webhooks por conta, com URLs e conjuntos de eventos diferentes.
Eventos disponíveis: Você pode habilitar eventos de cobranças, assinaturas, notas fiscais, transferências, Pague Contas, antecipações, recarga de celular, situação da conta, checkout, bloqueios de saldo, movimentações internas, chaves de API e Pix Automático (na mesma configuração ou em Webhooks separados).