Skip to main content
Subscription Dunning sendet Kunden E-Mails, deren Abonnement nach einer fehlgeschlagenen Zahlung ausgelaufen ist oder die es gekündigt haben, und fordert sie auf, ihre Zahlungsmethode zu aktualisieren oder erneut zu kaufen. Nach der Aktivierung läuft der Prozess automatisch.

Was ist das Abo-Mahnverfahren?

Dunning erkennt, wenn ein Abonnement in einen wiederherstellbaren Status wechselt, und sendet eine E-Mail-Sequenz, die den Kunden zum Handeln auffordert. Drei Status starten eine Sequenz:
  • On Hold-Abonnements: Eine Verlängerungszahlung ist fehlgeschlagen, zum Beispiel wegen unzureichender Deckung oder einer abgelaufenen Karte.
  • Past Due-Abonnements: Eine Verlängerungszahlung ist fehlgeschlagen, während eine Kulanzfrist aktiv ist.
  • Cancelled-Abonnements: Der Kunde hat über das Customer Portal gekündigt.

Wie funktioniert das Mahnverfahren

1

Trigger

Ein Abonnement wechselt in einen der drei Status:
  • On Hold: Eine Verlängerungszahlung ist fehlgeschlagen.
  • Past Due: Eine Verlängerungszahlung ist fehlgeschlagen, während eine Kulanzfrist aktiv ist.
  • Cancelled: Der Kunde hat sein Abonnement über das Customer Portal gekündigt.
Dodo Payments erstellt anschließend einen Dunning-Versuch und sendet den Webhook dunning.started. Wenn die zugehörige Sequenz keine aktivierten E-Mails enthält, wird kein Versuch gestartet. Ein Abonnement kann höchstens einen aktiven Versuch gleichzeitig haben.
2

Grace Period

Wenn Sie eine Kulanzfrist festlegen, verschiebt eine fehlgeschlagene Verlängerung das Abonnement in past_due statt in on_hold.Die On Hold-E-Mail-Sequenz läuft während dieses Zeitraums. Der Kunde wird daher aufgefordert zu zahlen, solange er noch Zugriff hat.Eine fehlgeschlagene Zahlung startet eine Sequenz. Das Ende des Zeitraums startet keine zweite Sequenz. Endet der Zeitraum mit einem On Hold-Abonnement, werden die verbleibenden E-Mails der Sequenz weiterhin versendet. Endet er mit einem gekündigten Abonnement, wird der Versuch als exhausted markiert.Der Dunning-Versuch erfasst den Trigger-Status past_due. Filtern Sie beim Lesen der Dunning-Analysen sowohl nach past_due als auch nach on_hold.
3

Email Sequence

Je nach Trigger-Status sendet Dodo Payments bis zu vier Dunning-E-Mails mit den von Ihnen konfigurierten Verzögerungen. Jede E-Mail enthält einen Link zum Customer Portal, wo der Kunde seine Zahlungsmethode aktualisieren kann, oder zu einem Checkout, über den er ein gekündigtes Abonnement erneut kaufen kann.
4

Recovery

Wenn der Kunde seine Zahlungsmethode im Customer Portal aktualisiert, zieht Dodo Payments automatisch die ausstehenden Beträge ein. Wenn die Zahlung erfolgreich ist, wird das Abonnement reaktiviert und der Dunning-Versuch als recovered markiert.

Statuslebenszyklus

Jeder Dunning-Versuch hat einen der folgenden Status:
Wenn ein Dunning-Versuch als exhausted markiert wird, ändert Dodo Payments das Abonnement nicht. Es bleibt in seinem aktuellen Status (Past Due, On Hold oder Cancelled).

Dunning konfigurieren

Aktivieren und konfigurieren Sie Dunning unter Settings → Recovery in Ihrem Dashboard. Dunning ist standardmäßig deaktiviert.
Dunning settings page with enable toggle, four on-hold emails at 1, 3, 5, and 7 day intervals, and four cancelled emails at the same intervals

Dunning settings in the dashboard showing enable toggle, on-hold sequence, and cancelled sequence

E-Mail-Sequenzen

Dunning umfasst zwei E-Mail-Sequenzen, On Hold und Cancelled, mit jeweils bis zu vier E-Mails. Im Dashboard werden sie als Emails sent to customer when subscription is on hold und Emails sent to customer when subscription is cancelled aufgeführt. Ein past_due-Versuch verwendet die On Hold-Sequenz. Jede E-Mail verfügt über folgende Einstellungen: Unter Subject Line ersetzt Dodo Payments die folgenden Platzhalter: {store_name}, {store_owner_name}, {store_contact_email}, {subscription_id}, {failure_reason} und {payment_form_link}. Die standardmäßigen Verzögerungen sind:

Beispiel-E-Mails für Dunning

Dunning sendet für jeden Abonnementstatus eine andere E-Mail. Diese Beispiele zeigen, was der Kunde sieht.
Dunning email for an on-hold subscription showing store name, message about failed payment, subscription details with plan and amount, and an Update Payment Method button

Dunning email sent when a renewal payment fails and the subscription is on hold

Kundenerlebnis bei der Wiederherstellung

Wenn ein Kunde auf den Link in einer On Hold-Dunning-E-Mail klickt, wird das Customer Portal mit seinem Abonnement geöffnet. Dort kann er den Abonnementstatus einsehen und seine Zahlungsmethode aktualisieren.
Customer portal showing an on-hold subscription for Pro Plan at $95.00/year with an Update payment method button and a warning banner about the failed payment

Customer portal showing an on-hold subscription with option to update payment method

Nachdem der Kunde seine Zahlungsmethode aktualisiert hat, zieht Dodo Payments alle ausstehenden Beträge ein. Wenn die Zahlung erfolgreich ist, wechselt das Abonnement zurück zu active. Bei einem gekündigten Abonnement öffnet der Link eine Checkout-Seite, auf der sich das Produkt des Abonnements bereits im Warenkorb befindet.

Analysen

Verfolgen Sie die Dunning-Leistung unter Analytics → Recovery in Ihrem Dashboard.
Recovery analytics dashboard showing dunning entry counts, success rates, recovered revenue, and per-email performance breakdown

Recovery analytics dashboard showing ACR and dunning metrics

Der Bereich Dunning zeigt folgende Kennzahlen:

Webhook-Events

Dunning sendet zwei Webhook-Events:

Recovery Webhook Payloads

Sehen Sie sich die vollständigen Webhook-Payload-Schemas für Dunning-Events an.

Sonderfälle

Dunning verarbeitet folgende Fälle automatisch:

Best Practices

  • Mit den Standardwerten beginnen: Die standardmäßigen Verzögerungen (1, 3, 5 und 7 Tage) verteilen die E-Mails über eine Woche. So werden Kunden nicht überflutet, erhalten aber weiterhin regelmäßig Erinnerungen.
  • Wiederherstellungsraten überwachen: Prüfen Sie Recovery rate by email, um zu sehen, welche E-Mail die meisten Wiederherstellungen bewirkt. Wenn spätere E-Mails kaum Wiederherstellungen erzielen, deaktivieren Sie sie.
  • Mit dem Support abstimmen: Informieren Sie Ihr Support-Team darüber, dass Dunning-E-Mails versendet werden, damit es Kunden helfen kann, die antworten.
  • Abonnementstatus überprüfen: Kombinieren Sie Dunning mit den Webhooks subscription.on_hold und subscription.cancelled, um den vollständigen Lebenszyklus des Abonnements zu verfolgen.
Dunning arbeitet gemeinsam mit den bestehenden On Hold- und Reaktivierungsabläufen im Customer Portal. Nach der Aktivierung läuft der Prozess automatisch, ohne dass Integrationsaufwand erforderlich ist.

Verwandte Themen

Recovery Webhooks

Reagieren Sie auf die Events dunning.started und dunning.recovered.

Abandoned Cart Recovery

Gewinnen Sie abgebrochene oder fehlgeschlagene Checkouts mit Wiederherstellungs-E-Mails zurück.

Customer Portal

Kunden aktualisieren ihre Zahlungsmethoden im Customer Portal.

Subscriptions

Die Abonnementstatus, die Dunning auslösen.
Zuletzt geändert am 26. September 2026