Einen Kündigungsflow in Recurly einbauen

Ein Kündigungsflow ist der Schritt zwischen dem Klick eines Kunden auf „Kündigen” und der Kündigung selbst: nach dem Grund fragen, ein Angebot machen, das zur Antwort passt, und sauber kündigen, wenn er trotzdem gehen will. Dieser Ratgeber erklärt, wie die Kündigung in Recurly Subscriptions funktioniert, welche Halte-Tools Recurly bereits bietet und wie Sie einen eigenen Flow auf seiner API bauen.

Er hält sich an die eigene Dokumentation von Recurly: ein Abo ablaufen lassen oder kündigen, den Leitfaden zur Abo-Verwaltung, den Leitfaden zu Webhooks im Abo-Lebenszyklus, Abo-Benachrichtigungen, Hosted Account Management, Coupons, Abo ändern und Recurly Engage Cancel Save (alle abgerufen im November 2026). Recurly verkauft außerdem Recurly Commerce, ein eigenes Produkt mit eigenem Portal; dieser Ratgeber behandelt Recurly Subscriptions, sofern nicht anders angegeben.

Cancel, Terminate, Reaktivieren

Recurly unterscheidet zwei Arten, ein Abo zu beenden (ablaufen lassen oder kündigen).

	Cancel	Terminate
Wann es endet	Am nächsten Abrechnungsdatum (`timeframe: bill_date`) oder am Ende der Laufzeit (`timeframe: term_end`)	Sofort, mitten im Zyklus
Zustand	`canceled` bis `expires_at`, dann `expired`	Sofort `expired`
Zugang	Der Kunde behält den Zugang bis zum Ablauf	Endet jetzt
Erstattung	Nicht zutreffend	`none` (Standard), `partial` (anteilig für die verbleibende Zeit) oder `full` (die letzte Belastung)
Umkehrbar	Ja, Reaktivierung vor dem Ablauf	Nein

Zwei Details sind für einen Kündigungsflow wichtig:

Abrechnungsdatum vs. Laufzeitende. Bei einem Plan mit einer Laufzeit über mehrere Zeiträume stoppt bill_date beim nächsten Abrechnungsereignis, während term_end bis zum Ende der Laufzeit weiter abrechnet. Wählen Sie, was zu dem passt, was Sie dem Kunden bei der Anmeldung versprochen haben.
Reaktivierung. Ein gekündigtes Abo kann bis zu seinem Ablauf reaktiviert werden und verlängert sich dann am Ende des laufenden Zyklus wieder. Ist es abgelaufen, lässt es sich nicht reaktivieren, und es braucht ein neues Abo. In SCA-Regionen weist Recurly darauf hin, dass der Kunde seine gespeicherten Zahlungsdaten vor der Reaktivierung eventuell erneut authentifizieren muss.

Terminate erstattet außerdem nur die letzte Rechnung; ist diese Rechnung eine reine Gutschrift, ignoriert Recurly die Erstattungsanfrage. Für einen Kunden, der einfach aufhören will, nutzen Sie Cancel statt Terminate.

Wo Kunden heute kündigen

Hosted Account Management

Die gehosteten Kontoseiten von Recurly können einen Kündigen-Button enthalten. Laut Doku zu Hosted Account Management aktivieren Sie ihn in der Admin Console unter Configuration › Hosted Page Settings, „Cancel subscriptions” unter Customer Options. Kunden können dann direkt auf ihrer gehosteten Kontoseite kündigen. Die Doku von Recurly beschreibt auf diesem Weg keine Umfrage zum Grund.

Recurly Engage Cancel Save

Recurly verkauft ein eigenes Halte-Tool in Recurly Engage. Laut Leitfaden zu Cancel Save starten Sie von einem vorgefertigten Guide „Cancel Survey with Offers”, setzen einen CSS-Selektor auf Ihren Kündigen-Button als Auslöser und verzweigen die Antworten der Umfrage zu Aktionen: Das Beispiel von Recurly schickt „too expensive” zu einem Halteangebot und „technical issues” zum Support. Live Preview zeigt das Design, führt den Flow aber nicht aus, daher empfiehlt Recurly, mit einem Segment von Testnutzern zu testen. Laut Recurly ist die Integration mit Recurly.js, Hosted Account Management und Recurly Checkout automatisch aktiviert, und die Funktion ist möglicherweise nicht in den Plänen Starter oder Pro enthalten.

Recurly Commerce

Verkaufen Sie über Recurly Commerce statt Recurly Subscriptions, hat es Kündigungsflows, konfiguriert in seinem Customer Portal: eine mehrstufige Umfrage, eine Halteaktion pro Antwort (Rabatt, Pause, verlängertes Abo oder Support), einem Plan zugeordnet, bevor sie live geht.

Passt eines davon zu Ihrem Plan und Ihren Anforderungen, nutzen Sie es. Der Rest dieses Ratgebers ist für den Fall, dass Sie den Flow in Ihrer eigenen App wollen, mit eigenem Design und eigenen Angeboten.

Die Angebote, die die API von Recurly unterstützt

Coupon

Coupons bei Recurly können unbegrenzt, für eine einmalige Nutzung, für einen begrenzten Zeitraum oder für eine festgelegte Anzahl von Abrechnungszeiträumen gelten, und Recurly empfiehlt Coupons nach Abrechnungszeiträumen statt zeitbasierter. Für die Kundenbindung helfen zwei Optionen:

Eindeutige Codes in großer Zahl: Einmalcodes, in Batches erzeugt, damit ein Halteangebot nicht geteilt werden kann. Jeder Code kann standardmäßig einmal eingelöst werden.
Planbeschränkungen: Ein Coupon gilt standardmäßig für alle Pläne; beschränken Sie ihn auf die Pläne, bei denen das Angebot sinnvoll ist.

Planwechsel

Ein Downgrade ist eine Abo-Änderung, die sofort, zum nächsten Abrechnungsdatum oder zur Laufzeitverlängerung gelten kann. Recurly hält nur eine ausstehende Änderung; eine zweite ersetzt die erste. Bei „zu teuer” vermeidet eine Änderung zum nächsten Abrechnungsdatum eine überraschende anteilige Berechnung.

Pause

Recurly kann ein Abo ab dem nächsten Abrechnungsdatum für eine Anzahl von Abrechnungszyklen pausieren. Dafür gelten genug eigene Regeln (nur aktive Abos, Jahrespläne, Coupons, die weiterlaufen), dass wir es in Abos in Recurly pausieren behandeln. Eine Regel sollten Sie hier im Kopf behalten: Laut Recurly können Kunden nicht über Hosted Account Management pausieren, ein Pausenangebot muss also aus Ihrem eigenen Flow, Ihrem Support-Team oder dem Portal von Recurly Commerce kommen.

Den Flow bauen

„Kündigen” in Ihrer App auf Ihren Flow leiten. Zeigt auch Hosted Account Management einen Kündigen-Button, entscheiden Sie, ob Sie ihn behalten. Ihn zu behalten, ist ehrlich und einfach; es heißt nur, dass manche Kunden den Flow überspringen.
Nach dem Warum fragen. Eine kurze Liste von Gründen plus „Sonstiges”. Speichern Sie die Antwort mit der UUID des Abos.
Ein passendes Angebot zeigen. „Zu teuer”: ein Coupon nach Abrechnungszeiträumen oder ein günstigerer Plan zum nächsten Abrechnungsdatum. „Nutze es gerade nicht”: eine Pause. „Mir fehlt eine Funktion” oder „Etwas funktioniert nicht”: eine Antwort von einem Menschen.
„Jetzt kündigen” auf jedem Schritt sichtbar lassen. Ein Klick schließt die Kündigung ab, ohne dass zuerst ein Angebot angenommen werden muss.
Das Ergebnis über die API anwenden. Den Coupon anwenden, den Planwechsel planen, pausieren oder mit dem gewählten timeframe kündigen.
Das Enddatum bestätigen. Lesen Sie expires_at aus dem Abo, das Recurly zurückgibt, und zeigen Sie es.
Rückgängig machen anbieten. Bis das Abo abläuft, kann ein Button „Abo behalten” den Reactivate-Endpoint aufrufen.

Webhooks, auf die Sie hören sollten

Der Leitfaden zu Lebenszyklus-Webhooks beschreibt den Weg: Eine Kündigung sendet eine Benachrichtigung canceled; darauf folgt entweder reactivated, wenn der Kunde vor dem Ablauf zurückkommt, oder expired, wenn expires_at erreicht ist. Terminate und sofortige Erstattungen gehen direkt zu expired.

Die Seiten von Recurly verwenden mehr als eine Namenskonvention für diese Events: Die Seite zu Abo-Benachrichtigungen nutzt Event-Typen wie „canceled” und „expired”, während andere Seiten ältere Namen wie canceled_subscription_notification und expired_subscription_notification nutzen. Prüfen Sie die Namen in Ihren eigenen Payloads. Recurly empfiehlt außerdem, Webhooks als Hinweise zu behandeln: den aktuellen Zustand über die API bestätigen, Duplikate akzeptieren und Events behandeln, die in falscher Reihenfolge ankommen.

Den Flow messen

Der Export gekündigter Abos von Recurly hat eine Spalte expiration_reason (zum Beispiel Canceled oder Non-payment), die freiwilligen von unfreiwilligem Churn trennt. Kombinieren Sie sie mit den Gründen, die Ihr Flow gesammelt hat, und damit, wie viele Kunden jedes Angebot angenommen haben und einige Monate später noch Abonnenten waren.

So geht es mit NoChurn

NoChurn verbindet sich mit einem privaten API-Schlüssel mit Recurly und folgt seinen Webhooks. Es ergänzt einen Kündigungsflow mit Gründen, Angeboten, die zu einem Coupon, einer Pause oder einem Planwechsel am Recurly-Abo werden, und einem stets sichtbaren Kündigen-Button für einen Klick, gehostet oder headless über die API. Es sendet außerdem Win-back-Mails nach 30, 60 und 90 Tagen je nach Kündigungsgrund und berechnet einen Churn-Score von 0 bis 100. Rechnungsstellung, die Belastung selbst und Ihr Gateway bleiben in Recurly. NoChurn ist unter 300 $ MRR kostenlos, mit jeder Funktion in jedem Plan (Ihre eigene E-Mail-Domain ab 9 $). Siehe NoChurn + Recurly.