Zum Hauptinhalt springen

Set default payment method

POST 
/company/payment/default_payment_method/:id

Zweck​

Legt eine bestehende Zahlungsmethode als Standard für alle zukünftigen Zahlungsvorgänge des Unternehmens fest.

Ziel​

Aktualisierung von payment_settings.default_payment_method im Unternehmen, damit Lieferzahlungen mit dieser Karte abgewickelt werden.

Anwendungsfälle​

  • Auswahl der Hauptkarte nach Hinzufügen einer neuen Karte
  • Änderung der Standardzahlungsmethode nach Verlängerung einer Karte
  • Festlegung der aktiven Methode vor der Abwicklung einer Lieferung

Validierungsablauf​

flowchart TD
  A[Anfrage empfangen - id] --> B{Benutzer authentifiziert?}
  B -->|Nein| C[404 USER_NOT_FOUND]
  B -->|Ja| D{Unternehmen gefunden?}
  D -->|Nein| E[401 CIA_NOT_FOUND]
  D -->|Ja| F{stripe_customer existiert?}
  F -->|Nein| G[404 STRIPE_CUSTOMER_NOT_FOUND]
  F -->|Ja| H{Gehört PM zum Kunden?}
  H -->|Nein| I[401 PAYMENT_METHOD_NOT_FOUND]
  H -->|Ja| J[Als default_payment_method festlegen]
  J --> K[Unternehmen speichern]
  K --> L[200 success: true]

Hinweise​

  • Erfordert JWT-Authentifizierung (bearerAuth)
  • Es kann jeweils nur eine Methode als Standard festgelegt werden
  • Die Eigentumsvalidierung prüft, ob die PM zum stripe_customer des Unternehmens gehört
  • Die Änderung ist sofort wirksam und gilt für die nächsten Lieferzahlungen

Request​

Responses​

Zahlungsmethode als Standard festgelegt

Response Headers