Leitfaden für Abonnementstatus
Was sind Abonnementstatus?
Der Abonnementstatus zeigt genau an, wo sich ein Abonnement in seinem Lebenszyklus befindet. Sie sind Status-Updates, die dabei helfen zu verstehen, was mit dem Abonnement passiert.
API-Dokumentation
Alle Status sowie detailliertere und technische Informationen befinden sich in der API-Dokumentation.
Die Hauptstatus
🟡 AUSSTEHEND
Das Abonnement wurde erstellt und wartet darauf, aktiviert zu werden.
Was bedeutet das:
Das Angebot ist bereit zur Aktivierung, aber derzeit noch nicht aktiv
Es können ausstehende Rechnungen angezeigt werden, die bei Aktivierung bearbeitet werden
Es sind noch keine Leistungen aktiv
Wird oft vom Händler eingerichtet, bevor der Kunde weitere relevante Informationen wie die Zahlungsmethode angibt.
🟢 AKTIV
Das Abonnement ist aktiv und kann automatisch erneuert und auf Abruf abgerechnet werden.
Was bedeutet das:
Der Zugriff auf alle Leistungen ist aktiv
Automatische Verlängerungen sind aktiviert
Die Abrechnung erfolgt gemäß dem Plan
🆓 TESTPHASE
Das Abonnement befindet sich zunächst in einer Testphase.
❌ GEKÜNDIGT
Das Abonnement wird gekündigt und läuft am Ende des aktuellen Abrechnungszeitraums aus.
Eine Kündigung kann wie folgt eingestellt werden:
bei der Erstellung des Abonnements durch die Einstellung der automatischen Kündigung.
wenn das Abonnement im Kundenaccount bereits aktiv ist durch Klicken auf den Kündigen Button.
🚫NICHT VERLÄNGERT
Ein Abonnement kann in den folgenden Situationen als NICHT VERLÄNGERT angezeigt werden:
Das Abonnement ist nicht aktiv oder im Status "Ausstehend"
Es ist kein nächster Abrechnungszeitraum vorgesehen
Das Abonnement ist gekündigt und läuft aus
Das Abonnement hat ein bestimmtes Enddatum, das bereits erreicht ist.
Der Abonnementplan hat eine begrenzte Anzahl von Abrechnungszyklen, die bereits abgeschlossen sind.
Aktive Abonnements haben zusätzliche Sub-Status-Flags, die über die API verfügbar sind:
is_cancelled,in_trialundhas_started. Für detaillierte Informationen siehe API-Dokumentation.
⏸️ PAUSIERT
Das Abonnement ist vorübergehend pausiert.
Was bedeutet das:
Leistungen werden vorübergehend ausgesetzt
Während dieses Zeitraums erfolgt keine Rechnungsstellung
Kann reaktiviert werden, um die Leistungen wieder in Anspruch zu nehmen
Nach der Reaktivierung beginnt ein neuer Abrechnungszyklus.
🔴 ABGELAUFEN
Das Abonnement ist endgültig beendet.
Was bedeutet das:
Alle Leistungen wurden eingestellt
Kann nicht verlängert oder reaktiviert werden
Dies ist der Endzustand
Wie verändern sich Status?
VON | ZU | URSACHE |
|---|---|---|
Neu | 🟡 AUSSTEHEND | - Erstellt über API - Erstellt durch den Kunden über gehostete Seiten |
Neu | 🟢 AKTIV | - Erstellt über API - Erstellt über den Händler im Admin |
🟡 AUSSTEHEND | 🟢 AKTIV | - Erstellt durch den Kunden über gehostete Seiten - Erstellt über API |
🟢 AKTIV | ⏸️ PAUSIERT | - Pausiert über API oder Admin - Pausiert über das Mahnverfahren, wenn die endgültige Aktion die Abopause auslöst |
⏸️ PAUSIERT | 🟢 AKTIV | - Reaktiviert über API oder Admin |
🟢 AKTIV | 🔴 ABGELAUFEN | - Abgelaufen über API oder Admin oder durch den Kunden im Kundenportal - Abgelaufen im Mahnverfahren, wenn die letzte Aktion das Auslaufen des Abonnements ist |
Ereignisse, die im aktiven Zustand auftreten können
Auch wenn das Abonnement AKTIV bleibt, können wichtige Ereignisse eintreten:
EREIGNIS | BESCHREIBUNG |
|---|---|
subscription_payment_method_added | Dem Abonnement wurde zum ersten Mal eine Zahlungsmethode hinzugefügt |
subscription_payment_method_changes | Die Zahlungsmethode wurde für ein Abonnement mit einer bestehenden Zahlungsmethode geändert |
subscription_trial_end | Die Testphase für das Abonnement ist abgelaufen |
subscription_renewal | Es wurde eine Rechnung erstellt und ein neuer Abrechnungszeitraum für das Abonnement hat begonnen |
subscription_cancelled | Das Abonnement wurde gekündigt und läuft am Ende des aktuellen Abrechnungszeitraums aus |
subscription_uncancelled | Eine Kündigung wurde zurückgenommen |
subscription_changed | Die Laufzeit oder Preisgestaltung wurde geändert, z. B. durch einen geänderten Plan oder einen geänderten Beginn des nächsten Zeitraums |
Für weitere Abonnement-Ereignisse siehe unsere API-Dokumentation.