Pagamentos

O que ele adiciona

• packages/billing: os planos, o que cada plano permite e os preços no Stripe. Ele começa com um plano gratuito de 3 projetos e um plano Pro sem limite, a US$ 10 por mês ou US$ 100 por ano. Mude os planos no plans.ts.
• O Stripe Checkout para assinar, e o portal do cliente para mudar de plano ou cancelar.
• O webhook em /api/webhooks/stripe, que mantém cada assinatura no seu banco de dados.
• /pricing, com os valores do plans.ts, e Account → Billing.
• pnpm stripe:setup, que cria os produtos e os preços no Stripe. Os preços são encontrados pela lookup key, então o mesmo código roda no modo de teste e no modo de produção, e vários produtos podem compartilhar uma conta Stripe.
• Testes de navegador para os fluxos de cobrança.

Como configurar

Use o modo de teste até entrar no ar.

1. Copie a chave secreta de teste para STRIPE_SECRET_KEY.

2. Crie os produtos e os preços:

   pnpm stripe:setup
   

3. Encaminhe os webhooks para o app, e defina STRIPE_WEBHOOK_SECRET com o whsec_… que o comando imprime:

   stripe listen --forward-to localhost:3000/api/webhooks/stripe
   

4. Ative o portal do cliente no painel do Stripe: Settings → Billing → Customer portal.

5. Teste: Account → Billing → Upgrade, com o cartão 4242 4242 4242 4242.

Antes de entrar no ar

• Ative a conta Stripe, com as URLs dos seus termos de uso e da sua política de privacidade.
• No modo de produção, uma chave restrita rk_live_… basta: escrita em Checkout Sessions, Customers e Billing Portal; leitura em Prices, Products e Subscriptions. Rode pnpm stripe:setup com ela.
• Adicione o endpoint de webhook https://<seu domínio>/api/webhooks/stripe com os eventos checkout.session.completed e customer.subscription.*.
• Decida sobre os impostos com um contador antes de ativar o Stripe Tax.
• Teste de ponta a ponta com um build de produção: uma assinatura, um cancelamento no portal e um pagamento recusado com o cartão 4000 0000 0000 0341.

Deixar de fora ou adicionar depois

Deixe payments fora de --modules para começar sem cobrança. Com o módulo Pagamentos, a CLI também oferece os skills pricing e paywalls para o seu agente. Para adicionar Pagamentos a um projeto existente, peça ao seu agente para usar o skill add-module.

Create a new TurbineKit project with me.
Talk to me in Brazilian Portuguese.

TurbineKit (https://turbinekit.dev) is an open-source Turborepo and Next.js starter. Its CLI, create-turbinekit, needs Node.js 24 and pnpm 10 (run `corepack enable` once).

1. Run `pnpm dlx create-turbinekit --help` to see its options.
2. Ask me its questions one at a time, with their defaults: the folder, the product name, one sentence about the product, the company or legal name, the contact email, the languages and the modules. Skip what I have already told you.
3. The CLI only asks questions in an interactive terminal, so run it with my answers as options and `--yes`. Show me the command before you run it.
4. In the new folder, read AGENTS.md. Then do "1. Minimal setup" in SETUP.md, and tick each box you finish.
5. Tell me the URL of the running app, and which services SETUP.md lists next.