Zum Hauptinhalt springen

Set up new payment method

POST 
/truckers/payment/setup_payment_method

Zweck​

Generiert eine URL für das Stripe-Portal, damit das Unternehmen sicher eine neue Zahlungsmethode (Kredit-/Debitkarte) hinzufügen kann.

Ziel​

Den Benutzer zum Stripe-Portal weiterleiten, wo er seine Kartendaten registrieren kann, ohne sensible Daten dem Backend preiszugeben.

Anwendungsfälle​

  • Erste Kredit-/Debitkarte hinzufügen
  • Zusätzliche Zahlungsmethoden hinzufügen (max. 10)
  • Abgelaufene Karten durch neue ersetzen

Validierungsablauf​

flowchart TD
  A[Anfrage 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{stripe_customer existiert?}
  H -->|Nein| I[404 STRIPE_CUSTOMER_NOT_FOUND]
  H -->|Ja| J{Anzahl < 10?}
  J -->|Nein| K[200 - Leerer String]
  J -->|Ja| L[Zahlungsmethoden-Portal erstellen]
  L --> M[200 - Portal-URL]

Hinweise​

  • Erfordert JWT-Authentifizierung (bearerAuth)
  • Limit von 10 Zahlungsmethoden pro Unternehmen; bei Erreichen wird `` (leerer String) zurückgegeben
  • Erfordert, dass das Unternehmen einen stripe_customer hat (zuerst /register_stripe verwenden)
  • Die returnUrl ist die URL, zu der Stripe den Benutzer nach Hinzufügen der Methode weiterleitet

Request​

Responses​

URL des Portals oder leerer String, wenn das Limit von 10 erreicht wurde

Response Headers