Módulo Gateways
Integrações de pagamento: Stripe, Mercado Pago, webhooks e processamento de assinaturas PRO.
Propósito
O módulo Gateways abstrai as integrações com provedores de pagamento (Stripe, Mercado Pago) para processar assinaturas do plano PRO. Gerencia webhooks para confirmação de pagamentos, renovação e cancelamento, além do fluxo de checkout.
Principais Recursos
- Suporte a múltiplos gateways (Stripe, Mercado Pago)
- Webhooks públicos (excluídos de CSRF) para receber eventos dos provedores
- Checkout autenticado para upgrade PRO
- Criptografia de api_key, secret_key e webhook_secret no banco
- Modos sandbox e live por gateway
- Registro de assinaturas e logs de pagamento
Modelos / Entidades
| Model | Descrição |
|---|---|
| Gateway | Configuração do gateway (name, slug, api_key, secret_key, webhook_secret, mode, is_active). Chaves criptografadas via Attribute. |
| Subscription | Assinaturas ativas vinculadas ao usuário e gateway |
| PaymentLog | Registro de transações de pagamento |
Rotas
| Rota | Método | Descrição |
|---|---|---|
/webhooks/stripe | POST | Webhook do Stripe (excluído de CSRF) |
/webhooks/mercadopago | GET/POST | Webhook do Mercado Pago (excluído de CSRF) |
/checkout/{gateway} | GET | Inicia checkout (requer auth) |
As rotas de webhook devem ser configuradas no painel do Stripe e Mercado Pago apontando para a URL pública do seu domínio (ex: https://vertexcontas.com.br/webhooks/stripe).
Integrações
- PanelAdmin — GatewayConfigController: CRUD e toggle de gateways em Admin → Gateways
- PanelUser — SubscriptionController: exibe assinatura e fluxo de upgrade
- Core — SubscriptionLimitService verifica plano PRO para habilitar recursos
Configurações
Configure os gateways em Admin → Gateways. Insira api_key, secret_key e webhook_secret para cada provedor. Habilite/desabilite com o toggle. Os dados sensíveis são criptografados no banco. Para webhooks, use a URL completa do seu domínio nas configurações do Stripe e Mercado Pago.