Como configurar o Stripe do FarejaLeads: chaves, webhook e Pix
Atualizado em · feito pelo dono da plataforma (admin)
O Stripe da plataforma cobra planos, créditos e adicionais. O webhook é o que libera o que foi pago; sem os eventos certos, o cliente paga e nada acontece.
O que você ganha
- Checkout de planos, créditos e adicionais (quando PAGAMENTOS_LIGADOS estiver ligado)
- Pix no checkout
Antes de começar
- Conta Stripe da empresa ativada.
Passo a passo
1. Chaves
dashboard.stripe.com/apikeys: a Secret key (sk_live_…) vai em STRIPE_SECRET_KEY, só na variável de ambiente. A Publishable key (pk_live_…) vai no admin em STRIPE_PUBLISHABLE_KEY (não é segredo).
No Lovable, abra o projeto do FarejaLeads → Cloud → Secrets → Add secret, com o nome exato e o valor.
Clique em Publish: o site no ar só lê o segredo novo depois de publicado.
2. Webhook
dashboard.stripe.com/webhooks → Adicionar destino (endpoint) → https://farejaleads.com/api/public/stripe-webhook.
Eventos: checkout.session.completed, checkout.session.async_payment_succeeded, customer.subscription.created, customer.subscription.updated, customer.subscription.deleted, invoice.paid e invoice.payment_failed.
Copie o Segredo da assinatura (whsec_…) para STRIPE_WEBHOOK_SECRET (variável de ambiente) e ligue STRIPE_WEBHOOK_EVENTOS_OK no admin (grupo Stripe), que é o lembrete de que os eventos estão marcados.
O nome deste menu pode ter mudado na plataforma. Viu outro? Conte abaixo: o guia se corrige com o seu relato.
3. Pix
dashboard.stripe.com/settings/payment_methods → Pix → Ativar. Depois, no admin (grupo Pix), clique em Testar: abre um checkout de R$ 1 só com Pix. Passou? Ligue PIX_ATIVO.
O nome deste menu pode ter mudado na plataforma. Viu outro? Conte abaixo: o guia se corrige com o seu relato.
Regras que valem sempre
- Pix Automático não existe para conta domiciliada no Brasil: não ligue PIX_AUTOMATICO_ATIVO.
- Com PAGAMENTOS_LIGADOS desligado, nada é cobrado mesmo com o Stripe configurado.