GoCardless 409 idempotent_creation_conflict: Die Abbuchung existierte bereits

Was GoCardless sagt

Die Seite zu den Limits von GoCardless ergänzt: Existiert bereits eine Ressource mit diesem Schlüssel, lautet die Antwort 409 mit links.conflicting_resource_id, die auf die bereits angelegte Ressource verweist. Schlüssel dürfen bis zu 128 Zeichen lang sein, und GoCardless merkt sie sich mindestens 30 Tage.

Das Problem, das er löst

Eine Anfrage kann dauern: GoCardless bricht solche ab, die länger als 29 Sekunden laufen, und das Netz kann vorher abreißen. Fordert Odoo eine Abbuchung an und erhält keine Antwort, weiß es nicht, ob GoCardless sie angelegt hat. Die Anfrage einfach zu wiederholen ist gefährlich; die Dokumentation von GoCardless warnt, dass ein Wiederholen ohne Idempotenzschlüssel nach einem Timeout dieselbe Zahlung doppelt einziehen kann.

Mit Schlüssel legt der zweite Versuch nichts neu an: Ist der erste angekommen, antwortet GoCardless mit diesem 409 und der Kennung der bereits bestehenden Abbuchung.

Wie der Konnektor ihn nutzt

Der Konnektor sendet bei jeder Anfrage, die eine Abbuchung, eine Rückerstattung, einen Wiederholungsversuch oder die Mandatsanfrage anlegt, einen Idempotenzschlüssel. Der Schlüssel ist nicht zufällig. Er wird aus dem Vorgang, der Odoo-Transaktion und der Datenbankkennung berechnet, sodass:

• die Wiederholung derselben Abbuchung exakt denselben Schlüssel sendet;
• eine Testkopie der Datenbank nicht mit der Produktivdatenbank kollidiert, auch wenn beide dieselbe Rechnung ausstellen.

Kommt der 409, liest der Konnektor conflicting_resource_id, fordert diese Ressource bei GoCardless an und übernimmt sie als Antwort. Für Sie entsteht kein Fehler: Die Transaktion wird mit der bereits bestehenden Abbuchung verknüpft, und die Rechnung läuft normal weiter.

Wenn GoCardless nicht antwortet

Bleibt eine Anfrage ohne Antwort, wiederholt der Konnektor sie einmal mit demselben Schlüssel. Ohne Schlüssel wiederholt er nichts. Bleibt auch dann die Antwort aus, meldet er es, ohne die Abbuchung als verloren zu betrachten: «GoCardless did not answer, so it is not known yet whether it took the request. It will be sent again, safely, within the hour.». Die Transaktion bleibt ausstehend, nicht im Fehlerzustand, denn im Fehlerzustand könnte Odoo eine weitere Abbuchung mit einer anderen Referenz und einem anderen Schlüssel erzeugen.

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, etwa die Verlängerung eines Abonnements oder die erneute Übermittlung durch den Konnektor selbst: «GoCardless did not answer, so it is not known yet whether it took the request. It will be sent again, safely, within the hour.».

Was zu tun ist

Mit dem Konnektor normalerweise nichts: Der 409 löst sich selbst auf. Sehen Sie ihn in einem anderen Programm, das mit demselben GoCardless-Konto verbunden ist, prüfen Sie zwei Dinge. Erstens, ob Sie einen Schlüssel nicht für unterschiedliche Vorgänge wiederverwenden. Zweitens, ob die Ressource aus conflicting_resource_id die erwartete ist: Ist sie es, hat der Wiederholungsversuch wie vorgesehen funktioniert. Ist sie es nicht, notieren Sie die request_id der Antwort: GoCardless verlangt sie bei einer Kontaktaufnahme mit dem Support, und der Konnektor nimmt sie in seine Fehlermeldungen auf.

Mit unserem Konnektor

In Odoo 17, 18, 19 und 20 wendet der Konnektor die Regel an, die GoCardless fordert, um nicht doppelt abzubuchen: fester Schlüssel pro Vorgang, Wiederholung nur mit demselben Schlüssel und Übernahme der bestehenden Ressource, wenn der 409 eintrifft.

Weiterlesen