Pular para o conteúdo
Infrastructure
Como cobrar assinatura num app feito com IA e liberar acesso só para quem pagou

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.

Ciro Cesar Maciel5 min de leituraFeito com ajuda de IA

Nesta página · 8 seções
  1. As peças, em uma frase
  2. Passo a passo com o agente
  3. O que acontece quando o plano muda
  4. O que não existe
  5. Perguntas frequentes
  6. Para continuar lendo
  7. Do usuário ao assinante
  8. Fontes

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 um fallback para 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

XLinkedInWhatsAppE-mail

Quem escreveu

Ciro Cesar Maciel

Sou marido, pai e trabalho com tecnologia há mais de duas décadas, construindo sistemas para grandes empresas e liderando times técnicos. Desde 2024 desenvolvo ferramentas digitais e aplico Inteligência Artificial para viver e trabalhar com mais clareza, e escrevo aqui sobre isso.

Todos os textos

Continue lendo

Comentários

Seu e-mail fica com Infrastructure para moderar e responder. O comentário aparece depois de aprovado.