GoCardless internal_server_error und request_timed_out: der Fehler liegt bei GoCardless

Was GoCardless sagt

GoCardless ordnet diese Reasons dem Typ gocardless zu, also den Fehlern, die bei GoCardless selbst während der Verarbeitung Ihrer Anfrage auftreten: «These errors occurred within GoCardless while processing your request.». Die HTTP-Codes-Tabelle beschreibt die beiden Codes so:

Auf der Seite zu den Limits legt GoCardless außerdem fest, wie lange eine Anfrage höchstens dauern darf: 29 Sekunden («Request timeout 29 seconds»).

Drei Fälle, die der Konnektor nicht gleich behandelt

Der Konnektor wartet bei jeder Anfrage bis zu 30 Sekunden auf die Antwort von GoCardless. Bei einer Zahlung, einer Rückerstattung oder einem Wiederholungsversuch kann Odoo auf drei verschiedene Situationen stoßen:

• GoCardless antwortet mit einem 500 oder einem 504, und die Antwort enthält den Reason.
• GoCardless antwortet nicht: Die Verbindung bricht ab oder die 30 Sekunden sind abgelaufen.
• Der Fehler tritt beim Verarbeiten eines Ereignisses auf, wenn der Konnektor bei GoCardless die Zahlung abfragt, auf die sich das Ereignis bezieht.

Was der Konnektor tut

Bei einem 500 oder 504. Der Konnektor wiederholt eine Anfrage nur, wenn keine Antwort kommt oder nach einem 429. Bei einem 500 oder 504 gibt es eine Antwort, also wertet er sie als Ablehnung. Bei einer Abbuchung wechselt die Transaktion auf «Fehler» mit «GoCardless rejected the request.» und darunter der Meldung von GoCardless mit dem Reason und der request_id in eckigen Klammern. Die stündliche Aufgabe sendet eine fehlerhafte Transaktion nicht erneut. Sollte GoCardless die Abbuchung trotzdem angelegt haben, verknüpft sie das erste Ereignis: Jede Abbuchung trägt in ihren Metadaten die Referenz der Odoo-Transaktion, der Konnektor sucht sie darüber und übernimmt den Zahlungsstatus. Eine fehlerhafte Transaktion geht so wieder auf «Ausstehend» oder wird «Bestätigt».

Ohne Antwort. Der Konnektor wiederholt die Anfrage einmal mit demselben Idempotenzschlüssel. Antwortet auch dann niemand, gilt die Abbuchung nicht als verloren: Die Transaktion bleibt ausstehend mit «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 stündliche Aufgabe sendet sie mit demselben Schlüssel erneut; hat GoCardless sie bereits angelegt, antwortet es mit 409, und der Konnektor übernimmt das Vorhandene.

Beim Verarbeiten eines Ereignisses. Bei jedem Ereignis zu einer Zahlung fragt der Konnektor diese Zahlung bei GoCardless ab. Schlägt die Abfrage fehl, antwortet der Webhook mit 500, damit GoCardless die Zustellung wiederholt; bereits verarbeitete Ereignisse werden nicht doppelt angewendet. Auch die stündliche Nachholung lässt kein fehlgeschlagenes Ereignis liegen.

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 Sendung durch den Konnektor selbst: «GoCardless rejected the request.» und «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

1. Öffnen Sie die Transaktion über die Rechnung, mit der Schaltfläche «Zahlungstransaktion» oben; das Transaktionsmenü erscheint nur im Entwicklermodus und existiert in Odoo 20 nicht. Nennt die Meldung internal_server_error oder request_timed_out, lag der Fehler bei GoCardless, nicht beim Kunden oder bei dessen Mandat.
2. Bevor Sie die Rechnung erneut einziehen, suchen Sie die Abbuchung im GoCardless-Dashboard: Der Konnektor setzt als Beschreibung jeder Abbuchung die Referenz seiner Odoo-Transaktion. Ist sie dort, ziehen Sie nicht erneut ein; ihr Ereignis verknüpft die Transaktion.
3. Ist sie nicht dort, ziehen Sie die Rechnung mit der gespeicherten Zahlungsmethode des Kunden erneut ein. Eine neue Abbuchung ist eine andere Transaktion mit einem anderen Idempotenzschlüssel, deshalb lohnt sich der Blick vorher.
4. Tritt der Fehler wieder auf, schreiben Sie an den Support von GoCardless und nennen die request_id aus der Meldung: Laut deren Dokumentation gehört sie zu jeder Anfrage an den Support.

Mit unserem Konnektor

In Odoo 17, 18, 19 und 20 unterscheidet der Konnektor einen Fehler bei GoCardless von einer Anfrage ohne Antwort: Der erste Fall geht mit seiner request_id auf Fehler, der zweite bleibt ausstehend und wird mit demselben Schlüssel erneut gesendet. In beiden Fällen verknüpft das Ereignis einer tatsächlich vorhandenen Abbuchung diese mit ihrer Transaktion.

Weiterlesen