Pagos

Qué agrega

• packages/billing: los planes, lo que permite cada plan y los precios de Stripe. Empieza con un plan gratuito de 3 proyectos y un plan Pro sin límite, a 10 US$ al mes o 100 US$ al año. Cámbialos en plans.ts.
• Stripe Checkout para suscribirse, y el portal de clientes para cambiar de plan o cancelar.
• El webhook en /api/webhooks/stripe, que guarda cada suscripción en tu base de datos.
• /pricing, con los montos de plans.ts, y Account → Billing.
• pnpm stripe:setup, que crea los productos y los precios en Stripe. Los precios se buscan por lookup key, así que el mismo código funciona en modo de prueba y en modo en vivo, y varios productos pueden compartir una cuenta de Stripe.
• Tests de navegador para los flujos de facturación.

Configurarlo

Usa el modo de prueba hasta el lanzamiento.

1. Copia la clave secreta de prueba en STRIPE_SECRET_KEY.

2. Crea los productos y los precios:

   pnpm stripe:setup
   

3. Reenvía los webhooks a la app, y define STRIPE_WEBHOOK_SECRET con el whsec_… que imprime:

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

4. Activa el portal de clientes en el dashboard de Stripe: Settings → Billing → Customer portal.

5. Pruébalo: Account → Billing → Upgrade, con la tarjeta 4242 4242 4242 4242.

Antes del lanzamiento

• Activa la cuenta de Stripe, con las URL de tus términos y de tu política de privacidad.
• En modo en vivo, basta con una clave restringida rk_live_…: escritura en Checkout Sessions, Customers y Billing Portal; lectura en Prices, Products y Subscriptions. Ejecuta pnpm stripe:setup con ella.
• Agrega el endpoint de webhook https://<tu dominio>/api/webhooks/stripe con los eventos checkout.session.completed y customer.subscription.*.
• Decide qué hacer con los impuestos con un contador antes de activar Stripe Tax.
• Prueba de principio a fin con un build de producción: una suscripción, una cancelación en el portal y un pago fallido con la tarjeta 4000 0000 0000 0341.

Dejarlo fuera o agregarlo después

Deja payments fuera de --modules para empezar sin facturación. Con Pagos activado, la CLI también ofrece los skills pricing y paywalls para tu agente. Para agregar Pagos a un proyecto existente, pide a tu agente que use el skill add-module.

Create a new TurbineKit project with me.
Talk to me in Spanish.

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.