Zum Hauptinhalt springen

Access the Stripe customer portal to manage subscription

POST 
/truckers/payment/register_stripe

Zweck​

Erzeugt eine Stripe-Kundenportal-Sitzung, in der das Unternehmen sein Abonnement verwalten, den Plan wechseln, die Kreditkarte aktualisieren oder Rechnungen einsehen kann.

Ziel​

Zugang zum Stripe-Self-Service-Portal bereitstellen, mit Validierung, dass das Konto aktiv und nicht abgelaufen ist.

Anwendungsfälle​

  • Wechsel vom Basic- zum Professional-Plan oder umgekehrt
  • Aktives Abonnement kündigen
  • Zahlungsmethode des Abonnements aktualisieren
  • Stripe-Rechnungsverlauf einsehen
  • Rechnungen als PDF herunterladen

Validierungsablauf​

flowchart TD
  A[Request empfangen - returnUrl] --> B{returnUrl angegeben?}
  B -->|Nein| C[400 MISSING_RETURN_URL]
  B -->|Ja| D{Benutzer authentifiziert?}
  D -->|Nein| E[404 USER_NOT_FOUND]
  D -->|Ja| F{Unternehmen gefunden?}
  F -->|Nein| G[401 CIA_NOT_FOUND]
  F -->|Ja| H{UserActivity existiert?}
  H -->|Nein| I[404 USER_NOT_FOUND]
  H -->|Ja| J{Konto nicht abgelaufen?}
  J -->|Abgelaufen| K[404 USER_EXPIRED]
  J -->|Aktiv| L[Kundenportal-Sitzung erstellen]
  L --> M[200 Portal-URL]

Hinweise​

  • Erfordert JWT-Authentifizierung (bearerAuth)
  • Im Gegensatz zum Truckers-Modul wird validiert, dass das Konto nicht abgelaufen ist
  • Prüft userActivity.dateEnd > now, bevor die Sitzung erstellt wird
  • Die Rückkehr-URL (returnUrl) ist im Body obligatorisch
  • Die Portal-Sitzung läuft nach ~5 Minuten ab (Stripe-Standardverhalten)
  • Erfordert, dass stripe_customer im Unternehmen konfiguriert ist

Request​

Responses​

URL des Stripe-Kundenportals

Response Headers