Zum Hauptinhalt springen

Enable or disable payments with Stripe

POST 
/company/payment/withStripe

Zweck​

Aktiviert oder deaktiviert die Stripe-Zahlungsintegration für das Unternehmen des authentifizierten Benutzers.

Ziel​

Vollständige Kontrolle für den Unternehmensadministrator darüber, ob elektronische Zahlungen aktiv sind, mit automatischer Erstellung des Stripe-Kunden bei erstmaliger Aktivierung.

Anwendungsfälle​

  • Stripe erstmalig aktivieren, um Zahlungen zu empfangen
  • Elektronische Zahlungen vorübergehend deaktivieren
  • Zahlungen nach einer Inaktivitätsphase reaktivieren

Validierungsablauf​

flowchart TD
  A[Request empfangen - enabled] --> 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[Setze withStripe = enabled]
  F --> G{enabled=true UND kein stripe_customer?}
  G -->|Ja| H[Stripe-Kunde automatisch erstellen]
  H --> I{Erfolgreich erstellt?}
  I -->|Nein| J[500 Error]
  I -->|Ja| K[Unternehmen speichern]
  G -->|Nein| K
  K --> L[200 success: true]

Hinweise​

  • Erfordert JWT-Authentifizierung (bearerAuth)
  • Wenn enabled=true und kein stripe_customer existiert, wird dieser automatisch unter Verwendung von invoice_data.email erstellt
  • Wenn enabled=false, wird nur deaktiviert, ohne den Stripe-Kunden oder Zahlungsmethoden zu löschen

Request​

Responses​

Stripe-Konfiguration aktualisiert

Response Headers