Einen Kündigungsflow zu Maxio hinzufügen

Ein Kündigungsflow sitzt zwischen dem Button „Kündigen” und der Kündigung: Er fragt nach dem Grund, macht ein passendes Angebot und kündigt sauber, wenn der Kunde trotzdem gehen möchte. Maxio Advanced Billing (früher Chargify) hat bereits mehrere der Bausteine: verzögerte Kündigung, Churn Reason Codes, Holds und geplante Produktwechsel. Dieser Ratgeber erklärt, wie sie funktionieren und wie Sie sie zu einem Flow zusammensetzen.

Er hält sich an die Dokumentation von Maxio: Abos kündigen, eine Abo-Kündigung planen, Abos im Billing Portal verwalten, Funktionen des Billing Portal konfigurieren, Churn Reason Codes, Szenarien für On Hold und Resume, Coupons auf Abos anwenden, die API-Referenzen Update Subscription und Initiate Delayed Cancellation sowie Beispiele für Webhook-Payloads (alle abgerufen im November 2026). Manche API-Beispiele von Maxio verwenden noch ältere Chargify-URLs; prüfen Sie die Endpunkte für Ihre Site.

Wie Kündigung in Maxio funktioniert

Maxio bietet drei Zeitpunkte (Abos kündigen):

Zeitpunkt	Was passiert
Sofort	Das Abo wird jetzt gekündigt
Zum Ende des Zeitraums	Es läuft im Status Pending Cancellation durch den bezahlten Zeitraum weiter und wird dann gekündigt
An einem geplanten Datum	Es wird an einem künftigen Datum gekündigt, das Sie oder der Kunde wählen (erfordert die Planungsfunktion)

In keinem Fall erstattet oder verrechnet Maxio automatisch anteilig. Für einen Kunden, der sich zum Gehen entschieden hat, ist das Ende des Zeitraums der faire Standard: Er behält, wofür er bezahlt hat.

Eine anstehende Kündigung lässt sich entfernen: Der Leitfaden von Maxio zum Bau eines eigenen Billing Portal nennt dafür einen eigenen Endpunkt. Über die API nimmt eine verzögerte Kündigung einen Reason Code und das Flag cancel_at_end_of_period entgegen; für das Planen eines Datums muss die Funktion Schedule Subscription Cancellation auf Ihrer Site aktiviert sein.

Manche Abos lassen sich nicht für eine Kündigung planen. Laut Maxio werden Prepaid-Abos immer sofort gekündigt, und Abos in Status wie Past Due, Expired oder Paused können nicht geplant werden (eine Kündigung planen). Ihr Flow muss diese Fälle behandeln.

Churn Reason Codes

Maxio hat eingebaute Churn Reason Codes. Sie erstellen, bearbeiten, sortieren und löschen sie in Ihren Site-Einstellungen, und sie erscheinen, wenn jemand über die Abo-Übersicht kündigt. Sobald auf Ihrer Site Codes konfiguriert sind, muss vor der Bestätigung einer Kündigung ein Grund gewählt werden. Wenn Codes genutzt werden, zeigt die Churn-Analyse von Maxio den Grund für jedes Churn-Ereignis. Nutzen Sie sie auch, wenn Sie Ihren eigenen Flow bauen: Senden Sie den Reason Code mit der Kündigung, damit die Reports von Maxio und Ihre übereinstimmen.

Das Billing Portal

Mit dem gehosteten Billing Portal von Maxio können Kunden unter Plan Details kündigen und zwischen sofortiger Kündigung und Kündigung zum Ende des Zeitraums wählen (Abos im Billing Portal). Sie steuern es mit eigenen Schaltern in den Funktionen des Billing Portal:

• Allow Immediate Cancellations
• Allow Delayed Cancellations (at end of period)
• Allow Scheduling Cancellations, damit Kunden ein künftiges Datum wählen können
• Display Churn Reason Codes, damit Kunden beim Kündigen einen Grund wählen

Das Portal fragt nach einer Bestätigung, und Maxio weist darauf hin, dass es nach diesem Schritt kein Rückgängig gibt. Was das Portal nicht tut, ist ein Angebot zu machen: Es erfasst einen Grund und kündigt. Wenn Sie einen Halteschritt möchten, setzen Sie ihn in Ihrer App vor das Portal, oder deaktivieren Sie die Kündigung im Portal und übernehmen Sie sie selbst. Wenn Sie die Kündigung im Portal aktiv lassen, ist es sinnvoll, nur die verzögerte Kündigung zu erlauben.

Die Angebote, die Maxio unterstützt

Hold (Pause)

Maxio nennt eine Pause Hold (Szenarien für On Hold und Resume). Während eines Holds finden keine Verlängerungen statt. Ein Hold kann ein Fortsetzungsdatum haben, und das Abo setzt sich dann von selbst fort (das Subscription-Objekt hat ein Feld automatically_resume_at). Nur ein aktives Abo kann auf Hold gesetzt werden. Ein Detail ist für Kündigungsflows wichtig: Ein Abo, das zum Ende des Zeitraums gekündigt werden sollte, wird während des Holds nicht gekündigt; es wird nach dem Fortsetzen gekündigt.

Der Leitfaden von Maxio nennt Endpunkte für Hold und Resume, aber die eigenen Seiten zeigen sie in zwei Pfadformen (mit und ohne /subscriptions/:id); prüfen Sie also die aktuelle API-Referenz, bevor Sie darauf aufbauen.

Coupon

Coupons von Maxio lassen sich einem bestehenden Abo hinzufügen (Coupons anwenden). Zwei Regeln aus der Dokumentation:

• Die Laufzeit des Coupons zählt ab der nächsten Verlängerung des Abos, nicht ab der Anmeldung.
• Ein Coupon gilt nur für Pläne in derselben Product Family.

Die gefundenen Seiten beschreiben das Hinzufügen eines Coupons in der Admin-Oberfläche; prüfen Sie in der API-Referenz von Maxio den Aufruf, den Sie aus Ihrer App verwenden werden.

Produktwechsel

Bei „zu teuer” ist ein günstigerer Plan oft besser als ein Rabatt. Maxio unterstützt einen verzögerten Produktwechsel (Update Subscription): Setzen Sie product_handle auf das neue Produkt und product_change_delayed auf true, und der Wechsel erfolgt bei der nächsten Verlängerung ohne anteilige Verrechnung. Wird ein leeres nächstes Produkt gesendet, wird ein geplanter Wechsel aufgehoben. Coupons am Abo werden nur übernommen, wenn sie auf den neuen Plan beschränkt oder unbeschränkt sind.

Den Flow bauen

1. Leiten Sie „Kündigen” in Ihrer App zu Ihrem Flow. Entscheiden Sie, was das Billing Portal erlaubt, damit Kunden nicht auf zwei verschiedene Kündigungserlebnisse stoßen.
2. Prüfen Sie, was für dieses Abo möglich ist. Prepaid-Abos werden sofort gekündigt; Past-Due- und pausierte Abos können nicht geplant werden. Ein Hold erfordert ein aktives Abo.
3. Fragen Sie nach dem Grund, mit derselben Liste wie Ihre Churn Reason Codes in Maxio.
4. Zeigen Sie ein passendes Angebot. „Zu teuer”: ein verzögerter Produktwechsel oder ein Coupon. „Nutze es gerade nicht”: ein Hold mit Fortsetzungsdatum. „Eine Funktion fehlt”: eine Antwort von einem Menschen.
5. Halten Sie „Jetzt kündigen” bei jedem Schritt sichtbar. Ein Klick schließt die Kündigung ab, ohne ein Angebot anzunehmen.
6. Setzen Sie das Ergebnis um. Verzögerte Kündigung mit Reason Code und cancel_at_end_of_period; oder der Hold, der Coupon oder der Produktwechsel.
7. Bestätigen Sie das Datum aus dem Abo, das Maxio zurückgibt, und bieten Sie an, eine anstehende Kündigung rückgängig zu machen, bis sie wirksam wird.

Webhooks, auf die Sie hören sollten

Aus den Payload-Beispielen und Webhook-Ereignissen von Maxio:

• subscription_state_change trägt state und previous_state: Nutzen Sie es, um zu sehen, wie ein Abo auf gekündigt, auf Hold oder zurück auf aktiv wechselt.
• pending_cancellation_change hat einen Beispiel-Payload mit cancel_at_end_of_period und delayed_cancel_at. Die gefundenen Seiten von Maxio sagen nicht genau, wann es auslöst; testen Sie es also auf Ihrer Site.

Maxio sagt, dass Webhooks asynchron sind, und rät, vor dem Aktualisieren Ihrer Datensätze zu prüfen, ob previous_state mit Ihrem Stand übereinstimmt, und im Zweifel das Abo über die API abzurufen.

So geht es mit NoChurn

NoChurn verbindet sich mit einem API-Schlüssel mit Maxio, importiert Kunden und Abos und folgt den Webhooks von Maxio. Es ergänzt einen Kündigungsflow mit Gründen, Angeboten, die am Maxio-Abo zu einem Coupon oder einem Produktwechsel werden, und einem immer sichtbaren Ein-Klick-Kündigungsbutton, gehostet oder headless über die API. Außerdem sendet es Win-back-E-Mails an Tag 30, 60 und 90 auf Basis des Kündigungsgrunds und berechnet einen Churn Score von 0 bis 100. Rechnungsstellung, Steuern, Ihre Produkte und die Belastung bleiben in Maxio und bei Ihrem Gateway. NoChurn ist kostenlos unter 300 $ MRR. Siehe NoChurn + Maxio.