Webhooks

Webhooks integram eventos de provedores externos ao ciclo de vida do clube. O endpoint público atualmente documentado para o Asaas é:

POST /billing/webhooks/asaas

Esse endpoint não usa o login comum do console. A autenticação é feita pelo mecanismo de webhook configurado para a conexão do provedor. Não publique o token dedicado nem o inclua em URLs compartilhadas.

Para a estrutura exata do payload, eventos aceitos, respostas e comportamento de reprocessamento, consulte a operação correspondente no Swagger UI. A aplicação deve tratar entrega repetida de forma idempotente e registrar falhas para reprocessamento quando o contrato do provedor permitir.