GoCardless refer_to_payer: MS02, MS03, RR04 und SL01 bei einer SEPA-Lastschrift

Eine Ursache, vier Codes

Die drei Zeilen stammen aus der Tabelle der Zahlungsfehler (payments · failed) in der Dokumentation von GoCardless für SEPA Core. Anders als bei anderen Ursachen steht bei keiner, dass das Mandat gekündigt wird: Der Kunde bleibt dafür autorisiert, dass Sie ihn belasten, auch wenn diese konkrete Lastschrift nicht durchgegangen ist.

Was hinter jedem Code steckt

MS02 ist die eindeutigste Antwort: Der Kunde hat seiner Bank gesagt, sie solle diese Lastschrift nicht einlösen. Der Konnektor vermerkt in seinem Code, dass dies die Kombination ist, die er bei einer SEPA-Testzahlung in der Sandbox von GoCardless gesehen hat. MS03 und RR04 sind das Gegenteil: Die Zahlung scheitert, und die Bank nennt den Grund nicht, meist aus regulatorischen Gründen. Also bleibt nur, den Kunden zu fragen. SL01 betrifft das Konto: Seine Bank begrenzt die Lastschriften, die ihm belastet werden können, und das kann nur der Kontoinhaber mit seiner Bank ändern.

Bei MS02, RR04 und SL01 führt eine erneute Einreichung der Lastschrift ohne vorheriges Gespräch mit dem Kunden meist zum gleichen Ergebnis und kann eine weitere Gebühr verursachen. Bei MS03 gibt es eine Ausnahme: Laut dem Leitfaden von Success+ zählt MS03 in Österreich, Belgien, Deutschland, Luxemburg und der Slowakei als fehlende Deckung, und Success+ kann es erneut versuchen. Ist das der Fall, kommt das Ereignis mit will_attempt_retry auf true.

Was Odoo mit dem Konnektor macht

Die Transaktion öffnen Sie über die Rechnung, mit der Schaltfläche «Zahlungstransaktion» oben; das Transaktionsmenü erscheint nur im Entwicklermodus und existiert in Odoo 20 nicht. Der Konnektor speichert die Ursache im Feld «GoCardless Cause» und nicht den SEPA-Code, und zeigt «GoCardless could not collect this payment (refer_to_payer).» an. Danach richtet er sich nach dem Ereignis:

• Steht will_attempt_retry auf true, bleibt die Transaktion auf «Ausstehend», das Kontrollkästchen «Success+ Will Retry» wird gesetzt, und die Meldung lautet «Success+ will retry it automatically; there is nothing to do.». Die Schaltfläche zum Wiederholen erscheint nicht.
• Andernfalls wechselt die Transaktion auf «Fehler», und es erscheint die Schaltfläche «Retry collection», sofern noch Wiederholungen möglich sind. Hatte Odoo die Zahlung bereits als erledigt verbucht, storniert der Konnektor deren Zahlung, und die Rechnung ist wieder offen.
• Das Mandat bleibt unberührt. refer_to_payer gehört nicht zu den Ursachen, bei denen der Konnektor ein Mandat archiviert. Die Zahlungsmethode des Kunden steht also für die nächste Belastung weiterhin zur Verfügung.

Dieser letzte Punkt ist bewusst so gewählt: Ein Mandat wegen einer einzelnen Ablehnung zu archivieren, würde den Kunden ohne Grund zwingen, ein neues zu unterschreiben.

Die beiden Meldungen schreibt der Konnektor beim Verarbeiten des Ereignisses, ohne dass jemand daneben steht. Der Konnektor ist nicht ins Deutsche übersetzt: Diese Texte erscheinen immer auf Englisch, auch in einem deutschen Odoo, egal ob ein Benutzer oder eine geplante Aktion sie auslöst: «GoCardless could not collect this payment (refer_to_payer).» und «Success+ will retry it automatically; there is nothing to do.».

Was zu tun ist, je nach Code

Odoo zeigt Ihnen nicht an, welcher der vier Codes eingegangen ist: Der Konnektor speichert nur die Ursache. Den Code sehen Sie bei GoCardless. Laut deren Hilfezentrum steht der Grund für jeden Fehlschlag im Verlauf der Zahlung im Dashboard («You are able to view the reason for a payment failure in the status timeline of the payment in your GoCardless dashboard.»). Im erweiterten Modus steht der genaue Code außerdem im Ereignis (details.reason_code), und das Dashboard speichert die Zustellungen der letzten 3 Monate unter Developers > Webhooks samt Inhalt.

Sobald der Kunde bestätigt, dass die Lastschrift eingelöst werden kann, nutzen Sie in der Transaktion «Retry collection» und bestätigen den Hinweis zur Gebühr. Der Konnektor antwortet mit «Retry requested. GoCardless will confirm the new charge date.» und lässt die Zahlung ausstehend. Denken Sie an die Grenze: Eine Zahlung kann höchstens 3 Mal wiederholt werden («Payments can be retried up to 3 times.»).

Mit unserem Konnektor

In Odoo 17, 18, 19 und 20 wandelt der Konnektor refer_to_payer in eine offene Rechnung um, deren Ursache sichtbar ist, und in ein Mandat, das weiterhin gültig ist. Er rät den SEPA-Code nicht: Odoo speichert die Ursache in der Transaktion, und den Code schauen Sie bei GoCardless nach. Die Entscheidung, erneut zu belasten, treffen Sie selbst, nachdem Sie mit dem Kunden gesprochen haben.

Weiterlesen