Skip to main content
POST

Ü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

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

Antwortfelder

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

Fehlerantworten

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

Verhalten bei der Kündigung

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:

Antwort

Wie bei /subscriptions/cancel oben.