Skip to main content

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.
O endpoint para receber webhooks do AbacatePay é:

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:
  1. Validação de Segredo: Sempre valide o segredo do webhook para garantir que a requisição é legítima.
  2. HTTPS: Utilize HTTPS para todas as comunicações de webhook.
  3. Idempotência: Implemente idempotência para evitar processamento duplicado de eventos.
  4. Timeout: Defina um timeout adequado para o processamento de webhooks.

Testes de Webhook

AbacatePay

Para testar webhooks do AbacatePay em ambiente de desenvolvimento:
  1. Utilize o endpoint de simulação de pagamento:
  2. Verifique o status da transação:

Stripe

Para testar webhooks do Stripe em ambiente de desenvolvimento:
  1. Utilize o Stripe CLI:
  2. Use cartões de teste para simular diferentes cenários:
    • 4242 4242 4242 4242: Pagamento bem-sucedido
    • 4000 0000 0000 0002: Cartão recusado

Próximos Passos