Tempo real
Receba o evento no momento que acontece. Libere produto, mande e-mail, atualize o CRM — tudo na hora.
Secret e assinatura HMAC
O secret na URL prova que o evento veio da AbacatePay, e a assinatura HMAC garante que o corpo não foi alterado.
Retry automático
Sua URL caiu? Sem problema. A AbacatePay tenta de novo várias vezes ao longo de horas até confirmar a entrega.
Endpoints
Tudo o que você precisa em poucas chamadas
A API de Webhooks é baseada em intenção: cada rota diz o que faz. Comece em minutos, escale sem dor.
- POST
/webhooks/createCadastra uma URL pra receber eventos - GET
/webhooks/listLista todos os webhooks configurados - GET
/webhooks/getBusca um webhook pelo ID - POST
/webhooks/deleteRemove um webhook
curl -X POST https://api.abacatepay.com/v2/webhooks/create \
-H "Authorization: Bearer SEU_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"name": "Pagamentos",
"endpoint": "https://seusite.com.br/webhooks/abacate",
"secret": "seu-secret",
"events": ["checkout.completed", "subscription.cancelled"]
}'Dúvidas sobre Webhooks?
As respostas mais frequentes sobre como usar a API de Webhooks.
Quais eventos eu posso escutar?
Pagamento confirmado, reembolsado e contestado, falha de cobrança, renovação e cancelamento de assinatura, saques e transferências — entre outros. Veja a lista completa na doc.
Como valido a assinatura HMAC?
Confira o webhookSecret que chega na URL (é ele que prova a origem) e recalcule o HMAC-SHA256 do corpo com a chave pública da AbacatePay, comparando com o header X-Webhook-Signature. A doc tem exemplos em Node.js, Python e Go.
O que acontece se meu servidor cair?
A AbacatePay tenta de novo em 5s, 5min, 30min, 2h, 5h e 10h — até 7 tentativas em cerca de 18 horas —, sempre com o mesmo id do evento, pra você não processar duas vezes.
Posso testar webhooks localmente?
Pode. Use um túnel tipo ngrok ou Cloudflared pra expor seu localhost e configurar como URL de webhook em ambiente sandbox.
Sem mensalidade. Aprovação não leva semanas.
Conecte tudo em tempo real
Crie sua conta e configure seus webhooks em poucos minutos.
Sem mensalidade. Aprovação não leva semanas.
