Try Demo Starten Sie Ihr Geschäft
Booknetic
Buch Booknetic kaufen

Stripe Connect-Integration

Richten Sie Stripe Connect in Booknetic SaaS ein, damit Mandanten Kundenzahlungen über eigene verbundene Stripe-Konten annehmen können.

Version:
Kategorien

Wichtig — Stripe Connect ist für Zahlungen zwischen Mandant und Kunde, NICHT für SaaS-Abonnementabrechnung

Auf Booknetic SaaS können drei verschiedene Stripe-Konfigurationen gleichzeitig aktiv sein. Verwechseln Sie sie nicht:

Konfiguration

Was sie tut

Wo in Booknetic

Wer das Geld einsammelt

Stripe (SaaS-Abrechnung)

Belastet Ihre Mandanten für ihr SaaS-Abonnement (die monatliche/jährliche Gebühr, die sie Ihnen zahlen)

Booknetic SaaS → Settings → Payment settings → Payment methods → Stripe

Sie (der Plattforminhaber)

Stripe Connect (diese Seite)

Ermöglicht jedem Mandanten, seine eigenen Kunden über Stripe zu belasten (die Buchungsgebühren, die Kunden den Mandanten zahlen)

Booknetic SaaS → Settings → Payment settings → Payment methods → Stripe Connect + Mandant-Onboarding

Jeder Mandant (Stripe leitet die Gelder auf das Stripe Connect-Konto des Mandanten weiter)

Tenant-seitiges Stripe (nicht Connect)

Alternative zu Stripe Connect — jeder Mandant fügt seine eigenen Stripe API-Schlüssel ein, um seine Kunden zu belasten

Panel jedes Mandanten → Settings → Payment methods → Stripe

Jeder Mandant direkt

Sie müssen nicht alle drei einrichten. Die meisten SaaS-Anbieter richten ein:

  • SaaS-Abrechnung Stripe (damit sie von den Mandanten bezahlt werden) +
  • Stripe Connect (damit ihre Mandant von deren Kunden bezahlt werden).

Voraussetzungen

Bevor Sie beginnen:

  • Ein Stripe-Konto (https://dashboard.stripe.com), das die Connect-Plattform besitzt.
  • Ein Unternehmen in einem Land, in dem Stripe Connect verfügbar ist (https://stripe.com/global).
  • Die stripe-connect-Planfähigkeit auf jedem Tarif aktiviert, dessen Mandant sich bei Stripe Connect onboarden sollen (Booknetic SaaS → Plans → Tarif bearbeiten → stripe-connect einschalten).

Richten Sie Ihre Stripe Connect-Plattform ein

Schritt 1: Öffnen Sie die Stripe Connect-Einrichtung.

Melden Sie sich bei https://dashboard.stripe.com/connect/set-up an. Der Connect-Einrichtungsassistent führt Sie durch mehrere Phasen — die genaue Wortwahl kann sich ändern, wenn Stripe die Benutzeroberfläche aktualisiert, aber die Struktur bleibt gleich.

Schritt 2: Informieren Sie Stripe über Ihre Plattform.

  • Plattformprofil — beschreiben Sie, was Ihre Plattform macht (Multi-Mandant-Buchungssoftware). Stripe verwendet dies für die Risikobewertung.
  • Geschäftsmodell — wählen Sie die Option, die zu Ihrer Plattform passt. Für die meisten SaaS-Buchungsplattformen ist „Multi-Party-Plattform mit verbundenen Konten, die Zahlungen von ihren eigenen Kunden einziehen“ die richtige Wahl.
  • Verantwortlichkeiten anerkennen — Stripe listet Ihre Pflichten als Plattform auf; aktivieren Sie das Kästchen, sobald Sie sie gelesen haben.

**Schritt 3: Wählen Sie, wie Ihre verbundenen Konten (Mandant) ausgezahlt werden.

  • Direkte Gebühren, Zielgebühren oder separate Gebühren/Überweisungen. Die meisten Booknetic SaaS-Inhaber verwenden Zielgebühren, damit die Mandant die Kundenbeziehung besitzen, während Sie im Zahlungsfluss bleiben.

Schritt 4: Wählen Sie Ihre Branche.

Die Branchentaxonomie von Stripe beeinflusst das Risikobewertungssystem und die verfügbaren Gebührenstufen für Ihre Plattform. Wählen Sie die Option, die am besten zum tatsächlichen Geschäft Ihrer Mandant passt:

  • „Persönliche Dienstleistungen“ / „Salons & Spas“ / „Gesundheit & Wellness“ — für Grooming- und Wellness-SaaS-Plattformen.
  • „Bildung“ — für Nachhilfe-/Coaching-Buchungsplattformen.
  • „Professionelle Dienstleistungen“ — für Beratungs-/Rechts-/Agenturbuchungen.
  • „Business-Management-Software“ oder „Andere“ — als Rückfalloption, falls keine der oben genannten passt.

Schritt 5: Wählen Sie Ihr Onboarding-Modell.

Onboarding-Modell

Wann man es wählen sollte

Erfahrung des Mandanten

Stripe-gehostet (Express) — empfohlen für die meisten SaaS

Einfachstes Onboarding; Stripe sammelt KYC und Ausweisdokumente; Mandant meldet sich beim Stripe Express-Dashboard für Auszahlungen/Streitfälle an

Mandant klickt auf Register in Booknetic → Stripe Weiterleitung → 5-7 Felder ausfüllen → Rückkehr zu Booknetic

Stripe-gehostet (Standard)

Jeder Mandant hat sein eigenes vollständiges Stripe Dashboard-Konto auf seinen Namen; am besten, wenn Mandant Stripe-Funktionen über Buchungen hinaus benötigen

Mandant klickt Register → vollständige Stripe-Anmeldung

Benutzerdefiniert

Erweitert — Sie erstellen das Onboarding-Formular selbst und sammeln KYC/Geschäftsdaten

Erfordert Entwicklungsarbeit; nicht von Booknetic standardmäßig abgedeckt

Für den Rest dieser Anleitung gehen wir von Stripe-gehostet Express aus.

Schritt 6: Branding der Connect-Erfahrung.

Laden Sie Ihr Unternehmenslogo und ein Symbol hoch. Optional können Akzentfarben angepasst werden. Diese werden den Mandanten während des Onboardings angezeigt.

Stripe-Zugangsdaten in Booknetic einfügen

  1. In Stripe Dashboard → Developers → API-Schlüssel (https://dashboard.stripe.com/apikeys kopieren:
    • Publishable key (pk_live_... oder pk_test_...)
    • Secret key (sk_live_... oder sk_test_...)
  2. In Booknetic SaaS → Settings → Payment settings → Payment methods → Stripe Connect, beide Schlüssel einfügen.
  3. Speichern.

Konfigurieren Sie den Stripe Connect-Webhooks

  1. In Booknetic SaaS → Settings → Payment settings → Payment methods → Stripe Connect kopieren Sie das Webhook URI (die URL enthält booknetic_saas_action=stripe_webhook).
  2. In Stripe Dashboard → Developers → Webhooks → Add endpoint die URL einfügen.
  3. Abonniere mindestens diese Events (Stripe's UI erlaubt es Ihnen, weitere hinzuzufügen):
    • payment_intent.succeeded
    • payment_intent.payment_failed
    • charge.refunded
    • account.updated (damit Booknetic weiß, wann sich der Verifizierte Status eines Mandanten ändert)
  4. Nach der Erstellung des Endpunkts kopieren Sie das Signing secret (whsec_...) zurück in Booknetic Stripe Connect Einstellungen.
  5. Speichern.

Mandant-Onboarding

  1. Stellen Sie sicher, dass der Tarif des Mandanten die stripe-connect-Funktion aktiviert hat.
  2. Der Mandant geht zu Mandantenpanel → Settings → Zahlungs- Settings → Zahlungsmethoden → Stripe Connect und klickt auf Register.
  3. Booknetic leitet sie an den gehosteten Onboarding-Flow von Stripe um.
  4. Der Mandant füllt Geschäftsdaten, Bankkonto und Identitätsprüfung aus.
  5. Nach Abschluss leitet Stripe sie zurück zu Booknetic. Ihr Stripe Connect Status zeigt sich im Mandantenpanel.

Mandantenstatus und was sie bedeuten

Status in Booknetic

Bedeutung

Was der Mandant tun sollte

Ausstehend

Der Mandant hat Register angeklickt, aber Stripe Onboarding noch nicht abgeschlossen

Mandant muss das Onboarding abschließen

Eingeschränkt

Stripe einige Details akzeptiert, benötigt aber zusätzliche Informationen (ID, Adresse, Bankbestätigung).

Der Mandant muss sich in seinem Stripe Express Dashboard anmelden und die fehlenden Informationen angeben

Verifiziert

KYC vollständig; Mandant kann Zahlungen annehmen

Keine Aktion

Behindert

Stripe das Konto deaktiviert (vermuteter Betrug, Verstoß gegen die Nutzungsbedingungen, Länderänderung usw.)

Der Mandant muss Stripe Support kontaktieren

Rückerstattungen und Einfechtungen

Rückerstattungen werden in Stripe Dashboard oder Stripe Express Dashboard abgewickelt, nicht in Booknetic. Um eine Rückerstattung auszustellen:

  1. Der Mandant oder Plattforminhaber eröffnet die entsprechende Zahlung in Stripe Dashboard.
  2. Klicken Sie auf Rückerstattung und wählen Sie eine vollständige oder teilweise Rückerstattung aus.
  3. Der Buchungsstatus in Booknetic ändert sich nicht automatisch zu "erstattet" – der Mandant sollte den Terminstatus manuell aktualisieren.

Streitigkeiten (Rückbuchungen) fließen auf das Dashboard des verbundenen Kontos. Der Mandant – nicht die Plattform – ist verantwortlich für die Reaktion.

Häufige Setup-Blocker

Symptom

Wahrscheinliche Ursache

Fix

"Stripe Connect" erscheint nicht in Mandantenzahlungsmethoden

stripe-connect Fähigkeit AUS im Mandantentarif

Booknetic SaaS → Plans → stripe-connect EINSCHALTEN

Der Mandant klickt Register, erhält einen Stripe Fehler "Onboarding nicht konfiguriert".

Plattform-Setup unvollständig (kein Publishable/Secret key in Booknetic gespeichert oder Connect-Plattform noch nicht aktiviert in Stripe Dashboard)

Überprüfen Sie den oben genannten Schritt die Stripe Zugangsdaten noch einmal

Der Status des Mandanten bleibt für immer ausstehend

Webhook nicht zu account.updated abonniert

Fügen Sie account.updated zum Webhook-Endpunkt gemäß dem obigen Webhook-Schritt hinzu

Mandant in einem Land Stripe Connect wird nicht unterstützt

Stripe-Einschränkung

Mandant verwendet mandantenseitiges Stripe (nicht Connect) oder ein anderes Gateway