Documentation Index
Fetch the complete documentation index at: https://docs.fitlocus.com/llms.txt
Use this file to discover all available pages before exploring further.
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