Zum Hauptinhalt springen
Payment Retries versuchen automatisch fehlgeschlagene Abonnement-Verlängerungszahlungen in einem progressiven Back-off-Zeitplan erneut. Wenn ein Versuch erfolgreich ist, wird das Abonnement automatisch reaktiviert — keine Kundenaktion oder Integrationsarbeit erforderlich.

Was sind Wiederholungsversuche für Zahlungen?

Wenn eine Abonnementverlängerungszahlung fehlschlägt, wird das Abonnement inaktiviert. Mit aktivierten Wiederholungsversuchen bei Zahlungen belastet Dodo Payments die bestehende Zahlungsmethode des Kunden automatisch in einem intelligenten Zeitplan erneut, bis die Zahlung erfolgreich ist oder das Wiederherstellungsfenster geschlossen wird. Dies stellt Einnahmen wieder her, die durch vorübergehende Fehler verloren gingen — abgelaufene Karten, unzureichende Mittel, die wieder aufgeladen werden, vorübergehende Netzwerkfehler — ohne den Kunden zu benachrichtigen oder ihn zu bitten, etwas zu aktualisieren.
Wiederholungsversuche für Zahlungen gelten nur für Abonnement-Verlängerungszahlungen. Erstzahlungen (Mandatsanzahlung), Einmalzahlungen, Planänderungsgebühren und bedarfsgesteuerte Gebühren werden von dieser Funktion nicht erneut versucht.

Wie funktionieren Wiederholungsversuche für Zahlungen?

1

Renewal fails

Eine Abonnementverlängerungszahlung schlägt fehl und das Abonnement wechselt in den Zustand on_hold.
2

Retryability check

Der Fehlercode des Fehlers wird überprüft. Soft Declines (unzureichende Mittel, allgemeiner Rückgang, Verarbeitungs- oder Netzwerkfehler usw.) sind erneut versuchbar. Hard Declines beenden die Wiederholkette sofort, da erneutes Versuchen das Ergebnis nicht ändern wird.
3

Scheduled retry

Wenn der Rückgang erneut versuchbar ist und das Wiederherstellungsfenster dies zulässt, wird der nächste Versuch geplant. Wiederholungen werden außerhalb der Sitzung mit der bestehenden Zahlungsmethode des Kunden gemäß einem progressiven Back-off-Zeitplan ausgeführt.
4

Recovery

Beim ersten erfolgreichen Wiederholungsversuch kehrt das Abonnement zu active zurück und das nächste Abrechnungsdatum wird wie gewohnt fortgesetzt. Wenn das Fenster geschlossen wird, bevor ein Versuch erfolgreich ist, stoppen die Wiederholungen und das Abonnement bleibt inaktiviert.

Konfiguration der Wiederholungsversuche für Zahlungen

Aktivieren und konfigurieren Sie Wiederholungsversuche für Zahlungen über Einstellungen → Wiederherstellung in Ihrem Dashboard.
Seite für Wiederherstellungseinstellungen mit aktiviertem Umschalter für Zahlungserneuerungen und einem Feld für das Wiederherstellungsfenster (Tage) auf 13 gesetzt
EinstellungBeschreibungStandard
Wiederholungsversuche für Zahlungen aktivierenFehlgeschlagene Abonnementverlängerungszahlungen automatisch erneut versuchen, um Einnahmen zu sichern.Aus (Opt-in)
Wiederherstellungsfenster (Tage)Dauer der Versuche, eine fehlgeschlagene Zahlung erneut zu belasten, bevor aufgegeben wird. Muss zwischen 1 und 30 liegen.13
Das Wiederherstellungsfenster ist an den Zeitpunkt gebunden, an dem die fehlgeschlagene Verlängerungsrechnung erstellt wurde. Wiederholungen werden nur geplant, während die kumulative Back-off-Verzögerung noch in das Fenster passt.

Wiederholungszeitplan

Wiederholungen werden progressiv zurückgestellt. Bis zu 8 Versuche werden gemacht, solange jeder innerhalb Ihres Wiederherstellungsfensters passt:
VersuchVerzögerung nach dem vorherigen VersuchUngefähre Zeit seit dem Fehler
112 Stunden12 Stunden
224 Stunden36 Stunden
348 Stunden~3,5 Tage
472 Stunden~6,5 Tage
596 Stunden~10,5 Tage
6120 Stunden~15,5 Tage
77 Tage~22,5 Tage
87 Tage~29,5 Tage
Ein Wiederherstellungsfenster von 13 Tagen (der Standard) deckt die Versuche 1 bis 5 ab (Versuch 5 wird ~10,5 Tage nach dem Fehler ausgeführt). Erhöhen Sie das Fenster auf das Maximum von 30 Tagen, wenn Sie möchten, dass die späteren, weiter auseinanderliegenden Versuche (6 bis 8) ausgeführt werden.

Abonnementstatusübergänge

EreignisAbonnementstatus
Verlängerungszahlung schlägt fehlactiveon_hold
Wiederholungsversuch schlägt fehlbleibt on_hold (nächster Versuch geplant, wenn Fenster dies zulässt)
Wiederholungsversuch erfolgreichon_holdactive, nächstes Abrechnungsdatum fortgesetzt
Wiederherstellungsfenster erschöpftbleibt on_hold
Diese Übergänge senden die standardmäßigen Abonnement-Webhook-Ereignisse, sodass Sie Berechtigungslogik daraus ableiten können, ohne spezielle Wiederholungsbehandlung:
EreignisWird ausgelöst, wenn
subscription.on_holdEine Verlängerung fehlschlägt und das Abonnement inaktiviert wird
subscription.activeEin Wiederholungsversuch erfolgreich ist und das Abonnement reaktiviert wird

Subscription Webhook Payloads

Sehen Sie sich die vollständigen Webhook-Nutzlastschemata für Abonnement-Lebenszyklusereignisse an.

Erneut versuchbare vs. nicht erneut versuchbare Fehler

FehlertypBeispieleErneut versucht?
Soft DeclineUnzureichende Mittel, allgemeiner Rückgang, Kartenabstufung überschritten, Verarbeitungsfehler, Netzwerkfehler/Timeout, später erneut versuchenJa
Hard DeclineGestohlene/verlorene Karte, ungültige Karte, nicht honorieren, Konto geschlossen und andere definitive AblehnungenNein — die Kette endet sofort
Das erneute Versuchen eines Hard Decline wird das Ergebnis nicht ändern, daher endet die Wiederholkette, sobald eine solche Ablehnung festgestellt wird. Kombinieren Sie Payment Retries mit Subscription Dunning, um den Kunden in diesen Fällen aufzufordern, seine Zahlungsmethode zu aktualisieren.

Wiederholungsversuche für Zahlungen vs. Dunning

Payment Retries und Subscription Dunning sind sich ergänzende Wiederherstellungswerkzeuge:
Payment RetriesSubscription Dunning
MechanismusBelastet stillschweigend die bestehende Zahlungsmethode erneutSendet dem Kunden eine E-Mail, um seine Zahlungsmethode zu aktualisieren
KundenaktionKeine erforderlichKunde aktualisiert Zahlungsmethode im Portal
Am besten geeignet fürVorübergehende/Soft Declines, die sich von selbst lösenAbgelaufene oder ungültige Karten, die ersetzt werden müssen
Das Aktivieren beider Funktionen bietet die breiteste Wiederherstellungsabdeckung: automatische Wiederholungen erfassen vorübergehende Fehler, während Dunning Kunden zurückbringt, deren Zahlungsmethode tatsächlich aktualisiert werden muss.

Verwandte Themen

Subscription Dunning

E-Mail-Sequenzen, die Kunden auffordern, ihre Zahlungsmethode zu aktualisieren.

Abandoned Cart Recovery

Unvollständige oder fehlgeschlagene Einmalzahlungen mit gezielten E-Mails wiederherstellen.

Subscriptions

Verstehen Sie die in den Wiederherstellungsabläufen beteiligten Abonnementzustände.

Subscription Webhooks

Reagieren Sie auf subscription.on_hold und subscription.active Ereignisse.
Last modified on June 9, 2026