Você criou um SaaS no Lovable, montou o dashboard, configurou o login e talvez até tenha conseguido seus primeiros usuários. Agora falta transformar o projeto em um negócio: cobrar pelo acesso.
Integrar pagamentos no Lovable parece simples. Basta pedir para a IA criar um botão de assinatura, certo? O problema é que receber o primeiro pagamento é só uma parte da monetização. Seu aplicativo também precisa saber quem pagou, qual plano comprou, quando o acesso vence e o que fazer quando uma cobrança falha.
Neste guia, você vai aprender como adicionar pagamentos ao seu SaaS criado no Lovable, escolher uma infraestrutura de cobrança e pedir para a IA implementar a integração sem expor credenciais ou liberar acesso indevidamente.
Quais são as opções de pagamento no Lovable?
O Lovable permite construir aplicações com backend, banco de dados e integrações externas. Para monetizar seu produto, existem três caminhos principais:
- Pagamentos nativos do Lovable: uma opção para quem busca uma configuração de cobrança integrada à própria ferramenta, conforme os provedores e requisitos disponíveis para o projeto.
- Integração direta com um gateway: use sua própria conta em um provedor, como a Stripe, e implemente a cobrança com os recursos disponibilizados por ele.
- Integração com uma plataforma externa de pagamentos: use uma camada especializada para organizar checkout, assinaturas e gateways, enquanto o Lovable cuida da aplicação.
Os dois primeiros caminhos são válidos, especialmente para um MVP que precisa começar a cobrar rapidamente. Já o terceiro faz sentido quando você quer controlar a experiência de compra, trabalhar com diferentes provedores ou manter a operação de pagamentos independente da ferramenta usada para criar o SaaS.
Se ainda não escolheu o provedor, veja o comparativo de gateways de pagamento para SaaS.
Receber um pagamento não é o mesmo que controlar uma assinatura
Imagine que você criou um sistema de gestão para pequenas empresas e oferece um plano Pro de R$ 79 por mês.
Seu checkout pode estar funcionando perfeitamente, mas algumas situações precisam ser tratadas dentro do produto:
- Uma empresa assinou o plano Pro. Como liberar os recursos pagos?
- O cliente renovou a assinatura. Como atualizar a validade do acesso?
- O pagamento foi recusado. O acesso é suspenso imediatamente ou existe um período de tolerância?
- O cliente cancelou. Ele pode continuar usando o sistema até o fim do mês que já pagou?
- O comprador fechou a página de pagamento antes de retornar ao seu aplicativo. Como confirmar a compra?
Por isso, além da página de pagamento, você precisa de uma integração entre a cobrança e o controle de acesso do seu SaaS. Essa integração normalmente usa uma API e webhooks.
Se você está definindo a cobrança mensal ou anual do produto, o guia de pagamentos recorrentes em SaaS explica o ciclo completo de uma assinatura.
Como funciona a arquitetura de pagamentos
Uma integração com uma plataforma externa pode ser dividida em quatro partes:
| Componente | Responsabilidade |
|---|---|
| Aplicativo criado no Lovable | Login, tela de planos, funcionalidades e experiência do usuário. |
| Backend do aplicativo | Criação das sessões de pagamento, recebimento de webhooks e autorização de acesso. |
| Plataforma de pagamentos | Checkout, catálogo de preços, gerenciamento de cobranças e assinaturas. |
| Gateway | Processamento do pagamento e recebimento dos valores de acordo com o contrato do vendedor. |
Na prática, o fluxo de uma assinatura fica assim:
- O usuário entra no aplicativo e escolhe um plano.
- O backend identifica o usuário autenticado e solicita uma sessão de checkout.
- O usuário é direcionado para a página de pagamento.
- O gateway processa a cobrança.
- A plataforma envia um webhook ao backend informando o resultado.
- O backend atualiza a assinatura do usuário e permite o acesso aos recursos contratados.
Essa separação permite alterar a página de pagamento e, conforme a compatibilidade, o gateway, sem precisar reconstruir a interface do seu SaaS.
Passo a passo: como integrar pagamentos no Lovable com o Astro
O Astro é uma plataforma de checkout, assinaturas e orquestração de pagamentos. Você conecta sua própria conta em um gateway compatível e utiliza a API do Astro para integrar a cobrança ao produto.
Neste exemplo, vamos usar um checkout hospedado e um backend no Lovable Cloud ou em um projeto Supabase conectado ao Lovable.
1. Defina os planos do seu SaaS
Antes de pedir a integração à IA, defina o que será vendido. Para começar, dois planos já podem ser suficientes:
| Plano | Preço mensal | Recursos |
|---|---|---|
| Starter | R$ 39 | Recursos essenciais do aplicativo |
| Pro | R$ 79 | Recursos avançados e limites maiores |
Esses valores são apenas um exemplo. O preço real depende do público, do valor que seu produto entrega e dos custos da operação.
Cadastre os produtos e preços no Astro. Mantenha no seu aplicativo uma associação entre os planos internos e os identificadores dos preços cadastrados. Assim, o backend sabe qual preço utilizar quando o cliente clica em Assinar.
2. Conecte o gateway de pagamento
Escolha o provedor de acordo com os métodos de pagamento que você pretende oferecer. O Astro documenta integrações com Stripe, Mercado Pago, Asaas, PayPal e AbacatePay, mas os métodos e recursos disponíveis variam entre eles.
Para um SaaS de assinatura mensal, confirme se a integração escolhida permite a renovação automática. Se o objetivo é vender um acesso único ou créditos pré-pagos, Pix também pode ser uma boa alternativa.
Comece pelo ambiente de testes, quando disponível, e siga as instruções da documentação de gateways para configurar as credenciais e notificações do provedor.
3. Monte e publique o checkout
Crie uma página de pagamento vinculada ao seu produto. Use o nome, a identidade visual e os benefícios do plano para que o cliente reconheça a marca do aplicativo que acabou de visitar.
Deixe claros o valor, a frequência da cobrança e as condições de cancelamento. Configure os métodos aceitos e publique o checkout.
Anote o slug do checkout (o identificador presente no endereço) e o ID do preço que será vendido. Esses dados serão utilizados na integração.
O processo de criação da página está detalhado em como criar um checkout personalizado sem programar.
4. Prepare o backend e os segredos
Uma aplicação que cobra por assinatura precisa de autenticação e de um backend capaz de executar operações protegidas. No Lovable, você pode usar o backend integrado ou um projeto Supabase compatível.
No Astro, acesse Desenvolvedores e crie uma chave de API com apenas os escopos necessários. Para o fluxo de criação de checkout e consulta do estado das cobranças, confira os escopos na documentação da API. Se implementar cancelamento, conceda também a permissão correspondente.
Armazene a chave de API e, após criar o endpoint de webhook, o segredo de assinatura no gerenciador de segredos do backend:
ASTRO_API_KEY: credencial para as chamadas autenticadas.ASTRO_WEBHOOK_SECRET: segredo para verificar a autenticidade das notificações.
O slug e os identificadores de preços podem ficar em uma configuração mantida pelo servidor. Nunca cole as credenciais em uma mensagem no chat da IA, em componentes React ou em variáveis públicas do frontend, como as que começam com VITE_.
5. Peça para o Lovable implementar a integração
Com o checkout publicado e a documentação em mãos, você pode usar a IA para construir a integração. O importante é informar o comportamento esperado, não apenas pedir para adicionar um botão de pagamento.
Use o prompt abaixo como ponto de partida. Substitua os valores entre colchetes pelos identificadores do seu projeto, sem incluir nenhuma chave secreta.
Integre meu SaaS ao Astro Engine usando checkout hospedado.
Antes de alterar o código, leia a documentação:
https://astroengine.com.br/docs/llms-full.txt
https://astroengine.com.br/docs/openapi.json
Analise o sistema de autenticação e o banco de dados existentes.
Preserve a estrutura e a identidade visual da aplicação.
Configuração:
- Checkout: [SLUG_DO_CHECKOUT]
- Preço: [ID_DO_PRECO]
- Backend: use o Lovable Cloud ou Supabase já configurado.
- Segredos: ASTRO_API_KEY e ASTRO_WEBHOOK_SECRET.
Implemente:
1. Uma tela de planos e um botão Assinar para usuários autenticados.
2. Uma função de backend que valide o usuário e o plano escolhido,
crie uma sessão de checkout pela API do Astro e devolva a URL.
Use o ID do usuário autenticado como externalReference.
Não aceite preço, valor ou identidade do usuário sem validação.
3. Redirecione o usuário ao checkout hospedado. Ao retornar, mostre
o estado da assinatura consultado no backend; não libere acesso
apenas porque o usuário voltou à página de sucesso.
4. Crie um endpoint de webhook que valide a assinatura HMAC-SHA256
usando o corpo bruto e os headers documentados pelo Astro.
5. Registre o identificador exclusivo dos eventos e processe cada
evento de forma idempotente. Proteja contra entregas fora de ordem.
6. Atualize a assinatura local com os eventos de ativação, renovação,
atraso, cancelamento e outros eventos aplicáveis ao plano.
7. Valide as permissões também no backend e no banco de dados.
O frontend não pode alterar o próprio plano nem o status da cobrança.
8. Mostre o plano atual e permita solicitar o cancelamento pelo backend,
respeitando o período já pago e as regras do provedor.
9. Crie testes de sucesso, falha, duplicidade e acesso não autorizado.
Não exponha credenciais no frontend ou nos logs.
Não invente endpoints, eventos ou campos da API.
Se faltar informação, indique o que precisa ser confirmado.
O Astro mantém uma página de prompts para IA com orientações específicas para Lovable e outras ferramentas de desenvolvimento. Se a IA não conseguir ler os endereços, baixe os arquivos de documentação e anexe-os ao projeto.
6. Configure os webhooks
Um webhook é uma notificação enviada de um sistema para outro quando determinado evento acontece. No Astro, você cadastra a URL HTTPS do backend que receberá os eventos e configura quais notificações deseja acompanhar.
Para assinaturas, alguns dos eventos mais importantes são:
| Evento | Uso no aplicativo |
|---|---|
subscription.activated |
Ativar o acesso conforme o plano contratado. |
subscription.renewed |
Atualizar a validade da assinatura. |
subscription.past_due |
Sinalizar atraso e aplicar a política de tolerância. |
subscription.paused |
Ajustar o acesso conforme a política de pausa. |
subscription.resumed |
Reavaliar e restabelecer o acesso, quando devido. |
subscription.canceled |
Atualizar o estado considerando a vigência já paga. |
payment.disputed |
Sinalizar a disputa e aplicar a política de risco. |
A interpretação deve considerar os dados do evento, o estado atual e as regras do seu produto. Por exemplo, cancelar uma renovação futura não significa necessariamente retirar um período que o cliente já pagou.
Valide a assinatura de cada requisição e trate notificações repetidas sem duplicar seus efeitos. A documentação de webhooks descreve os headers, eventos e mecanismo de reenvio.
Como controlar os recursos pagos do seu SaaS
A tabela de assinaturas do seu banco pode armazenar informações como:
- ID do usuário ou da organização que contratou o plano;
- Identificador da assinatura no Astro;
- Plano contratado e estado da assinatura;
- Data de encerramento do período vigente;
- Data da última atualização confirmada.
Esses dados permitem decidir quem pode acessar cada funcionalidade. Em um sistema que oferece contas para equipes, normalmente a assinatura pertence à organização, e não a cada membro individualmente.
Esconder um botão no frontend não é suficiente para restringir uma funcionalidade. Se o plano Pro permite exportar relatórios, a operação que gera o relatório também deve conferir se o usuário possui autorização. Em um projeto Supabase, revise as políticas de acesso às tabelas (RLS) para impedir que uma pessoa modifique a própria assinatura ou consulte informações de outra empresa.
Dá para receber Pix em um SaaS criado no Lovable?
Sim. O Lovable pode integrar serviços de pagamento que disponibilizam Pix por API. Com o Astro, a disponibilidade depende do gateway conectado e dos recursos suportados pela integração.
É importante distinguir duas situações:
- Pix avulso: o cliente recebe um QR Code ou código copia e cola e confirma cada pagamento. Funciona para vendas únicas, créditos e renovações pagas manualmente.
- Pix Automático: o comprador autoriza uma cobrança recorrente, e os débitos seguintes seguem as regras da autorização. Depende do suporte do provedor e da integração usada.
Não presuma que oferecer Pix no checkout significa oferecer renovação automática via Pix. Para um SaaS mensal, confirme o método de cobrança recorrente antes de anunciar a funcionalidade.
Checklist antes de publicar seu SaaS pago
- O cliente consegue escolher e contratar o plano em um dispositivo móvel.
- A criação da sessão de checkout exige autenticação e valida o plano no servidor.
- As credenciais estão protegidas no backend.
- O webhook rejeita notificações com assinatura inválida.
- Uma notificação repetida não duplica a liberação de acesso.
- Uma compra confirmada libera o plano mesmo se o cliente fechar a aba do checkout.
- A renovação, a recusa e o cancelamento foram testados.
- O backend impede usuários sem assinatura válida de executar operações pagas.
- O ambiente de produção usa as credenciais e configurações corretas.
- Os clientes conhecem o preço, as condições de renovação e a forma de cancelar.
Perguntas frequentes
Preciso saber programar para integrar pagamentos no Lovable?
Não é necessário escrever toda a integração manualmente. A IA pode gerar a interface, as funções de backend e as rotinas de assinatura. Ainda assim, revisar o funcionamento e testar a segurança são etapas indispensáveis antes de receber pagamentos reais.
Preciso usar Stripe no Lovable?
Não. A Stripe é uma das opções oferecidas pelo Lovable, mas você também pode conectar APIs externas para montar outras arquiteturas de pagamento. A escolha depende dos meios de pagamento, do público e dos requisitos do seu produto.
Posso usar mais de um gateway no mesmo SaaS?
Sim, desde que a integração permita. Uma plataforma de orquestração de pagamentos pode centralizar os provedores e definir regras de roteamento conforme os métodos suportados. Nem todos os tipos de cobrança podem ser transferidos automaticamente entre gateways.
O Astro cobra uma comissão sobre cada venda?
O modelo do Astro não inclui comissão própria sobre as transações. As taxas do gateway continuam existindo, assim como eventuais custos do plano da plataforma e outros serviços contratados. O dinheiro processado pelo gateway segue as regras de liquidação da sua própria conta.
Resumo
Para adicionar pagamentos ao seu SaaS criado no Lovable, você precisa de uma oferta, um checkout, uma forma de processar a cobrança e uma integração confiável entre pagamentos e acesso ao produto. A IA pode acelerar boa parte desse trabalho, desde que receba instruções claras e documentação atualizada.
Comece com poucos planos e um fluxo de pagamento bem testado. Depois, evolua os meios de pagamento, a experiência do checkout e as regras comerciais à medida que surgirem clientes e necessidades reais.
Com o Astro, você pode organizar essa infraestrutura fora do código principal do seu SaaS, conectar sua própria conta de pagamento e administrar as assinaturas sem pagar uma comissão adicional ao Astro sobre cada venda.
Para começar, consulte a documentação do Astro e os prompts de integração com IA.