Zum Hauptinhalt springen

Process payment for a delivery

POST 
/company/payment/pay

Erstelle einen Stripe Payment Intent, um den Betrag einer bestimmten Lieferung mit der Standardzahlungsmethode des Unternehmens zu bezahlen.

Ziel​

Die Zahlung des Unternehmens für eine zugewiesene Lieferung einleiten, einschließlich der Plattformgebühr, und beide Parteien per E-Mail benachrichtigen.

Anwendungsfälle​

  • Unternehmen bezahlt für eine per Auktion zugewiesene Lieferung
  • Automatische Abrechnung abgeschlossener Lieferungen
  • Zahlungsabwicklung zwischen Unternehmen und Transportunternehmen

Validierungsablauf​

flowchart TD
  A[Anfrage erhalten - serviceCode] --> 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{withStripe aktiviert?}
  F -->|Nein| G[403 STRIPE_PAYMENTS_DISABLED]
  F -->|Ja| H{default_payment_method gesetzt?}
  H -->|Nein| I[401 PAYMENT_METHOD_NOT_FOUND]
  H -->|Ja| J{Lieferung gefunden?}
  J -->|Nein| K[401 DELIVERY_NOT_FOUND]
  J -->|Ja| L[Betrag + Plattformgebühr berechnen]
  L --> M[Payment Intent in Stripe generieren]
  M --> N[payment_intent in Lieferung speichern]
  N --> O[E-Mails an beide Parteien senden]
  O --> P[200 success: true]

Hinweise​

  • Erfordert JWT-Authentifizierung (bearerAuth)
  • Erfordert withStripe=true in den payment_settings des Unternehmens
  • Erfordert konfigurierte Standardzahlungsmethode (default_payment_method)
  • Die Plattformgebühr wird aus Settings bezogen (Standard 3%)
  • Sendet E-Mails an das Unternehmen und den Transportunternehmer (trucker_cia)
  • Die payment_intent-ID wird im `

Request​

Responses​

Payment Intent erstellt und Zahlung eingeleitet

Response Headers