GoCardless refund_payment_invalid_state: diese Lastschrift kann noch nicht erstattet werden

Was GoCardless sagt

In der Referenz zu den Rückerstattungen nennt GoCardless eine Frist: «A refund can only be created once it is outside the safer refund period (7 calendar days after the charge date) otherwise an error is returned.». Dieser Zeitraum lässt sich deaktivieren: «The safer refund period can be disabled by contacting GoCardless.». Und er erklärt, warum es ihn gibt: «A payment that has been (partially) refunded can still receive a late failure or chargeback from the customer's bank.».

Rückerstattungen über die API sind außerdem standardmäßig deaktiviert: «This endpoint is disabled by default. To enable it, you will need to enable refunds on your GoCardless Dashboard.».

Die Fristregeln auf einen Blick

Beide zählen nicht ab demselben Zeitpunkt. GoCardless zählt ab dem Belastungsdatum der Zahlung. Der Konnektor zählt ab der letzten Statusänderung der Zahlungstransaktion der Lastschrift in Odoo. Wenn GoCardless Ihnen den sicheren Zeitraum erlassen hat, kann die Rückerstattung zwischen 2 und 7 Tagen durchgehen.

Wann refund_payment_invalid_state beim Konnektor erscheint

Odoo erlaubt nur die Erstattung einer bestätigten Transaktion, und der Konnektor bestätigt sie, wenn GoCardless confirmed oder paid_out meldet. Dieser reason bedeutet beim Konnektor also: Die Zahlung hat sich bei GoCardless geändert, und Odoo weiß es noch nicht. Das kann ein später Fehlschlag sein, den GoCardless bei bereits bestätigter Zahlung meldet, oder eine Rückbuchung durch den Kunden, deren Ereignis noch nicht angekommen ist.

Was der Konnektor macht

1. Bei weniger als 2 Tagen sendet er nichts: Odoo bricht mit «GoCardless cannot refund a collection until it has settled. This one was charged … day(s) ago; refunds are possible after 2 days.» ab.
2. Andernfalls sendet er die Rückerstattung mit seinem Idempotenzschlüssel an GoCardless. Lehnt GoCardless sie ab, aus diesem reason, wegen des sicheren Zeitraums oder aus einem anderen Grund, geht die Rückerstattungstransaktion auf «Fehler» mit «GoCardless rejected the request.» und darunter der Meldung von GoCardless mit dem reason und der request_id.
3. Nimmt GoCardless sie an, bleibt die Transaktion auf «Ausstehend» mit «Refund submitted. GoCardless will deduct it from a future payout.» und wechselt zu «Bestätigt», sobald GoCardless sie auszahlt oder aus einer Auszahlung verrechnet.

Seit Version 1.1.5 zeigt eine fehlerhafte Rückerstattung nicht die Schaltfläche «Retry collection»: Eine Rückerstattung ist keine Lastschrift, und es gibt nichts, was GoCardless erneut versuchen könnte. Wenn GoCardless das Geld nicht zum Kunden zurückbringen kann, setzt der Konnektor die Rückerstattung auf Fehler mit «GoCardless could not pay this refund back (…).». 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.

Was zu tun ist

1. Öffnen Sie die Transaktion der Lastschrift über die Rechnung mit der Schaltfläche «Zahlungstransaktion» oben; das Menü der Transaktionen erscheint nur im Entwicklermodus und existiert in Odoo 20 nicht. Von dort führt die Schaltfläche für Rückerstattungen zur Transaktion der Rückerstattung und zu ihrer Meldung.
2. Lautet der reason refund_payment_invalid_state, prüfen Sie die Zahlung im GoCardless-Dashboard. Ist sie spät fehlgeschlagen oder hat der Kunde sie zurückgebucht, gibt es nichts mehr zu erstatten: Das Geld ist nicht mehr bei Ihnen. Odoo bildet das ab, sobald das Ereignis ankommt; die stündliche Aufgabe, die verlorene Ereignisse nachholt, bringt es.
3. Stammt die Ablehnung vom sicheren Zeitraum, warten Sie 7 Tage ab dem Belastungsdatum oder bitten Sie GoCardless, ihn zu erlassen.
4. Für eine erneute Rückerstattung gehen Sie über die Zahlung der Lastschrift und deren Schaltfläche für Rückerstattungen. Der Konnektor unterstützt Teilrückerstattungen.

Mit unserem Konnektor

In Odoo 17, 18, 19 und 20 sendet der Konnektor keine Rückerstattungen für Lastschriften, die weniger als 2 Tage alt sind, setzt die von GoCardless abgelehnten mit ihrer request_id auf Fehler und bietet kein erneutes Versuchen für eine Rückerstattung an, weil diese keine Lastschrift ist.

Weiterlesen