A Lovable mudou bastante o fluxo de pagamentos. Hoje, o recurso Payments integrado cria checkout, produtos, preços, ambientes de teste e produção e webhooks gerenciados. A documentação antiga de Stripe com Supabase continua válida apenas para projetos antigos ou casos em que Payments não está disponível.
1. Payments não aparece ou não deixa configurar Stripe
- Confirme se o workspace está em plano Pro ou superior.
- O Payments nativo exige Lovable Cloud; não funciona em projeto conectado ao seu próprio Supabase.
- A configuração inicial exige permissão de admin/owner do projeto ou workspace.
- Em Enterprise, os conectores Stripe/Paddle podem estar desabilitados por padrão e precisam ser liberados em Connectors → Admin settings.
Se seu projeto usa Supabase próprio, não tente forçar o painel Payments nativo. Nesse caso, siga o fluxo de Stripe com Edge Functions e secrets, ou avalie migrar a arquitetura para Cloud sabendo que não existe migração automática de backend em um clique.
2. Checkout funciona no teste, mas não aceita pagamento real
No Payments atual, preview e produção são ambientes separados. O preview usa Test mode e aceita somente cartões de teste. O app publicado usa Live mode, mas pagamentos reais só funcionam depois que o checklist de go-live e a verificação da conta Stripe forem concluídos.
- Abra More → Payments.
- Mude para o ambiente Live.
- Confira o go-live checklist.
- Reivindique/claim a conta Stripe criada durante o setup, se necessário.
- Conclua onboarding e verificação no Stripe Dashboard.
- Publique a versão mais recente do projeto.
- Teste novamente usando um cartão real somente depois que o ambiente estiver aprovado.
3. Compra aprova, mas o plano não libera no app
Esse sintoma normalmente aponta para webhook ou lógica de entitlement. A própria documentação alerta que compras podem continuar sendo aprovadas no Stripe mesmo quando o endpoint do app foi apagado; nesse cenário, a assinatura não ativa e os recursos não são liberados.
- No Stripe Dashboard, confira se os endpoints criados pela Lovable continuam ativos.
- Não apague o endpoint do app nem o endpoint de monitoramento da Lovable.
- Confirme se sandbox e live usam endpoints diferentes.
- Revise Payments → Transactions para ver o status real da cobrança.
- Teste upgrade, downgrade, cancelamento, renovação, falha de pagamento e trial.
4. Stripe funciona no preview, mas quebra publicado
No Payments atual, isso geralmente significa que o ambiente Live ainda não foi concluído. Produtos e preços têm dados separados em test e live, e o checkout real depende da configuração de produção. Revise o painel Payments no ambiente Live e publique novamente depois do go-live.
5. Projeto antigo com Supabase próprio
Para projetos antigos conectados ao próprio Supabase, a documentação de Stripe é hoje marcada como legada. Nesse fluxo, use uma Secret Key ou Restricted Key armazenada com segurança, Edge Functions para checkout e, quando necessário, webhook para atualizar assinatura e acesso.
- Nunca exponha sk_ ou rk_ no frontend.
- Confira Supabase → Edge Functions → Logs.
- Confira Stripe Dashboard → Developers/Logs e Webhooks.
- Valide o webhook secret salvo em Secrets.
- Para assinaturas, vincule o customer/subscription ao usuário autenticado.
- Teste em Stripe Test Mode antes de usar chaves live.
Se você ainda está configurando o fluxo, leia Como configurar pagamentos na Lovable com Stripe. Este artigo é complementar e foca especificamente em diagnóstico e correção.
