Abonnements
Abonnement kündigen
Das aktive Abonnement zum Ende der laufenden Abrechnungsperiode kündigen.
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.Authentifizierung
JWT-Access-Token. Format:
Bearer YOUR_ACCESS_TOKENAntwortfelder
Ob die Kündigung erfolgreich geplant wurde.
Für Menschen lesbare Statusmeldung.
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
| Szenario | Verhalten |
|---|---|
| Aktives Abonnement | Zur Kündigung zum Periodenende vorgemerkt |
| Bereits gekündigt | Fehler |
| Kein Abonnement | Fehler |
| Keine Stripe-Abonnement-ID | Fehler (Kündigung per API nicht möglich) |
Reaktivierung
Nutzer können:- Das Abrechnungsportal (
/subscriptions/portal) nutzen - 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 HeaderAuthorization:
Antwort
Wie bei/subscriptions/cancel oben.