Zum Hauptinhalt springen
POST
/
subscriptions
/
portal
curl -X POST https://api.llmgenerator.com/api/v1/subscriptions/portal \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "returnUrl": "https://yourapp.com/settings/billing"
  }'

{
  "url": "https://billing.stripe.com/p/session/test_a1b2c3d4..."
}

​
Überblick

Erstellt eine Stripe-Customer-Portal-Sitzung. Nutzer können dort:
  • Zahlungsmittel aktualisieren
  • Rechnungshistorie einsehen
  • Abonnementtarife wechseln
  • Rechnungen herunterladen
  • Das Abonnement kündigen
Erfordert Sitzungsauthentifizierung (JWT-Access-Token).
Für Drittanbieter-Integrationen: Verwenden Sie POST /subscriptions/portal/api mit API-Schlüssel-Authentifizierung.

​
Authentifizierung

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

​
Anfragetext

​
returnUrl
string
URL nach Verlassen des Portals. Standard: App-Dashboard.
curl -X POST https://api.llmgenerator.com/api/v1/subscriptions/portal \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "returnUrl": "https://yourapp.com/settings/billing"
  }'

{
  "url": "https://billing.stripe.com/p/session/test_a1b2c3d4..."
}

​
Antwortfelder

​
url
string
URL zum Stripe-gehosteten Abrechnungsportal.

​
Portal-Funktionen

Im Stripe Customer Portal können Nutzer:
FunktionBeschreibung
ZahlungsmittelKarten hinzufügen, ändern oder entfernen
RechnungenVergangene Rechnungen anzeigen und herunterladen
TarifwechselAbonnement upgraden oder downgraden
KündigungAbonnement beenden
AbrechnungshistorieAlle Transaktionen einsehen

​
Fehlerantworten

​
400
Ungültige Anfrage – Kein Abrechnungskonto gefunden. Zuerst einen Kauf tätigen.
​
401
Nicht autorisiert – Ungültiges oder fehlendes Token.
Das Abrechnungsportal steht Nutzern zur Verfügung, die bereits gekauft haben oder ein aktives Abonnement besitzen. Neue Nutzer sollten den Checkout-Endpunkt verwenden.

​
POST /subscriptions/portal/api

Erstellt eine Stripe-Customer-Portal-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/portal oben.

​
Antwort

Wie bei /subscriptions/portal oben. 
curl -X POST https://api.llmgenerator.com/api/v1/subscriptions/portal/api \
  -H "Authorization: Bearer llmgen_your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "returnUrl": "https://yourapp.com/settings/billing"
  }'

​
Bewährte Praktiken

  • Link in den Einstellungen: Button „Abrechnung verwalten“ in den Kontoeinstellungen
  • Nach dem Checkout: Nach Abonnementabschluss Zugang zum Portal anbieten
  • Support: Portal als Self-Service für Abrechnungsfragen bereitstellen