Aller au contenu
Démarrer un projetDémarrer

Paiements

Vendez une offre avec Stripe. Checkout, le portail client, des offres avec limites, le webhook et une page de tarifs, en mode test jusqu'à la mise en ligne.

Ce qu’il ajoute

  • packages/billing : les offres, ce que chacune permet, et les prix Stripe. Au départ, une offre gratuite de 3 projets et une offre Pro sans limite, à 10 $ par mois ou 100 $ par an. Modifiez-les dans plans.ts.
  • Stripe Checkout pour s’abonner, et le portail client pour changer d’offre ou résilier.
  • Le webhook sur /api/webhooks/stripe, qui garde chaque abonnement dans votre base de données.
  • /pricing, avec les montants de plans.ts, et Account → Billing.
  • pnpm stripe:setup, qui crée les produits et les prix dans Stripe. Les prix sont retrouvés par lookup key : le même code tourne en mode test et en mode live, et plusieurs produits peuvent partager un compte Stripe.
  • Des tests navigateur pour les parcours de facturation.

L’installer

Restez en mode test jusqu’à la mise en ligne.

  1. Copiez la clé secrète de test dans STRIPE_SECRET_KEY.

  2. Créez les produits et les prix :

    pnpm stripe:setup

  3. Transférez les webhooks vers l’app, et mettez dans STRIPE_WEBHOOK_SECRET le whsec_… affiché :

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

  4. Activez le portail client dans le tableau de bord Stripe : Settings → Billing → Customer portal.

  5. Essayez : Account → Billing → Upgrade, avec la carte 4242 4242 4242 4242.

Avant la mise en ligne

  • Activez le compte Stripe, avec les URL de vos conditions et de votre politique de confidentialité.
  • En mode live, une clé restreinte rk_live_… suffit : écriture sur Checkout Sessions, Customers et Billing Portal ; lecture sur Prices, Products et Subscriptions. Lancez pnpm stripe:setup avec elle.
  • Ajoutez l’endpoint de webhook https://<votre domaine>/api/webhooks/stripe avec les événements checkout.session.completed et customer.subscription.*.
  • Décidez des taxes avec un expert-comptable avant d’activer Stripe Tax.
  • Testez de bout en bout avec un build de production : un abonnement, une résiliation dans le portail, et un paiement refusé avec la carte 4000 0000 0000 0341.

L’écarter ou l’ajouter plus tard

Retirez payments de --modules pour démarrer sans facturation. Avec les paiements, la CLI propose aussi les skills pricing et paywalls pour votre agent. Pour ajouter les paiements à un projet existant, demandez à votre agent d’utiliser le skill add-module.

Lancez une commande. La CLI pose les autres questions, et votre agent prend la suite.

pnpm create turbinekit my-app
Voir le prompt

Collez-le dans un agent qui peut lancer des commandes, comme Claude Code, Codex ou Cursor. Le prompt est en anglais.

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

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.

Sans inscription, sans clé d'API. Il faut Node.js 24 et pnpm 10.