Mahnwesen in Recurly einrichten
Wie Recurly fehlgeschlagene Zahlungen behandelt: Dunning-Kampagnen und -Zyklen, Intelligent Retries, Mahnmails, überfällige Rechnungen und Webhooks.
Von Florian
Recurly hat eines der vollständigeren eingebauten Mahnwesen unter den Abrechnungsplattformen für Abos. Retries, E-Mails, Aktionen am Ende des Zyklus und Abrechnungsseiten für Kunden sind alle eingebaut, und die meiste Arbeit besteht darin, vernünftige Einstellungen zu wählen und die richtigen Webhooks in Ihre App einzubinden. Dieser Ratgeber geht jeden Baustein durch und gibt Ihnen eine Einrichtungs-Checkliste, die Sie heute anwenden können.
Alles Recurly-Spezifische hier stammt aus der eigenen Dokumentation von Recurly: Dunning-Kampagnen, Intelligent Retries, statische Retries, Dunning 101: Mahnfenster verstehen, Hosted Account Management und die Webhook-Referenz (alle abgerufen im November 2026). Recurly verkauft außerdem ein eigenes Produkt, Recurly Commerce, mit eigenen Einstellungen fürs Mahnwesen; dieser Ratgeber behandelt Recurly Subscriptions.
Wie Recurly die Arbeit aufteilt: Retries und Mahnwesen
Recurly behandelt zwei Dinge getrennt:
- Retries entscheiden, wann eine abgelehnte Belastung erneut versucht wird.
- Mahnwesen entscheidet, was der Kunde hört, wie lange und was am Ende mit Rechnung und Abo passiert.
Beide laufen gleichzeitig auf derselben Rechnung, aber Sie konfigurieren sie an verschiedenen Stellen. Wenn Sie diese Aufteilung im Kopf behalten, lassen sich die übrigen Einstellungen leichter durchdenken.
Retries: Intelligent Retries und statische Retries
Intelligent Retries
Laut Dokumentation zu Intelligent Retries nutzt Recurly ein Machine-Learning-Modell, um zu wählen, wann abgelehnte wiederkehrende Kartenzahlungen erneut versucht werden. Es konzentriert sich auf Soft Declines (etwa fehlende Deckung). Die dokumentierten Grenzen:
- Retries enden bei insgesamt 20 Transaktionsversuchen oder 60 Tagen ab Rechnungserstellung, je nachdem, was zuerst eintritt.
- Intelligent Retries gilt nicht für Lastschriftverfahren wie ACH und SEPA. Recurly dokumentiert diese separat unter Retries bei Lastschriften.
- Hard Declines gelten in der Regel als endgültig und werden nicht automatisch erneut versucht, mit einigen dokumentierten Ausnahmen, zum Beispiel wenn der Kunde oder der Account Updater die Zahlungsdaten ändert.
Eine Sache sollten Sie in Ihrem eigenen Konto prüfen: Ein Changelog-Eintrag von Recurly vom August 2026 beschreibt, dass Soft Declines bis zu 20 Mal pro 30-Tage-Zeitraum erneut versucht werden, um den Regeln der Kartennetzwerke zu entsprechen. Diese Formulierung weicht vom 60-Tage-Fenster auf der Hauptseite ab, klären Sie also mit Recurly, welche Grenze für Sie gilt, bevor Sie sich auf eine davon verlassen.
Statische Retries
Recurly dokumentiert auch eine Option ohne ML, statische Retries, gesteuert über Ablehnungscodes des Gateways und Merchant Advice Codes. Sie enden nach 7 Transaktionsablehnungen, 20 Versuchen insgesamt oder 60 Tagen seit Rechnungserstellung, je nachdem, was zuerst eintritt, oder früher, wenn der Mahnzyklus zuerst endet.
Welche Logik Sie auch nutzen, Retries dauern nie länger als der Mahnzyklus. Ist Ihr Mahnfenster kurz, begrenzt es auch Ihre Retries.
Dunning-Kampagnen und -Zyklen
Eine Dunning-Kampagne ist das Regelwerk, das Recurly auf eine unbezahlte Rechnung anwendet. Jede Site hat eine Standardkampagne, und in berechtigten Plänen können Sie weitere Kampagnen erstellen und bestimmten Plänen oder Konten zuordnen. Die Seite zu Dunning-Kampagnen weist darauf hin, dass mehrere Kampagnen einen Plan Professional oder Elite erfordern. Kampagnen liegen unter Configuration, dann Dunning Management. Die Einstellungen des Mahnwesens sind versioniert, das Bearbeiten einer Kampagne ändert also keine Rechnungen, die schon im Mahnwesen sind.
Jede Kampagne enthält bis zu drei Zyklustypen, jeder mit eigenem Zeitplan und eigenen E-Mails:
| Zyklustyp | Gilt für | Standard-Mailvorlage |
|---|---|---|
| Payment Declined | Automatisch eingezogene Rechnungen, die fehlschlagen | Payment Declined |
| Invoice Past Due | Manuell eingezogene Rechnungen nach Ablauf ihres Zahlungsziels | Invoice Past Due |
| Post-Trial Payment Declined | Rechnungen, die direkt nach einem kostenlosen Test fehlschlagen | Post-Trial Payment Declined |
Bei manuellen Rechnungen beginnt der Mahnzeitraum am Tag, nachdem die Rechnung ihr Zahlungsziel überschritten hat.
Wie lang sollte ein Zyklus sein?
Der Leitfaden zu Mahnfenstern von Recurly empfiehlt:
- Monatliche Abrechnung: ein Fenster von 27 Tagen, damit der Zyklus vor der nächsten Rechnung endet, selbst im Februar.
- Vierteljährliche und jährliche Abrechnung: etwa 60 Tage.
- Wöchentliche Abrechnung: 7 Tage.
Das sind Empfehlungen, keine festen Grenzen. Die Idee dahinter ist richtig: Dauert ein monatlicher Zyklus länger als einen Monat, kommt eine zweite Rechnung auf die erste, und Sie laufen nun zwei unbezahlten Rechnungen eines Kunden hinterher, der vielleicht nie zurückkommt.
Was am Ende des Zyklus passiert
Für jeden Zyklus wählen Sie, was mit Rechnung und Abo passiert, wenn der Kunde nicht bezahlt hat. Standardmäßig markiert Recurly die Rechnung als failed. Sie können das Abo auch ablaufen lassen, es aktiv lassen oder festlegen, dass Rechnungen nie automatisch fehlschlagen, wodurch sie unbegrenzt überfällig bleiben.
Einige Verhaltensweisen aus den Support-Artikeln von Recurly, die Teams oft überraschen:
- Abo-Zustand und Rechnungszustand sind getrennt. Ein Abo kann aktiv sein, während seine Rechnung überfällig ist (Support-Artikel). Machen Sie Zugangsentscheidungen auch von der Rechnung abhängig, nicht nur vom Abo.
- Eine fehlgeschlagene Rechnung kündigt das Abo nicht. Soll die Abrechnung aufhören, kündigen Sie das Abo separat (Support-Artikel).
- Die Kündigung eines Abos stoppt das Mahnwesen bei offenen Rechnungen nicht. Nutzen Sie dafür Stop Collection an der Rechnung (Support-Artikel).
- In der Konfiguration des Mahnwesens gibt es keine eingebaute Pausenoption.
Mahnmails
Jeder Schritt eines Zyklus kann eine E-Mail senden. Recurly liefert Basisvorlagen (Payment Declined, Invoice Past Due, Post-Trial Payment Declined und Subscription Expired for Non-Payment), die sich nicht löschen lassen, und Sie können eigene erstellen und Schritten einer Kampagne zuordnen.
Die Standardmail Payment Declined verlinkt den Kunden bereits auf seine Hosted-Account-Management-Seite. Jedes Konto hat zwei gehostete URLs: eine Account Management URL, die den Kunden anmeldet, und eine Edit Billing Information URL, die nur das Zahlungsformular öffnet. Hosten Sie Ihre eigene Abrechnungsseite, können Sie die Vorlage so bearbeiten, dass sie stattdessen dorthin verweist, mit dem Hosted-Login-Token des Kontos aus der API.
Ein vernünftiger E-Mail-Plan für eine monatliche Kampagne:
| Tag | Ziel | |
|---|---|---|
| 0 | Zahlung abgelehnt | Informieren, ein klarer Link zur Aktualisierung der Zahlungsdaten |
| 3 | Erinnerung | Den Link wiederholen, sagen, was als Nächstes passiert |
| 10 | Erinnerung | Kurz, erwähnen, dass der Zugang gefährdet ist |
| 20 | Letzter Hinweis | Das genaue Datum nennen, an dem das Abo endet |
| Ende | Wegen Nichtzahlung abgelaufen | Das Ende bestätigen, einen Weg zurück anbieten |
Halten Sie jede E-Mail kurz und auf den Abrechnungslink fokussiert. Wiederholen Sie dem Kunden gegenüber nicht den rohen Ablehnungsgrund.
Aktualisierte Zahlungsdaten lösen einen sofortigen Retry aus
Das ist eines der nützlichsten eingebauten Verhalten. Laut Doku von Recurly versucht Recurly, wenn ein Kunde seine Zahlungsdaten aktualisiert, den Einzug aller überfälligen Rechnungen dieses Kontos erneut. Das gilt auch für Hard Declines: Eine neue Karte ist das eine Ereignis, das einen erneuten Versuch bei einer hart abgelehnten Rechnung lohnt. Bei Lastschriften setzt der Wechsel zu einem neuen Bankkonto den Retry-Zähler zurück.
In der Praxis heißt das, dass Ihre Mahnmails keinen separaten Schritt „jetzt bezahlen” brauchen. Den Kunden zum Zahlungsformular zu bringen, ist die ganze Aufgabe.
Webhooks, auf die Sie hören sollten
Die Webhook-Referenz und die Doku zum Mahnwesen von Recurly nennen die Events, die während des Mahnwesens zählen. Welche Sie erhalten, hängt von der Konfiguration Ihrer Site ab:
| Event | Wann es ausgelöst wird | Was Sie in Ihrer App tun |
|---|---|---|
failed_payment |
Nach jeder fehlgeschlagenen Zahlung | Das Konto markieren, ein Banner in der App zeigen |
successful_payment |
Nach einer erfolgreichen Zahlung | Die Markierung aufheben, den Zugang wiederherstellen |
new_dunning_event |
Wenn Rechnungen ins Mahnwesen eintreten und darin bleiben | Den Mahnstatus pro Konto verfolgen |
charge_invoice.past_due |
Eine Belastungsrechnung wird überfällig (Sites mit Gutschriftsrechnungen) | Gegebenenfalls eigene Erinnerungen starten |
charge_invoice.failed |
Eine Belastungsrechnung schlägt fehl, direkt oder am Ende des Mahnwesens | Über den Zugang entscheiden, Erinnerungen stoppen |
subscription_expired |
Recurly lässt ein Abo ablaufen, auch wegen Nichtzahlung | Den Zugang entfernen |
Sites ohne Gutschriftsrechnungen erhalten stattdessen die älteren Rechnungsbenachrichtigungen von Recurly, mit anderen Namen. Prüfen Sie, welchen Satz Ihre Site sendet, bevor Sie Ihre Handler schreiben.
Eine Einrichtungs-Checkliste
- Ihre Retry-Logik wählen. Intelligent Retries für die meisten Kartengeschäfte; prüfen Sie, wie Lastschriften erneut versucht werden, wenn Sie ACH oder SEPA akzeptieren.
- Die Zykluslänge nach Abrechnungsfrequenz festlegen. Starten Sie mit den Empfehlungen von Recurly: 27 Tage (monatlich) und 60 Tage (jährlich).
- Die Aktion am Ende des Zyklus bewusst wählen. Entscheiden Sie, ob das Abo abläuft oder aktiv bleibt und ob Rechnungen fehlschlagen. Halten Sie es schriftlich fest, damit der Support es weiß.
- Die E-Mails schreiben. Ein Link pro E-Mail, zur Seite Edit Billing Information oder zu Ihrem eigenen Zahlungsformular.
- Eine Kampagne nach dem Test hinzufügen, wenn Sie kostenlose Tests anbieten. Die erste Belastung nach einem Test scheitert anders als eine Verlängerung: Der Kunde hat Sie noch nie bezahlt.
- Die Webhooks einbinden. Machen Sie den Zugang vom Rechnungszustand abhängig, nicht nur vom Abo-Zustand.
- Ein Banner in der App ergänzen für eingeloggte Kunden mit überfälliger Rechnung. E-Mails übersieht man leicht; das Produkt nicht.
- Monatlich prüfen. Sehen Sie sich Rechnungen an, die am Ende des Mahnwesens fehlgeschlagen sind, und die Ablehnungscodes dahinter.
So geht es mit NoChurn
Die eingebauten Retries und das Mahnwesen von Recurly sind solide, und NoChurn ersetzt sie nicht: Retries, Rechnungsstellung und die Belastung selbst bleiben in Recurly. NoChurn verbindet sich mit einem Recurly-API-Schlüssel, folgt den Recurly-Webhooks und ergänzt von der KI geschriebene Mahnmails, die Sie vor dem Versand prüfen, mit einem Link, über den der Kunde seine Zahlungsdaten aktualisiert. Es deckt außerdem ab, was das Mahnwesen nicht abdeckt: Kündigungsflows mit Gründen und Angeboten (ein Coupon, eine Pause oder ein Planwechsel am Recurly-Abo) und einem stets sichtbaren Kündigen-Button für einen Klick, Win-back-Mails nach 30, 60 und 90 Tagen je nach Kündigungsgrund und einen Churn-Score von 0 bis 100. Chargebacks kommen vom Gateway hinter Recurly; mit Stripe oder Braintree sammelt NoChurn die Nachweise und entwirft eine Antwort, die Sie prüfen. Siehe NoChurn + Recurly.