So ergänzen Sie GoCardless-Abos um einen Kündigungsflow

Ein Lastschriftkunde, der gehen will, hat zwei Auswege: Ihre App oder seine Bank. Wenn Ihre App es schwer macht, ist die Bank nur einen Anruf entfernt, und ein widerrufenes Mandat oder ein Erstattungsanspruch (Indemnity Claim) ist für beide Seiten ein schlechteres Ende als eine saubere Kündigung. Bei einem guten Kündigungsflow auf GoCardless geht es daher zum Teil darum, Kunden zu halten, und zum Teil darum, dass diejenigen, die gehen, es über Sie tun.

Dieser Ratgeber zeigt, was die Subscriptions-API von GoCardless erlaubt, wenn ein Kunde kündigen will, und wie Sie darauf einen kurzen Kündigungsflow bauen. Er hält sich an die Dokumentation von GoCardless: die Referenz der Subscriptions-API, die Referenz der Subscription-Events und den Entwicklerleitfaden Responding to mandate events (alle abgerufen im November 2026). Die Dokumentationsseite von GoCardless war aus unserer Rechercheumgebung nicht erreichbar, daher haben wir das Verhalten der Endpunkte anhand der offiziellen API-Clientbibliotheken von GoCardless geprüft, etwa gocardless-pro-ruby, die aus demselben API-Schema generiert werden und dieselben Beschreibungen enthalten.

Was GoCardless Ihnen bietet

Ein GoCardless-Abo erzeugt nach seinem Zeitplan Zahlungen auf einem Mandat. Sein status ist einer der folgenden:

Status	Bedeutung
pending_customer_approval	Wartet auf die Zustimmung des Kunden
customer_approval_denied	Der Kunde hat nicht zugestimmt
active	Erzeugt weiter Zahlungen
paused	Erzeugt keine Zahlungen
finished	Alle geplanten Zahlungen wurden erzeugt
cancelled	Erzeugt keine Zahlungen mehr

Die vier Aufrufe, die ein Kündigungsflow braucht:

Kündigen

POST /subscriptions/:id/actions/cancel kündigt das Abo sofort; es werden keine weiteren Zahlungen darunter erzeugt. Der Aufruf schlägt mit cancellation_failed fehl, wenn das Abo bereits gekündigt oder beendet ist.

Eine bereits erzeugte Zahlung kann nur storniert werden, solange ihr Status pending_submission ist (POST /payments/:id/actions/cancel). Sobald sie an die Banken übermittelt wurde, wird sie eingezogen oder schlägt von selbst fehl. Prüfen Sie anstehende Zahlungen, wenn Sie die Kündigung bestätigen, damit Sie nicht „keine weiteren Zahlungen“ versprechen, wenn bereits eine unterwegs ist.

Pausieren und fortsetzen

POST /subscriptions/:id/actions/pause verhindert, dass das Abo Zahlungen erzeugt:

• Ohne pause_cycles bleibt es pausiert, bis Sie resume aufrufen.
• Mit pause_cycles ist es für diese Anzahl von Zyklen pausiert, und upcoming_payments zeigt weiterhin die späteren Belastungsdaten.
• Es funktioniert für Abos, die unbegrenzt laufen oder eine feste Anzahl (count) von Zahlungen einziehen, nicht für solche mit einem end_date. Es schlägt mit subscription_cannot_be_paused fehl, wenn Pausieren nicht möglich ist.

POST /subscriptions/:id/actions/resume startet die Erzeugung von Zahlungen neu. Das Belastungsdatum der nächsten Zahlung ist das earliest_charge_date_after_resume des Abos.

Damit ist „Pausieren statt Kündigen“ auf GoCardless ein natives Angebot, was nicht bei jeder Zahlungsplattform der Fall ist.

Aktualisieren

PUT /subscriptions/:id ändert Felder wie den Betrag. GoCardless dokumentiert Grenzen, die für Rabattangebote wichtig sind:

• Der Aufruf schlägt mit number_of_subscription_amendments_exceeded fehl, wenn der Betrag bereits 10-mal geändert wurde.
• Er schlägt mit mandate_payments_require_approval fehl, wenn sich der Betrag ändert und das Mandat eine Zustimmung erfordert.
• Er schlägt mit subscription_not_active fehl, wenn das Abo nicht mehr aktiv ist.

Ein befristeter Rabatt kostet daher zwei Änderungen (herunter, dann wieder hinauf). Zählen Sie mit.

Das Mandat in Ruhe lassen

Die Kündigung eines Abos widerruft nicht das Mandat. Der Entwicklerleitfaden von GoCardless sagt, ein Mandat nur zu widerrufen, wenn der Kunde ausdrücklich darum gebeten hat. Wenn Sie es behalten, kann ein zurückkehrender Kunde neu starten, ohne eine neue Lastschrift einzurichten. Wenn der Kunde Sie bittet, die Lastschrift selbst zu widerrufen, tun Sie es und sagen Sie es in der Bestätigung.

Den Flow gestalten

1. Nach dem Grund fragen

Eine Frage, eine kurze Liste, ein Tippen:

• Zu teuer
• Nutze es nicht genug
• Habe es nur eine Zeit lang gebraucht
• Mir fehlt etwas
• Wechsle zu einem anderen Anbieter
• Sonstiges

Speichern Sie den Grund beim Kunden. Sie können ihn vor der Kündigung auch in die metadata des Abos schreiben, damit er beim GoCardless-Datensatz bleibt.

2. Ein Angebot, das zum Grund passt

Grund	Angebot	Auf GoCardless
Habe es nur eine Zeit lang gebraucht	Pause für 1 bis 3 Zyklen	pause mit pause_cycles
Zu teuer	Ein niedrigerer Preis für einige Monate	Betrag per update ändern, die Rückänderung einplanen (2 Änderungen)
Nutze es nicht genug	Ein günstigerer Plan	Betrag per update ändern, oder kündigen und ein neues Abo auf demselben Mandat anlegen
Mir fehlt etwas, wechsle	Kein Rabatt; nach Details fragen	Nichts zu ändern

Nennen Sie die genaue Wirkung, bevor der Kunde annimmt: bei einer Pause das Datum der nächsten Belastung; bei einem Rabatt den reduzierten Betrag, wie viele Zahlungen er abdeckt und den Betrag danach.

3. Kündigen, immer sichtbar

Der Kündigungsbutton gehört auf jeden Schritt, nicht hinter das Angebot. Ein Kunde, der das Angebot ablehnt, ist einen Klick von der Bestätigung entfernt, die sagt:

• dass das Abo gekündigt ist;
• ob eine bereits übermittelte Zahlung noch eingezogen wird, und an welchem Datum;
• bis wann er Zugang behält;
• ob das Lastschriftmandat bestehen bleibt (und wie er es ebenfalls widerrufen kann, wenn er will).

Der letzte Punkt ist bei Lastschriften wichtig. Ein Kunde, der bei seiner Bank noch ein Mandat aufgeführt sieht, widerruft es dort vielleicht „zur Sicherheit“. Das ist sein Recht, und es ist besser, wenn er weiß, dass es nicht nötig ist.

Die Anbindung

1. Laden Sie das Abo und seine anstehenden Zahlungen, wenn sich der Flow öffnet.
2. Verwenden Sie einen Idempotency Key bei Aufrufen von pause, resume und cancel (die offiziellen Clientbibliotheken von GoCardless behandeln Idempotenzkonflikte bei diesen Aktionen) und deaktivieren Sie Buttons nach dem ersten Klick.
3. Hören Sie auf Subscription-Events (siehe die Referenz der Events für die vollständige Liste der Aktionen), damit Ihre App synchron bleibt, wenn Änderungen aus dem Dashboard oder von GoCardless selbst kommen, zum Beispiel wenn ein Mandat widerrufen wird und seine Abos mit ihm.
4. Planen Sie die Folgeschritte, die Ihre Angebote brauchen: die Rückänderung auf den vollen Preis, das Ende einer unbefristeten Pause, eine Erinnerung, bevor ein pausiertes Abo wieder startet.
5. Protokollieren Sie jeden Schritt: Grund, gezeigtes Angebot, Antwort, Zeitpunkt der Kündigung. Wenn später ein Erstattungsanspruch eintrifft, hilft Ihnen diese Aufzeichnung zu verstehen, was schiefgelaufen ist.

Das Richtige messen

• Angenommene Angebote, nach Grund.
• Pausierte Abos, die fortgesetzt werden und drei Monate später noch zahlen.
• Kündigungen über Ihren Flow im Vergleich zu bei der Bank widerrufenen Mandaten. Wenn viele Kunden über ihre Bank gehen, ist die Kündigungsoption zu schwer zu finden.

Das mit NoChurn umsetzen

GoCardless behält das Abo, das Mandat und den Einzug. NoChurn ergänzt den Kündigungsflow: Gründe, ein Angebot passend zu jedem Grund und ein Ein-Klick-Kündigen, das immer sichtbar ist, von NoChurn gehostet oder mit der Headless-API in Ihre eigene Oberfläche eingebaut. Auf GoCardless beendet eine Kündigung das GoCardless-Abo, und das Mandat bleibt, wie der Kunde es wählt. Kündigungsgründe steuern Win-back-E-Mails an Tag 30, 60 und 90 und fließen in den Churn-Score ein. Siehe NoChurn + GoCardless.