Webhooks de Pagamento
Os webhooks são utilizados para receber notificações assíncronas sobre eventos de pagamento, permitindo que sua aplicação reaja a mudanças de status sem precisar consultar constantemente a API.Visão Geral
O FitLocus implementa webhooks para os dois gateways de pagamento suportados:Stripe
Webhooks para processamento de pagamentos com cartão de crédito.
AbacatePay
Webhooks para processamento de pagamentos via PIX.
Configuração de Webhooks
AbacatePay
Para receber notificações do AbacatePay, é necessário configurar um endpoint de webhook no dashboard da AbacatePay e definir o segredo de webhook nas configurações da aplicação.Stripe
Para o Stripe, é necessário configurar o webhook no dashboard do Stripe e definir o segredo de webhook nas configurações da aplicação.Eventos Suportados
AbacatePay
| Evento | Descrição |
|---|---|
PAID | Pagamento PIX confirmado |
PENDING | Pagamento PIX pendente |
EXPIRED | QR Code PIX expirado |
CANCELLED | Pagamento PIX cancelado |
Stripe
| Evento | Descrição |
|---|---|
payment_intent.succeeded | Pagamento com cartão confirmado |
payment_intent.payment_failed | Falha no pagamento com cartão |
customer.subscription.created | Assinatura criada |
customer.subscription.updated | Assinatura atualizada |
customer.subscription.deleted | Assinatura cancelada |
invoice.payment_succeeded | Pagamento de fatura confirmado |
invoice.payment_failed | Falha no pagamento de fatura |
Implementação de Webhook
AbacatePay Webhook
Segurança de Webhooks
Para garantir a segurança dos webhooks:- Validação de Segredo: Sempre valide o segredo do webhook para garantir que a requisição é legítima.
- HTTPS: Utilize HTTPS para todas as comunicações de webhook.
- Idempotência: Implemente idempotência para evitar processamento duplicado de eventos.
- Timeout: Defina um timeout adequado para o processamento de webhooks.
Testes de Webhook
AbacatePay
Para testar webhooks do AbacatePay em ambiente de desenvolvimento:-
Utilize o endpoint de simulação de pagamento:
-
Verifique o status da transação:
Stripe
Para testar webhooks do Stripe em ambiente de desenvolvimento:-
Utilize o Stripe CLI:
-
Use cartões de teste para simular diferentes cenários:
- 4242 4242 4242 4242: Pagamento bem-sucedido
- 4000 0000 0000 0002: Cartão recusado