
Como cobrar assinatura num app feito com IA e liberar acesso só para quem pagou
Assinatura num app que o Claude Code ou o Cursor escreveu: a sua conta Stripe, planos com funcionalidades, o webhook que avisa o pagamento e a verificação que libera só o que o plano inclui.
Nesta página · 8 seções
O app que a IA ajudou você a construir já tem usuários, e agora a pergunta é como cobrar. O agente costuma propor integrar a Stripe direto: criar produtos, montar o checkout, escrever o endpoint de webhook, guardar o estado da assinatura no banco e checar esse estado em cada tela. Funciona, mas são muitos pedaços que precisam concordar entre si. E o erro clássico de um app feito às pressas é esconder o botão pago no frontend e deixar a rota do servidor aberta.
As peças, em uma frase
Um projeto guarda gateways; cada gateway guarda planos; um cliente assina um plano e ganha as funcionalidades vinculadas a ele. O app nunca pergunta "qual é o plano deste usuário?". Ele pergunta "este usuário tem a funcionalidade relatorios-avancados?". Assim, mudar o que cada plano inclui não exige mexer no código.
A cobrança recorrente acontece na sua conta Stripe: o dinheiro cai lá, e as faturas e recibos também ficam lá. O Payments organiza os planos, acompanha as assinaturas pelos eventos da Stripe e responde ao app quem pode o quê.
Passo a passo com o agente
1. Documentação para o agente
Cole na conversa o endereço https://myinfrastructure.click/products/payments/llms.txt. É a referência inteira, com uma seção do que não existe, para o agente não inventar rotas. Se você ainda não tem conta, o agente cria conta e projeto sozinho; o único passo humano é ler o código que chega no seu e-mail.
2. Conectar a Stripe e criar os planos
No painel do Payments, você adiciona a chave da sua Stripe como gateway. Criar um plano no Payments também o cria na Stripe, com nome, preço, moeda e ciclo mensal ou anual. Depois, em Funcionalidades, você cria os nomes que o app vai consultar e vincula cada um aos planos certos.
Um cuidado: a chave de teste da Stripe (sk_test_…) conecta, responde a tudo com sucesso e não cobra ninguém. Antes de publicar, o botão Testar conexão diz em que ambiente o gateway está.
3. O webhook, que não pode faltar
Sem o webhook, a Stripe cobra e ninguém fica sabendo: a assinatura não aparece no painel, e o app continua tratando a pessoa como se não tivesse pago. No gateway, há a opção Configurar automaticamente, que cadastra o endereço na Stripe; o Testar conexão confirma se o segredo do webhook está lá.
Os eventos que importam chegam por esse caminho: checkout concluído, fatura paga, pagamento recusado, assinatura alterada e assinatura cancelada.
4. O que o agente escreve no app
Num app React, o agente instala @ciromaciel/payments-react e envolve o app com PaymentsProvider, passando a chave pública do projeto, o userId do seu próprio banco e o e-mail do cliente. O userId é a chave do vínculo; ele precisa ser estável.
Depois:
<Pricing>mostra os planos. Quem não assina vai ao checkout da Stripe; quem já assina troca de plano pelo portal, sem um segundo checkout.<FeatureControl featureId="...">mostra o conteúdo só para quem tem a funcionalidade, com umfallbackpara os outros.<PortalButton>leva ao portal da Stripe, onde a pessoa troca o cartão, vê as faturas e cancela.
5. A checagem que de fato protege
Tudo o que acontece no navegador pode ser alterado por quem está no navegador. FeatureControl e useHasFeature servem para a interface: esconder, mostrar, convidar para o upgrade. O recurso pago em si, como a exportação, o relatório ou a chamada cara, precisa ser recusado no servidor. Antes de entregar, o backend consulta as permissões do usuário pela rota /sdk/v1/permissions, que devolve se há assinatura ativa e quais funcionalidades estão liberadas.
É essa linha no servidor que separa um paywall de verdade de um botão escondido.
O que acontece quando o plano muda
Upgrade vale na hora, e a Stripe cobra só a diferença proporcional.
Downgrade, ou a troca do anual para o mensal, vale no fim do período já pago.
O plano novo chega pelo webhook, e as permissões do usuário passam a refletir a troca.
O que não existe
Para planejar sem surpresa: o Payments não calcula MRR nem churn, não tem relatório financeiro nem cupom, e não oferece trial configurável próprio. O que existe disso é da Stripe. A assinatura é só pela Stripe; o Pix existe apenas na cobrança de um valor único, e boleto não há. Para cobrar um valor uma única vez, existe a cobrança avulsa por Pix ou cartão.
Perguntas frequentes
Preciso de conta na Stripe?
Sim. A assinatura acontece na sua conta Stripe, e é lá que o dinheiro entra. O Payments não intermedia o pagamento.
Funciona sem React?
Sim. Os componentes são para React; num backend ou em outro framework, a integração é pela API HTTP, com a chave secreta do projeto no servidor.
O que o usuário vê quando cancela?
O cancelamento acontece no portal da Stripe. Quando o evento chega, as funcionalidades do plano deixam de constar nas permissões dele.
Um agente consegue administrar os planos?
Sim. O Payments tem um servidor MCP que o agente conecta com o seu login no navegador, para consultar o projeto, os gateways, os planos e as assinaturas.
Para continuar lendo
Do usuário ao assinante
O Payments organiza planos, funcionalidades e assinaturas sobre a sua Stripe, e o seu app pergunta só uma coisa: este usuário pode usar isto? Conhecer o Payments
Fontes
Quem escreveu
Continue lendo
Como cobrar assinatura no seu app sem escrever webhookMais sobre Payments · · 4 min
Liberar e bloquear partes do app pelo plano do usuárioMais sobre Payments · · 4 min
Qual o jeito mais simples de colocar login num app que eu fiz com IAAssunto parecido · · 5 min
Como mandar e-mail de confirmação e de senha pelo meu app sem configurar servidor de e-mailAssunto parecido · · 5 min
Como receber um aviso quando o meu site sair do ar, de graçaMais recente · · 5 min
Como publicar um site feito com o Claude Code sem configurar servidorMais recente · · 5 min