Zum Hauptinhalt springen
POST
/
subscriptions
/
cancel
curl -X POST https://api.llmgenerator.com/api/v1/subscriptions/cancel \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN"
{
  "success": true,
  "message": "Subscription cancelled successfully",
  "cancellationDate": "2024-02-15T00:00:00Z"
}

Überblick

Kündigt das Abonnement des Nutzers. Es bleibt bis zum Ende der aktuellen Abrechnungsperiode aktiv und verlängert sich nicht. Erfordert Sitzungsauthentifizierung (JWT-Access-Token).
Für Drittanbieter-Integrationen: Verwenden Sie POST /subscriptions/cancel/api mit API-Schlüssel-Authentifizierung.
Die Kündigung wird zum Periodenende wirksam. Der Zugang bleibt bis currentPeriodEnd bestehen. Für eine sofortige Beendigung nutzen Sie das Abrechnungsportal.

Authentifizierung

Authorization
string
erforderlich
JWT-Access-Token. Format: Bearer YOUR_ACCESS_TOKEN
curl -X POST https://api.llmgenerator.com/api/v1/subscriptions/cancel \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN"
{
  "success": true,
  "message": "Subscription cancelled successfully",
  "cancellationDate": "2024-02-15T00:00:00Z"
}

Antwortfelder

success
boolean
Ob die Kündigung erfolgreich geplant wurde.
message
string
Für Menschen lesbare Statusmeldung.
cancellationDate
string
ISO-8601-Zeitpunkt des Abonnementendes (nur bei Erfolg).

Fehlerantworten

400
Ungültige Anfrage – Kein aktives Abonnement oder Kündigung per API nicht möglich.
401
Nicht autorisiert – Ungültiges oder fehlendes Token.

Verhalten bei der Kündigung

SzenarioVerhalten
Aktives AbonnementZur Kündigung zum Periodenende vorgemerkt
Bereits gekündigtFehler
Kein AbonnementFehler
Keine Stripe-Abonnement-IDFehler (Kündigung per API nicht möglich)

Reaktivierung

Nutzer können:
  1. Das Abrechnungsportal (/subscriptions/portal) nutzen
  2. Nach Ende des aktuellen Abonnements ein neues abschließen

Bewährte Praktiken

  • Bestätigungsdialog: Vor der Kündigung immer bestätigen lassen
  • Grund erfassen: Feedback einholen, warum gekündigt wird
  • Retention: Rabatt oder Pausenoption erwägen
  • Klare Kommunikation: Ende des Zugangs transparent angeben

POST /subscriptions/cancel/api

Kündigt das Abonnement 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

Antwort

Wie bei /subscriptions/cancel oben.
curl -X POST https://api.llmgenerator.com/api/v1/subscriptions/cancel/api \
  -H "Authorization: Bearer llmgen_your_api_key_here"