Zum Hauptinhalt springen

Stripe Connect Onboarding Callback

GET 
/company/payment/onboarding/return

Zweck​

Callback-Endpoint, an den Stripe das Unternehmen nach Abschluss (oder Versuch) des Stripe Connect Onboarding-Prozesses weiterleitet.

Ziel​

Aktualisierung des Onboarding-Status in der Datenbank, Registrierung des verknüpften Bankkontos (falls vorhanden) und Anzeige einer HTML-Bestätigungsseite.

Anwendungsfälle​

  • Bestätigung nach Abschluss des Stripe Connect Onboardings
  • Erkennung ausstehender Anforderungen nach Rückkehr von Stripe
  • Automatische Aktualisierung von onboarding_status im Unternehmen
  • Registrierung von stripe_bankaccount, falls ein Bankkonto verknüpft wurde

Validierungsablauf​

flowchart TD
  A[Request empfangen - account_id, lang] --> B{account_id gültiges Format?}
  B -->|Nein - nicht acct_...| C[400 STRIPE_ACCOUNT_ID_INVALID]
  B -->|Ja| D[Stripe-Konto abrufen]
  D --> E{Konto gefunden?}
  E -->|Nein| F[404 STRIPE_ACCOUNT_NOT_FOUND]
  E -->|Ja| G{Unternehmen per stripe_account gefunden?}
  G -->|Nein| H[404 CIA_NOT_FOUND]
  G -->|Ja| I{Bankkonto in Stripe vorhanden?}
  I -->|Ja| J[stripe_bankaccount ID speichern]
  I -->|Nein| K[Fortfahren]
  J --> K
  K --> L{requirements.currently_due leer?}
  L -->|Ja| M[status = completed + redirect_url]
  L -->|Nein| N[status = requirements_needed]
  M --> O[HTML-Template rendern]
  N --> O

Hinweise​

  • Erfordert keine Authentifizierung (öffentlicher Stripe-Callback)
  • Die account_id muss mit acct_ beginnen
  • lang steuert die Sprache der gerenderten HTML-Seite (Standard: es)
  • Aktualisiert payment_settings.onboarding_status und payment_settings.onboarding_last_update
  • Falls ein Bank

Request​

Responses​

HTML-Seite mit dem Ergebnis des Onboardings

Response Headers