Payment Retries belastet fehlgeschlagene Zahlungen für die Verlängerung von Abonnements automatisch nach einem gestaffelten Zeitplan erneut. Wenn ein erneuter Versuch erfolgreich ist, kehrt das Abonnement zu
active zurück – ohne Aktion des Kunden und ohne Integrationsaufwand.Was sind erneute Zahlungsversuche?
Wenn eine Zahlung für die Verlängerung eines Abonnements fehlschlägt, wechselt das Abonnement zuon_hold oder zu past_due, wenn Sie eine Kulanzfrist festlegen. Wenn Payment Retries aktiviert sind, belastet Dodo Payments die gespeicherte Zahlungsmethode des Kunden nach einem Zeitplan erneut, bis eine Belastung erfolgreich ist oder das Wiederherstellungsfenster endet.
Erneute Versuche stellen Umsätze wieder her, die durch vorübergehende Fehler verloren gegangen sind, etwa eine vorübergehende Sperre der Karte, unzureichendes Guthaben, das der Kunde später auflädt, oder einen vorübergehenden Netzwerkfehler. Der Kunde erhält keine E-Mail und muss nichts ändern.
Payment Retries gelten nur für Zahlungen zur Verlängerung von Abonnements. Die erste Zahlung eines Abonnements (Einrichtung des Mandats), einmalige Zahlungen, Gebühren für Planänderungen und nutzungsabhängige Gebühren werden nicht erneut versucht.
Funktionsweise erneuter Zahlungsversuche
1
Renewal fails
Eine Zahlung für die Verlängerung eines Abonnements schlägt fehl, und das Abonnement wechselt zu
on_hold oder während einer Kulanzfrist zu past_due.2
Retryability check
Dodo Payments prüft den Fehlercode des Fehlers. Soft Declines, etwa unzureichendes Guthaben, eine allgemeine Ablehnung oder ein Verarbeitungs- bzw. Netzwerkfehler, können erneut versucht werden. Hard Declines beenden die Versuchskette, da ein weiterer Versuch das Ergebnis nicht ändern würde. Ein Fehler ohne Fehlercode gilt als Hard Decline.
3
Scheduled retry
Wenn die Ablehnung erneut versucht werden kann und der nächste Versuch in das Wiederherstellungsfenster passt, plant Dodo Payments ihn ein. Jeder erneute Versuch ist eine Off-Session-Belastung der gespeicherten Zahlungsmethode des Kunden, und jede Verzögerung wird ab dem vorherigen Fehler berechnet.
4
Recovery
Beim ersten erfolgreichen erneuten Versuch kehrt das Abonnement zu
active zurück, und das nächste Abrechnungsdatum verschiebt sich auf einen Abrechnungszeitraum nach dem erfolgreichen Versuch. Wenn das Fenster endet, bevor ein Versuch erfolgreich ist, werden keine weiteren Versuche unternommen und das Abonnement behält seinen Status, beispielsweise on_hold.Erneute Zahlungsversuche konfigurieren
Aktivieren und konfigurieren Sie Payment Retries unter Einstellungen → Wiederherstellung in Ihrem Dashboard.
Payment Retries settings under Settings → Recovery
Das Wiederherstellungsfenster beginnt, wenn die Rechnung für die fehlgeschlagene Verlängerung erstellt wird. Dodo Payments plant einen Versuch nur dann ein, wenn die Summe aller Verzögerungen bis zu diesem Versuch in das Fenster passt und das Fenster noch geöffnet ist.
Zeitplan für erneute Versuche
Die Abstände zwischen den Versuchen werden schrittweise verlängert. Dodo Payments unternimmt bis zu 8 Versuche, sofern jeder einzelne in das Wiederherstellungsfenster passt:Statusübergänge von Abonnements
Erneute Versuche verschieben das Abonnement zwischen diesen Status:Wenn ein Abonnement gekündigt wird, endet seine Versuchskette und es werden keine weiteren Versuche unternommen. Jeder andere Status (
on_hold, past_due, expired, pending, failed) wird weiterhin erneut versucht, da die offene Verlängerungsrechnung eine Schuld für einen Zeitraum darstellt, den der Kunde bereits genutzt hat. Erneute Versuche werden auch beendet, wenn die Rechnung auf anderem Weg bezahlt wird, beispielsweise nachdem der Kunde seine Zahlungsmethode aktualisiert hat, oder wenn Sie den Kunden zu Ihrer Sperrliste hinzufügen.Subscription Webhook Payloads
Zeigen Sie die vollständigen Webhook-Payload-Schemas für Ereignisse im Lebenszyklus von Abonnements an.
Fehler, die erneut versucht werden können, und Fehler, bei denen dies nicht möglich ist
Der Fehlercode des letzten Fehlers entscheidet, ob die Kette fortgesetzt wird:Ein erneuter Versuch bei einem Hard Decline ändert das Ergebnis nicht. Daher endet die Kette, sobald ein Hard Decline auftritt. Kombinieren Sie Payment Retries mit Subscription Dunning, um den Kunden in diesen Fällen nach einer neuen Zahlungsmethode zu fragen. Den Typ jedes Codes finden Sie unter Transaction Failures.
Erneute Versuche auf Abruf
Sie müssen nicht auf den nächsten geplanten Versuch warten. Während sich ein Abonnement im Statuson_hold befindet, können Sie auf der Detailseite der fehlgeschlagenen Zahlung im Dashboard einen erneuten Versuch senden oder POST /payments/{payment_id}/retry verwenden. Manuelle erneute Versuche laufen unabhängig vom Zeitplan: Sie verbrauchen keinen automatischen Versuch und verschieben ihn nicht und funktionieren auch dann, wenn Payment Retries deaktiviert sind. Siehe Manual Payment Retry.
Payment Retries im Vergleich zu Dunning
Payment Retries und Subscription Dunning stellen unterschiedliche Arten von Fehlern wieder her:
Aktivieren Sie beide Funktionen für die umfassendste Abdeckung: Automatische erneute Versuche fangen vorübergehende Fehler ab, und Dunning gewinnt Kunden zurück, deren Zahlungsmethode ersetzt werden muss.
Verwandte Themen
Manual Payment Retry
Senden Sie sofort einen erneuten Versuch, anstatt auf den nächsten geplanten Versuch zu warten.
Subscription Dunning
E-Mail-Sequenzen, in denen Kunden aufgefordert werden, ihre Zahlungsmethode zu aktualisieren.
Abandoned Cart Recovery
Stellen Sie abgebrochene oder fehlgeschlagene Checkouts mit Wiederherstellungs-E-Mails wieder her.
Subscriptions
Die Abonnementstatus, zwischen denen sich Wiederherstellungsabläufe bewegen.
Subscription Webhooks
Reagieren Sie auf die Ereignisse
subscription.on_hold und subscription.active.