Stripe-Setup für Pusteblume-Abos

Vom Stripe-Account über KYC, 4 Plan-Slugs, Webhook-Endpoint bis zur ersten verifizierten Test-Subscription.

Pusteblume-Abos laufen über Stripe-Subscriptions. Solange STRIPE_SECRET_KEY nicht in der Prod-Env steht, antwortet das Backend mit 503 und das Frontend zeigt einen Mailto-Hinweis. Dieser Artikel führt durch das komplette Setup bis zur ersten echten Abo-Buchung.

Schritt 1 — Stripe-Account anlegen + KYC

https://dashboard.stripe.com/register öffnen
Account-Typ "Unternehmen", Land Deutschland, Waehrung EUR
Rechtsform Einzelunternehmen, USt-ID DE..., IBAN, Personalausweis-

Scan + Selfie hochladen

Branding setzen:

- Firmen-Name: "Tarev" - Statement-Descriptor: TAREV PUSTEBLUME (max 22 Zeichen) - Logo 512x512 quadratisch, Primary-Color #2f7a3a

Stripe Tax aktivieren, Tax-Behavior auf "exclusive" (Preise netto,

Stripe rechnet USt drauf)

KYC dauert 1-3 Werktage. Bis dahin im Test-Mode arbeiten — der Schalter oben rechts im Dashboard.

[Screenshot: Stripe-Dashboard Test-Mode-Toggle oben rechts]

Schritt 2 — 4 Plan-Slugs anlegen

Im Stripe-Dashboard → Produkte → "+ Produkt erstellen". Pro Plan ein eigenes Produkt mit eigenem Recurring-Interval:

| Slug | Frontend-Label | Recurring | Env-Variable | |---|---|---|---| | woechentlich-klein | Wöchentlich klein | jede Woche | PUSTEBLUME_ABO_PRICE_WEEKLY_SMALL | | zweiwochig-medium | Zweiwöchig medium | alle 2 Wochen | PUSTEBLUME_ABO_PRICE_BIWEEKLY_MEDIUM | | monatlich-gross | Monatlich groß | monatlich | PUSTEBLUME_ABO_PRICE_MONTHLY_LARGE | | saisonbox | Saisonbox | alle 3 Monate | PUSTEBLUME_ABO_PRICE_SAISONBOX |

Pro Produkt einen Preis im Standard-Pricing-Modell anlegen, Recurring setzen, Usage-Type licensed. Die generierte ID (price_1XYZ...) notieren.

Schritt 3 — Test-Mode-IDs sind nicht Live-IDs

Stripe vergibt Test- und Live-IDs separat. Erst im Test-Mode alle 4 Preise anlegen, Test-Subscription durchspielen, dann denselben Vorgang im Live-Mode wiederholen. Live-IDs landen in .env.production, Test-IDs in .env.local.

Schritt 4 — Webhook-Endpoint konfigurieren

Dashboard → Entwickler → Webhooks → "+ Endpoint hinzufügen":

URL: https://tarev.de/api/pusteblume-abo/webhook
Events (genau diese 5):

checkout.session.completed
customer.subscription.created
customer.subscription.updated
customer.subscription.deleted
invoice.payment_failed

Signing-Secret kopieren → in .env.production als

STRIPE_WEBHOOK_SECRET_PUSTEBLUME

Schritt 5 — Test-Subscription verifizieren

https://pusteblume.tarev.de/abo öffnen
Plan auswählen → Stripe-Checkout
Test-Karte: 4242 4242 4242 4242, Ablaufdatum in Zukunft, CVC 3

Stellen, Postleitzahl egal

Nach Erfolg im Stripe-Dashboard → Webhooks → Endpoint prüfen, ob

die 4 Events durchgekommen sind (alle "200 OK")

In Tarev unter /dashboard/admin/pusteblume-abos muss das Abo

sichtbar sein

[Screenshot: Stripe-Dashboard Webhook-Event-Liste mit 200-OK-Status]

Schritt 6 — Live-Mode aktivieren

Wenn KYC durch ist + Test-Subscription erfolgreich:

Im Dashboard "Test-Mode" ausschalten
Schritte 2 + 4 im Live-Mode wiederholen
Live-Keys + Live-Price-IDs in .env.production setzen
Backend neu starten
Eine echte 1-Euro-Subscription mit der eigenen Karte zur

Verifikation buchen, dann direkt stornieren

Stripe-Setup für Pusteblume-Abos

Verwandte Artikel