Stripe-Setup für Pusteblume-Abos

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

1. https://dashboard.stripe.com/register öffnen
2. Account-Typ "Unternehmen", Land Deutschland, Währung EUR
3. Rechtsform Einzelunternehmen, USt-ID DE..., IBAN, Personalausweis- Scan + Selfie hochladen
4. Branding setzen:
   • Firmen-Name: "Tarev"
   • Statement-Descriptor: TAREV PUSTEBLUME (max 22 Zeichen)
   • Logo 512x512 quadratisch, Primary-Color #2f7a3a
5. 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.

Schritt 2 — 4 Plan-Slugs anlegen

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

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

1. https://pusteblume.tarev.de/abo öffnen
2. Plan auswählen → Stripe-Checkout
3. Test-Karte: 4242 4242 4242 4242, Ablaufdatum in Zukunft, CVC 3 Stellen, Postleitzahl egal
4. Nach Erfolg im Stripe-Dashboard → Webhooks → Endpoint prüfen, ob die 4 Events durchgekommen sind (alle "200 OK")
5. In Tarev unter /dashboard/admin/pusteblume-abos muss das Abo sichtbar sein

Schritt 6 — Live-Mode aktivieren

Wenn KYC durch ist + Test-Subscription erfolgreich:

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

Verwandte Artikel

• VAPID-Keys einrichten für Push-Notifications
• Foto-Upload für Pusteblume-Sortiment
• Storno einer Pusteblume-Bestellung