Zum Hauptinhalt springen
POST
/
subscriptions
/
checkout
curl -X POST https://api.llmgenerator.com/api/v1/subscriptions/checkout \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "planId": "professional",
    "successUrl": "https://yourapp.com/subscription/success",
    "cancelUrl": "https://yourapp.com/pricing"
  }'

{
  "sessionId": "cs_test_a1b2c3d4e5f6g7h8i9j0",
  "url": "https://checkout.stripe.com/c/pay/cs_test_a1b2c3d4...",
  "plan": {
    "id": "professional",
    "name": "Professional",
    "monthlyCredits": 3000,
    "priceCents": 1299
  }
}

​
Ü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

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

​
Anfragetext

​
planId
string
erforderlich
Tarifkennung: einer von starter, professional, business oder agency.
​
billingCycle
string
Standard:"monthly"
Abrechnungsintervall: monthly oder yearly.
​
successUrl
string
URL nach erfolgreicher Zahlung. Standard: App-Dashboard.
​
cancelUrl
string
URL bei Abbruch der Zahlung. Standard: Preisseite.
curl -X POST https://api.llmgenerator.com/api/v1/subscriptions/checkout \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "planId": "professional",
    "successUrl": "https://yourapp.com/subscription/success",
    "cancelUrl": "https://yourapp.com/pricing"
  }'

{
  "sessionId": "cs_test_a1b2c3d4e5f6g7h8i9j0",
  "url": "https://checkout.stripe.com/c/pay/cs_test_a1b2c3d4...",
  "plan": {
    "id": "professional",
    "name": "Professional",
    "monthlyCredits": 3000,
    "priceCents": 1299
  }
}

​
Antwortfelder

​
sessionId
string
Stripe-Checkout-Sitzungs-ID. Später zur Verifikation nutzbar.
​
url
string
URL zur Zahlung. Stripe-gehostete Checkout-Seite.
​
plan
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

​
400
Ungültige Anfrage – Ungültige Tarif-ID oder Nutzer hat bereits ein aktives Abonnement.
​
401
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: 
Authorization: Bearer llmgen_your_api_key_here

​
Anfragetext

Wie bei /subscriptions/checkout oben.

​
Antwort

Wie bei /subscriptions/checkout oben. 
curl -X POST https://api.llmgenerator.com/api/v1/subscriptions/checkout/api \
  -H "Authorization: Bearer llmgen_your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "planId": "professional",
    "successUrl": "https://yourapp.com/subscription/success",
    "cancelUrl": "https://yourapp.com/pricing"
  }'