Zum Hauptinhalt springen

Stripe Connect Onboarding Refresh Callback

GET 
/company/payment/onboarding/refresh

Zweck​

Callback-Endpoint, an den Stripe weiterleitet, wenn der Onboarding-Link abgelaufen ist oder der Prozess mit zusätzlichen Informationen fortgesetzt werden muss.

Ziel​

Ausstehende Onboarding-Anforderungen in der Datenbank aktualisieren und eine Seite mit den Feldern anzeigen, die das Unternehmen ausfüllen muss.

Anwendungsfälle​

  • Abgelaufener Onboarding-Link (>5 Minuten)
  • Unternehmen, das den Prozess unterbrochen hat und ihn fortsetzen muss
  • Stripe erkennt unvollständige oder falsche Informationen
  • Liste der ausstehenden Felder anzeigen (currently_due, past_due)

Validierungsablauf​

flowchart TD
  A[Anfrage empfangen - account_id] --> B{account_id gültig?}
  B -->|Nein| 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 gefunden?}
  G -->|Nein| H[404 CIA_NOT_FOUND]
  G -->|Ja| I[Status = requirements_needed setzen]
  I --> J[In DB speichern]
  J --> K[HTML mit Anforderungsliste rendern]

Hinweise​

  • Erfordert keine Authentifizierung (öffentlicher Stripe-Callback)
  • Stets onboarding_status = 'requirements_needed' setzen
  • Für einen neuen Link: GET /bank_account_link aufrufen
  • currently_due, past_due und eventually_due im Template einbeziehen
  • Gibt HTML zurück, nicht JSON

Request​

Responses​

HTML-Seite mit den ausstehenden Onboarding-Anforderungen

Response Headers