Skip to main content
POST

Überblick

Erstellt eine Stripe-Checkout-Sitzung für ein Abonnement und liefert eine URL, zu der Sie den Nutzer zur Zahlung weiterleiten. Erfordert Sitzungsauthentifizierung (JWT-Access-Token).
Für Drittanbieter-Integrationen: Verwenden Sie POST /subscriptions/checkout/api mit API-Schlüssel-Authentifizierung.

Authentifizierung

string
erforderlich
JWT-Access-Token. Format: Bearer YOUR_ACCESS_TOKEN

Anfragetext

string
erforderlich
Tarifkennung: einer von starter, professional, business oder agency.
string
Standard:"monthly"
Abrechnungsintervall: monthly oder yearly.
string
URL nach erfolgreicher Zahlung. Standard: App-Dashboard.
string
URL bei Abbruch der Zahlung. Standard: Preisseite.

Antwortfelder

string
Stripe-Checkout-Sitzungs-ID. Später zur Verifikation nutzbar.
string
URL zur Zahlung. Stripe-gehostete Checkout-Seite.
object
Details des gewählten Tarifs.

Checkout-Ablauf

  1. Sitzung erstellen: Endpunkt mit gewünschtem Tarif aufrufen
  2. Nutzer weiterleiten: Zu der zurückgegebenen url navigieren
  3. Zahlung: Nutzer schließt bei Stripe ab
  4. Webhook: Stripe benachrichtigt Ihren Webhook-Endpunkt
  5. Erfolgs-Redirect: Nutzer wird zu successUrl geleitet
  6. Optional prüfen: Status über /subscriptions/current

Fehlerantworten

Ungültige Anfrage – Ungültige Tarif-ID oder Nutzer hat bereits ein aktives Abonnement.
Nicht autorisiert – Ungültiges oder fehlendes Token.
Hat der Nutzer bereits ein aktives Abonnement, sollte der Tarifwechsel über das Abrechnungsportal (/subscriptions/portal) erfolgen.

POST /subscriptions/checkout/api

Erstellt eine Stripe-Checkout-Sitzung mit API-Schlüssel-Authentifizierung. Geeignet für Drittanbieter-Integrationen.

Authentifizierung

API-Schlüssel erforderlich. Übergeben Sie ihn im Header Authorization:

Anfragetext

Wie bei /subscriptions/checkout oben.

Antwort

Wie bei /subscriptions/checkout oben.