Zahlungen

Was es hinzufügt

• packages/billing: die Pläne, was jeder Plan erlaubt, und die Stripe-Preise. Zum Start gibt es einen kostenlosen Plan mit 3 Projekten und einen Pro-Plan ohne Limit, für 10 $ im Monat oder 100 $ im Jahr. Ändere sie in plans.ts.
• Stripe Checkout zum Abonnieren und das Kundenportal zum Wechseln oder Kündigen.
• Der Webhook unter /api/webhooks/stripe, der jedes Abo in deiner Datenbank festhält.
• /pricing mit den Beträgen aus plans.ts, und Account → Billing.
• pnpm stripe:setup, das die Produkte und Preise in Stripe anlegt. Preise werden über ihren Lookup-Key gefunden. So läuft derselbe Code im Test- und im Live-Modus, und mehrere Produkte können sich ein Stripe-Konto teilen.
• Browser-Tests für die Abrechnungsabläufe.

Einrichten

Bleib bis zum Livegang im Testmodus.

1. Kopiere den geheimen Test-Key in STRIPE_SECRET_KEY.

2. Lege die Produkte und Preise an:

   pnpm stripe:setup
   

3. Leite Webhooks an die App weiter, und setze STRIPE_WEBHOOK_SECRET auf das whsec_…, das der Befehl ausgibt:

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

4. Schalte das Kundenportal im Stripe-Dashboard ein: Settings → Billing → Customer portal.

5. Probier es aus: Account → Billing → Upgrade, mit der Karte 4242 4242 4242 4242.

Vor dem Livegang

• Aktiviere das Stripe-Konto, mit den URLs deiner AGB und deiner Datenschutzerklärung.
• Im Live-Modus reicht ein eingeschränkter Key rk_live_…: Schreibzugriff auf Checkout Sessions, Customers und Billing Portal; Lesezugriff auf Prices, Products und Subscriptions. Führe pnpm stripe:setup damit aus.
• Füge den Webhook-Endpoint https://<deine Domain>/api/webhooks/stripe mit den Events checkout.session.completed und customer.subscription.* hinzu.
• Kläre die Steuern mit deiner Steuerberatung, bevor du Stripe Tax einschaltest.
• Teste End-to-End mit einem Production-Build: ein Abo abschließen, im Portal kündigen, und eine fehlgeschlagene Zahlung mit der Karte 4000 0000 0000 0341.

Weglassen oder später hinzufügen

Lass payments in --modules weg, um ohne Abrechnung zu starten. Mit Zahlungen bietet die CLI deinem Agent auch die Skills pricing und paywalls an. Um Zahlungen zu einem bestehenden Projekt hinzuzufügen, bitte deinen Agent, den Skill add-module zu nutzen.

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

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.