Integração Stripe

Processe pagamentos online de forma segura com o Stripe.

Configuração Inicial

1. Crie uma conta no Stripe
2. Obtenha as chaves de API (test e live)
3. Configure as variáveis:
   • STRIPE_SECRET_KEY — chave secreta
   • STRIPE_WEBHOOK_SECRET — secret do endpoint de webhook
4. Crie um webhook no Stripe apontando para: https://seu-domínio.com/api/webhooks/stripe
5. Selecione os eventos: checkout.session.completed, payment_intent.succeeded, charge.refunded

Modos de Pagamento

Automático (Stripe)

• Checkout integrado com o Stripe
• Processamento automático de cartão, PIX e boleto
• Estado atualizado em tempo real via webhook
• Suporte a assinaturas e cobrança recorrente

Manual (Offline)

• Pagamentos em dinheiro, transferência ou PIX externo
• Registo manual no sistema
• Sem processamento automático
• Ideal para clínicas que preferem controlo manual

Cada plano de pagamento define o modo a ser utilizado.

Conciliação

O módulo financeiro permite conciliar:

• Comparar registos manuais com transações Stripe
• Identificar pagamentos sem registo ou duplicados
• Relatório de discrepâncias

Webhooks

O endpoint /api/webhooks/stripe processa:

• Confirmação de pagamento bem-sucedido
• Falha na cobrança
• Reembolsos (totais e parciais)
• Atualização de estado de assinatura