Zum Hauptinhalt springen

Get checkout URLs for subscription plans

GET 
/company/payment/urls

Generieren Sie Stripe-Checkout-Sitzungs-URLs für jedes verfügbare Abonnementplan, bereit zur Weiterleitung des Benutzers.

Ziel​

Bereitstellung direkter Links zu Stripe Checkout für das Frontend, damit das Unternehmen einen Abonnementplan auswählen und bezahlen kann.

Anwendungsfälle​

  • Anzeigen von Plan-Karten mit Abonnieren-Schaltflächen
  • Weiterleitung des Benutzers zu Stripe Checkout zur Zahlungsabwicklung
  • Präsentation eines Vergleichs verfügbarer Pläne mit ihren Preisen

Validierungsablauf​

flowchart TD
  A[Anfrage empfangen] --> 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[Pläne aus DB abrufen]
  F --> G[Stripe-Preise abrufen]
  G --> H[Checkout-Sitzungen pro Plan erstellen]
  H --> I[200 OK - Pläne + URLs]

Hinweise​

  • Erfordert JWT-Authentifizierung (bearerAuth)
  • Falls das Unternehmen stripe_customer hat, wird es der Sitzung zugeordnet
  • Falls kein stripe_customer vorhanden ist, wird die E-Mail aus invoice_data.email verwendet
  • Die Rückkehr-URL ist fest: ${HOST_FRONT}/admin/config
  • Abonnementmodus: subscription (keine Einmalzahlung)
  • Enthält client_reference_id mit Unternehmensreferenz

Request​

Responses​

Liste der Pläne mit Stripe-Checkout-URLs

Response Headers