Zum Hauptinhalt springen

Set default payment method

POST 
/company/payment/default_payment_method/:id

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

Ziel​

Aktualisiere payment_settings.default_payment_method im Unternehmen, damit Lieferzahlungen mit dieser Karte verarbeitet werden.

Anwendungsfälle​

  • Hauptkarte auswählen, nachdem eine neue hinzugefügt wurde
  • Standardmethode ändern, nachdem eine Karte erneuert wurde
  • Aktive Methode festlegen, bevor eine Lieferung verarbeitet wird

Validierungsablauf​

flowchart TD
  A[Anfrage erhalten - 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{PM gehört 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)
  • Nur eine Methode kann gleichzeitig 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