So fügen Sie Chargebee einen Kündigungsflow hinzu

Chargebee gibt Ihnen viel Kontrolle darüber, wie ein Abo endet: wann die Kündigung wirksam wird, was mit Guthaben passiert, ob ein Grund verlangt wird und ob Kunden es selbst tun können. Was Chargebee standardmäßig nicht bietet, ist ein Flow: eine kurze Abfolge, die fragt, warum der Kunde geht, und etwas Nützliches anbietet, bevor er geht.

Dieser Ratgeber zeigt, wie die Kündigung in Chargebee Billing funktioniert, welche Einstellungen zählen und wie Sie darauf einen fairen Kündigungsflow bauen, entweder mit Chargebees eigenem Retention-Produkt oder mit Ihrer eigenen Seite und der API. Er hält sich an Chargebees Dokumentation: Subscription Cancellation, das Self-Serve Portal, Reason Codes, die API Cancel a subscription, die Ereignistypen und den Anwendungsfall Targeted Offers von Chargebee Growth (alle abgerufen im November 2026).

Wie die Kündigung in Chargebee funktioniert

Standardwerte für die ganze Site

Chargebees Dokumentation zur Kündigung verortet die Standardwerte unter Settings › Configure Chargebee › Billing LogIQ › Customers & Subscriptions › Subscription cancellation. Dort legen Sie fest:

Wann sie wirksam wird: sofort, zum Ende der aktuellen Laufzeit, zu einem bestimmten Datum oder zum Ende des Abrechnungszeitraums.
Was mit ungenutzter Zeit passiert: wie Guthaben behandelt werden.
Überschreibungen: „Allow overriding via Chargebee interface” erlaubt Ihrem Team, den Standard im Einzelfall zu ändern, und „Add condition to this rule” lässt das Verhalten je nach Kanal abweichen (Weboberfläche, API, Self-Serve Portal, geplante Kündigungen).

Zum Laufzeitende: non-renewing

Wenn eine Kündigung zum Laufzeitende geplant ist, endet das Abo nicht sofort. Laut API Cancel a subscription wird sein Status non_renewing, und die verbleibenden Abrechnungszyklen fallen auf 0. Es wird dann zum Laufzeitende gekündigt. Chargebee sendet subscription_cancellation_scheduled, wenn die Kündigung geplant wird, eine subscription_cancellation_reminder 6 Tage vor dem Wirksamwerden und subscription_cancelled, wenn sie wirksam wird (Ereignistypen).

Ein Abo im Status non-renewing lässt sich noch halten. Chargebee hat genau dafür eine Operation „Remove scheduled cancellation”.

Vertragslaufzeiten

Für Abos mit Vertragslaufzeit sagt die Dokumentation zur Kündigung, dass eine Kündigung über das Self-Serve Portal nur zum Ende der Vertragslaufzeit erfolgt. In der API nutzen diese Abos contract_term_cancel_option statt cancel_option.

Kunden selbst kündigen lassen

In den Einstellungen des Self-Serve Portal schaltet „Allow customers to cancel subscription” die Selbstkündigung ein. Sie wählen, wann sie wirksam wird: sofort, zum Laufzeitende, oder Sie lassen die Kunden wählen (dann können sie auch ein Datum innerhalb des Abozeitraums wählen). Derselbe Bereich enthält optional das Einholen von Feedback, die Reaktivierung und das Entfernen geplanter Kündigungen.

Schalten Sie es ein. Wenn Kunden zum Kündigen dem Support schreiben müssen, entsteht Reibung, die sich als Chargebacks und verärgerte Bewertungen zeigt, und vielerorts erwartet das Gesetz inzwischen, dass Kündigen so einfach ist wie Anmelden.

Reason Codes

Chargebee hat eine native Liste von Kündigungsgründen. Sie konfigurieren sie unter Settings › Configure Chargebee › Reason Codes › Subscriptions › Subscription Cancellation (Reason Codes). Die Codes erscheinen dann als Auswahl, wenn ein Abo über die Chargebee-Oberfläche oder das Self-Serve Portal gekündigt wird, und Sie können sie zur Pflicht machen.

In der API nimmt der Endpunkt Cancel a subscription cancel_reason_code entgegen: einen String mit Beachtung der Groß- und Kleinschreibung, bis zu 100 Zeichen, der einem der konfigurierten Codes entsprechen muss und übergeben werden muss, wenn Sie Gründe zur Pflicht gemacht haben.

Halten Sie die Liste kurz und umsetzbar. Sechs bis acht Gründe, die jeweils zu einer anderen Reaktion führen, sind besser als zwanzig, die niemand liest:

Reason Code	Was Sie anbieten können
Zu teuer	Ein Rabatt für einige Monate oder ein günstigerer Plan
Nutze es zu wenig	Eine Pause oder ein kleinerer Plan
Pause / saisonal	Eine Pause mit Datum zur Wiederaufnahme
Fehlende Funktion	Nichts zu verkaufen; erfassen Sie es und sagen Sie, ob es geplant ist
Wechsel zu einem anderen Tool	Nichts; fragen Sie, wofür sie sich entschieden haben, und lassen Sie sie gehen
Technische Probleme	Ein schneller Weg zum Support
Sonstiges	Freitext

Den Flow bauen

Option 1: Chargebees eigenes Retention-Produkt

Chargebee bietet Angebote auf der Kündigungsseite über Chargebee Growth an (das das früher Chargebee Retention genannte Produkt übernommen hat). Der Anwendungsfall Targeted Offers beschreibt drei Angebote auf einer Kündigungsseite: einen Rabatt (verknüpft mit einem Gutschein in Chargebee Billing), eine Pause und ein Plan-Downgrade, die bei Annahme durch den Kunden in Billing angewendet werden. Er weist auch darauf hin, dass Abonnenten ohne gespeicherte Zahlungsmethode die Änderung nicht abschließen oder nach einer Pause nicht automatisch fortfahren können. Wenn Sie Growth schon bezahlen, beginnen Sie dort.

Option 2: Ihre eigene Seite und die API

Wenn Sie lieber Ihre eigene Seite wollen, liegen alle Bausteine in Chargebee Billing:

Fangen Sie den Kündigungsbutton in Ihrer App ab. Zeigen Sie Ihre eigene Seite, bevor irgendetwas gekündigt wird.
Fragen Sie nach dem Grund. Eine Frage, mit Ihren Chargebee-Reason-Codes als Optionen.
Zeigen Sie ein Angebot, das zum Grund passt, oder keines. Nutzen Sie einen Gutschein für Rabatte, die Pause-API für Pausen oder einen Planwechsel.
Halten Sie „Mein Abo kündigen” bei jedem Schritt sichtbar. Ein Klick, keine zusätzlichen Bildschirme.
Kündigen Sie mit dem Grund. Rufen Sie den Cancel-Endpunkt mit cancel_option auf end_of_term (oder contract_term_cancel_option bei Vertragsabos) und dem cancel_reason_code auf. Beachten Sie, dass end_of_term als Boolean zugunsten von cancel_option veraltet ist.
Bestätigen Sie klar. Zeigen Sie das Enddatum und senden Sie eine Bestätigungsmail.
Bieten Sie einen Weg zurück. Bis zum Enddatum ein Button „Mein Abo behalten”, der die geplante Kündigung entfernt.

Den Grund nach der Kündigung nutzen

Chargebee weist darauf hin, dass cancel_reason_code beim Abrufen von Abos im Status non-renewing standardmäßig womöglich nicht zurückgegeben wird; eine Einstellung auf Site-Ebene schließt ihn ein, sodass Sie auf den Grund reagieren können, bevor die Kündigung ausgeführt wird (Subscription Cancellation). Schalten Sie sie ein, wenn Sie in der verbleibenden Laufzeit grundbasierte Erinnerungen wollen.

Fairnessregeln, die sich lohnen

Die Kündigung ist immer einen Klick entfernt. Ein Angebot ist eine Wahl, keine Schranke.
Nicht mehr als ein Angebot. Ein zweites Angebot nach einem „Nein” fühlt sich wie Feilschen an.
Fragen Sie nicht zweimal nach dem Grund. Wenn der Kunde auf Ihrer Seite geantwortet hat, geben Sie die Antwort weiter; lassen Sie ihn nicht im Portal erneut wählen.
Setzen Sie die Kündigung sofort um. Lehnt er das Angebot ab, kündigen Sie, bestätigen Sie und hören Sie auf.

Messen

Verfolgen Sie pro Grund: wie viele Kunden die Kündigungsseite erreicht haben, wie viele ein Angebot angenommen haben und wie viele davon 90 Tage später noch zahlten. Eine Rettung, die einen Monat später kündigt, ist ein Aufschub, keine Rettung. Chargebees Ereignisse subscription_cancellation_scheduled und subscription_cancelled liefern Ihnen zusammen mit den eigenen Protokollen Ihrer Seite alle drei Zahlen.

Umsetzung mit NoChurn

Die Kündigung selbst bleibt in Chargebee: NoChurn ruft Chargebee auf, um zu kündigen, zu pausieren oder ein Angebot anzuwenden, und Chargebees Portal funktioniert weiter wie konfiguriert. NoChurn liefert den Flow: Gründe, ein Angebot pro Grund (Rabatt, Pause oder Planwechsel) und ein Kündigen per Klick, das bei jedem Schritt sichtbar ist, gehostet oder headless über die API. Die Antworten speisen einen Churn-Score von 0 bis 100 und Win-back-Mails an Tag 30, 60 und 90 je nach Grund. Siehe NoChurn + Chargebee.