Ao ativar um webhook no Asaas, o sistema envia uma requisição POST para o endereço configurado sempre que houver alterações nos recursos integrados. Essa requisição contém o evento e o recurso envolvido.
Para que o Asaas considere a notificação enviada como processada com sucesso, a sua aplicação deve retornar o status HTTP 200.
Como identificar a origem de um erro no Webhook:
Se a chamada inicial foi concluída, mas o erro é exibido nos logs de webhook, significa que o problema ocorreu na sua própria aplicação e precisa de ajuste do seu lado.
Para visualizar os registros:
Acesse o menu Integrações.
Clique em Logs de Webhooks.
Funcionamento da fila de retentativas:
Se a sua aplicação responder com erros (como o status 429), o Asaas realizará novas tentativas de envio do evento.
A fila de envios só é interrompida automaticamente após 15 falhas consecutivas de retorno da sua aplicação.
Para restabelecer o envio automático, corrija a indisponibilidade ou falha na sua aplicação e reative a fila para que volte a responder com o status 200.