Receba eventos em tempo real no seu sistema
Configure URLs para receber notificações de pagamento, falha de cobrança e mais. Tudo assinado com HMAC pra garantir autenticidade.
Tempo real
Receba o evento no momento que acontece. Libere produto, mande e-mail, atualize o CRM — tudo na hora.
Assinatura HMAC
Toda chamada vem assinada. Valida no seu servidor pra garantir que veio mesmo da AbacatePay.
Retry automático
Sua URL caiu? Sem problema. A AbacatePay tenta de novo com backoff exponencial até confirmar entrega.
Tudo o que você precisa em poucas chamadas
A API de Webhooks é REST, simples e bem documentada. 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/v1/webhooks/create \
-H "Authorization: Bearer SEU_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"url": "https://seusite.com.br/webhooks/abacate",
"events": ["billing.paid", "subscription.canceled"]
}'Dúvidas sobre Webhooks?
As respostas mais frequentes sobre como usar a API de Webhooks.
Quais eventos eu posso escutar?
Pagamento aprovado, falhado, estornado, expiração de checkout — entre outros. Veja a lista completa na doc.
Como valido a assinatura HMAC?
Cada webhook vem com um header de assinatura. Você recalcula o HMAC com seu secret e compara — se bater, é legítimo. A doc tem exemplos em várias linguagens.
O que acontece se meu servidor cair?
A AbacatePay retenta com backoff exponencial por até 24h. Você nunca perde um evento de pagamento.
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.
Conecte tudo em tempo real
Crie sua conta e configure seus webhooks em poucos minutos.