GoCardless mandate_not_inactive: Das Mandat kann nicht reaktiviert werden

Was GoCardless meldet

GoCardless trennt die beiden Teile des Textes mit einem Gedankenstrich. In der API-Referenz heißt es dazu: «This will fail with a mandate_not_inactive error if the mandate is already being submitted, or is active.». Es handelt sich um einen invalid_state-Fehler, und für solche Fälle verlangt GoCardless, den Benutzer zu informieren und keinen erneuten Versuch zuzulassen («invalid_state → inform the end user, do not allow retry.»).

Welche Mandate sich reaktivieren lassen

Die Reaktivierung hat mehr Bedingungen als nur den Status:

• Es ist eine eingeschränkte Funktion: «Restricted this endpoint requires approved custom payment pages».
• Sie gilt nur für ein Mandat, das über das Dashboard oder die API gekündigt wurde: «A mandate can only be reinstated if it has been cancelled through the dashboard or the API.». Ein von der Bank gekündigtes Mandat dagegen nicht: «Any mandate that has been cancelled by the bank cannot be reinstated.».
• Sie dient gekündigten oder abgelaufenen Mandaten («Reinstates a cancelled or expired mandate to the banks.»), und ein Mandat kann bis zu 10-mal erneut eingereicht werden («Mandates can be resubmitted up to 10 times.»).

Nach der Anforderung läuft der Vorgang wie eine Neuanlage ab: Es kommt resubmission_requested, und danach, wie GoCardless schreibt, «so you will receive a submitted webhook, followed by a reinstated or failed webhook up to two working days later.».

Was der Konnektor in Odoo tut

Auf der Karte der Zahlungsart des Kunden zeigt der Konnektor die Schaltfläche «Reinstate mandate (sandbox)» an. Sie erscheint nur, wenn das Mandat von GoCardless stammt, der Anbieter nicht in der Produktion ist (in Odoo 17, 18 und 19 der Status des Anbieters, in Odoo 20 das Kontrollkästchen für die Produktion) und «Mandate Status» den Wert cancelled, failed oder expired hat.

Beim Klick:

1. Der Konnektor fordert bei GoCardless die Reaktivierung dieses Mandats an.
2. Akzeptiert GoCardless das, wechselt der Status zu reinstate_requested, und auf der Kundenkarte steht «Reinstatement of the GoCardless mandate requested. It stays unusable until the bank confirms it.». Die Zahlungsart bleibt archiviert.
3. Wenn reinstated eintrifft, bestätigt der Konnektor das wieder: Er reaktiviert das Mandat und schreibt «The GoCardless mandate is usable again (reinstated).».

Antwortet GoCardless mit mandate_not_inactive, fängt der Konnektor das nicht ab: Odoo zeigt «GoCardless rejected the request.» mit der Meldung von GoCardless, dem Reason und der request_id, und das Mandat bleibt unverändert. Das geschieht, wenn Odoo das Mandat für erledigt hält, GoCardless es aber bereits als aktiv oder in Einreichung führt, weil dessen Ereignisse Odoo noch nicht erreicht haben. Nach einer angenommenen Anforderung erscheint die Schaltfläche nicht mehr, da der Status zu reinstate_requested wechselt.

Den Hinweis, dass das Mandat wieder verwendbar ist, schreibt der Konnektor beim Anwenden des Ereignisses, ohne dass jemand davor sitzt. 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: «The GoCardless mandate is usable again (reinstated).».

Was zu tun ist

1. Erscheint mandate_not_inactive, suchen Sie das Mandat im GoCardless-Dashboard. Ist es aktiv oder wird es eingereicht, gibt es nichts zu reaktivieren: Warten Sie, bis dessen Ereignisse eintreffen. Die Aufgabe, die stündlich verlorene Ereignisse nachholt, holt sie ab.
2. Hat die Bank das Mandat gekündigt, versuchen Sie es nicht: GoCardless reaktiviert solche Mandate nicht. Bitten Sie den Kunden um ein neues Mandat.
3. In der Produktion bietet der Konnektor keine Reaktivierung an: Der Weg ist ein neues, vom Kunden unterschriebenes Mandat.
4. Zum Testen nutzen Sie die Sandbox von GoCardless mit dem Anbieter im Testbetrieb.

Mit unserem Konnektor

In Odoo 17, 18, 19 und 20 bietet der Konnektor eine Reaktivierung nur für ein gekündigtes, fehlgeschlagenes oder abgelaufenes Mandat an, und nur außerhalb der Produktion. Er verwendet das Mandat erst wieder, wenn GoCardless die Reaktivierung mit seinem Ereignis bestätigt.

Weiterlesen