Zum Hauptinhalt springen

Register company as a customer in Stripe

POST 
/company/payment/register_stripe

Zweck​

Erstellt einen Stripe-Kunden für den authentifizierten Benutzer, falls noch keiner registriert ist, und gibt die Kunden-ID zurück.

Ziel​

Die Beziehung zwischen dem Unternehmensbenutzer und Stripe initialisieren, indem die für alle nachfolgenden Zahlungsvorgänge erforderliche stripe_customer-ID abgerufen wird.

Anwendungsfälle​

  • Erste Registrierung vor der Einrichtung von Zahlungsmethoden
  • Überprüfen, ob der Benutzer bereits bei Stripe registriert ist
  • Voraussetzung für Abonnements und Zahlungen

Validierungsablauf​

flowchart TD
  A[Anfrage empfangen] --> B{Benutzer authentifiziert?}
  B -->|Nein| C[404 USER_NOT_FOUND]
  B -->|Ja| D{Benutzer in DB?}
  D -->|Nein| E[401 USER_NOT_FOUND]
  D -->|Ja| F{stripe_customer existiert?}
  F -->|Ja| G[Bestehende ID zurückgeben]
  F -->|Nein| H[Stripe-Kunden erstellen]
  H --> I{Erfolgreich erstellt?}
  I -->|Nein| J[401 STRIPE_ACCOUNT_NOT_CREATED]
  I -->|Ja| K[ID in user.payment_settings speichern]
  K --> L[200 Erfolg + stripe_customer]
  G --> L

Hinweise​

  • Erfordert JWT-Authentifizierung (bearerAuth)
  • Idempotent: Falls stripe_customer bereits existiert, wird die bestehende ID zurückgegeben
  • Operiert auf dem company_user, nicht direkt auf dem Unternehmen
  • Kein Request Body erforderlich

Request​

Responses​

Stripe-Kunde erfolgreich registriert oder bereits vorhanden

Response Headers