43 — Stripe Connect (Express-Auszahlungen)

Stripe Connect ist die bequemste Auszahlungs-Variante: Partner verbinden ihren eigenen Stripe-Account (Express-Mode), und PartnerDesk pusht die Provisionen direkt dorthin. Stripe kümmert sich um Auszahlung an die Partner-Bank, KYC/AML, Tax-Forms.

Wann sinnvoll?

• Sie haben viele Partner und wollen den manuellen SEPA/PayPal-Aufwand sparen.
• Internationale Partner — Stripe deckt 40+ Länder ab.
• Sie wollen Steuer-Formulare (z. B. 1099 in den USA) automatisch handhaben.

Voraussetzungen

Für Sie als Tenant

• Stripe-Account mit aktivem Stripe Connect (Sie sind „Connected Platform").
• Plattform-Owner muss STRIPE_SECRET_KEY als Env-Variable gesetzt haben.
• Genug Guthaben in Ihrem Stripe-Platform-Account.

Für Partner

• Eine Email-Adresse (haben sie ja schon).
• Bereitschaft, das Stripe-Onboarding durchzulaufen (Identity-Verification, Bankdaten).

Workflow

Partner: Onboarding

1. Partner-Portal → „Stripe Connect".
2. Klick „Mit Stripe verbinden".
3. Wahl des Landes.
4. Redirect zu Stripe — Identity-Verification, Bankdaten eingeben.
5. Zurück zu PartnerDesk → Status-Card zeigt „Aktiv".

Status-Stufen

Status	Bedeutung
onboarding	Partner ist auf Stripes Onboarding-Page — noch nicht durch
pending_verification	Stripe prüft die Identity (i. d. R. Minuten bis Stunden)
active	Voll funktionsfähig — Auszahlungen können fließen

isReady = active AND payouts_enabled AND details_submitted — bequeme Schnellprüfung.

Admin: Auszahlung via Stripe

Admin → „Auszahlungen" → Detail-View → „Per Stripe auszahlen".

Pre-Checks:

• Payout ist approved.
• Kein vorheriger Stripe-Transfer (stripe_transfer_id ist NULL).
• Partner hat isReady=true.
• Stripe ist konfiguriert.

Effekt:

1. Stripe-Transfer wird mit Idempotency-Key payout_<id> angelegt — wiederholter Aufruf garantiert kein Doppel-Transfer.
2. Geld wandert vom Platform-Account zum Partner-Stripe-Account.
3. Lokaler Payout wird auf paid markiert.
4. Audit-Log dokumentiert Transfer-ID.

Stripe → Bank-Auszahlung

Sobald das Geld im Partner-Stripe-Account ist, kümmert sich Stripe um die Auszahlung an die Bank des Partners. Stripe schickt zurück:

• transfer.created / transfer.failed — Transfer-Status.
• payout.paid / payout.failed — Bank-Auszahlung Status.

PartnerDesk loggt all diese Events ins Audit-Log mit Tags arrival_date, ggf. failure_code.

Admin-Sicht auf Partner-Status

Im Partner-Detail und in der Partnerliste sehen Sie pro Partner:

• Status-Badge: Ready (grün), Verbunden (gelb), oder leer.
• Filter: in der Liste nach stripeConnect=ready|connected|none.
• Auto-Refresh: wenn der Status nicht ready ist, frischt PartnerDesk beim Öffnen der Detail-View automatisch von Stripe.

Partner-Express-Dashboard

Stripe stellt ein „Express-Dashboard" zur Verfügung, in dem der Partner:

• Seine Bankdaten ändern kann.
• Aktuelle Auszahlungen sehen kann.
• Tax-Forms downloaden kann.

PartnerDesk generiert für Partner einen One-Time-Login-Link auf Klick — „Stripe-Dashboard öffnen".

Kosten

Stripe Connect ist kostenlos in den meisten Konstellationen. Transfer-Fees (Stripe Standard Pricing) tragen Sie als Plattform.

Was tun bei Fehlern?

Fehler	Was passiert
Partner hat unvollständiges Onboarding	„Per Stripe auszahlen"-Button erscheint nicht
Stripe-Transfer schlägt fehl (z. B. zu wenig Guthaben)	Payout bleibt approved, Audit-Eintrag, Admin kann manuell nachladen
payout.failed von Stripe (Bank lehnt ab)	Stripe versucht 7 Tage erneut, dann Hard-Fail. PartnerDesk loggt Event

Verwandte Kapitel

• 40 — Auszahlungs-Workflow
• 42 — SEPA-XML-Export (Alternative)
• 31 — Stripe (für Sales — andere Funktion!)

---

Technische Tiefen-Doku: ../115-stripe-connect.md, ../116-stripe-connect-admin-transfer.md