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
Stripe
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