GoCardless 429 rate_limit_exceeded: zu viele Anfragen pro Minute

Was GoCardless sagt

Die Limitseite von GoCardless nennt die Zahl: 1.600 Anfragen pro Minute bei einer Standardintegration und 1.600 pro Minute und Händler bei einer Partnerintegration. Wird das überschritten, gibt die API den Statuscode 429 zurück, und GoCardless stellt klar, dass diese Anfragen gefahrlos wiederholt werden können: «These requests are safe to retry.». Wann es weitergehen kann, verrät die Antwort über die Header ratelimit-limit, ratelimit-remaining und ratelimit-reset.

Woher so viele Anfragen kommen

Das Limit zählt alle Anfragen an die API, nicht nur die, die Lastschriften erstellen. Mit dem Konnektor ist jede Lastschrift mit einem gespeicherten Mandat eine Anfrage, egal ob sie aus einem verlängerten Abonnement stammt oder aus einer Zahlung mit der Zahlungsmethode des Kunden. Jedes Ereignis zu einer Zahlung, das in Odoo ankommt, ist eine weitere, denn der Konnektor verlässt sich nicht allein auf die Benachrichtigung: Er fragt diese Zahlung bei GoCardless ab und übernimmt den Status, den GoCardless zurückgibt. Eine große Menge gleichzeitig addiert beides.

GoCardless ordnet diesen reason den Fehlern invalid_api_usage zu, also solchen, die aus der Art der Anfrage entstehen, und bittet bei diesen, das technische Team zu informieren («alert your dev team»). Ein einzelner 429 braucht das nicht; einer, der sich jeden Tag wiederholt, schon.

Was der Konnektor macht

1. Er liest den Header ratelimit-reset und berechnet, wie lange es noch dauert: die angegebene Uhrzeit abzüglich der Uhrzeit des Odoo-Servers.
2. Er wartet diese Zeit, mindestens 1 Sekunde und höchstens 65. Fehlt der Header oder lässt er sich nicht lesen, wartet er 1 Sekunde. Die Obergrenze verhindert, dass eine falsch eingestellte Uhr den wartenden Odoo-Prozess blockiert.
3. Er wiederholt die Anfrage genau einmal.
4. Erhält die Wiederholung wieder einen 429, wartet er nicht länger und behandelt ihn wie jede andere Ablehnung der API.

Der Konnektor zählt seine Anfragen nicht und bremst sie nicht im Voraus. Er liest ratelimit-remaining nicht: Er wartet nur, wenn GoCardless bereits mit 429 geantwortet hat.

Wenn auch der zweite Versuch scheitert

Das hängt davon ab, was Odoo in diesem Moment tat.

• Handelte es sich um eine Lastschrift, wechselt die Zahlungstransaktion auf «Fehler» mit der Meldung «GoCardless rejected the request.» und darunter der Meldung von GoCardless mit rate_limit_exceeded und der request_id in eckigen Klammern. Die Rechnung bleibt zur Einziehung offen.
• Verarbeitete Odoo gerade ein Ereignis von GoCardless, antwortet der Webhook mit 500, damit GoCardless die Zustellung erneut sendet. Bereits übernommene Ereignisse werden nicht doppelt übernommen. Auch die stündliche Wiederherstellung lässt kein fehlgeschlagenes Ereignis liegen: Sie fordert es beim nächsten Durchlauf erneut an.

Ein 429 ist nicht dasselbe wie eine Lastschrift ohne Antwort. Ohne Antwort weiß der Konnektor nicht, ob GoCardless die Lastschrift angelegt hat, also bleibt sie offen und wird mit demselben Schlüssel innerhalb einer Stunde erneut gesendet. Bei einem 429 gibt es eine Antwort: GoCardless hat die Anfrage nicht angenommen, deshalb steht die Transaktion auf Fehler.

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 rejected the request.».

Was zu tun ist

• Öffnen Sie die Transaktion über die Schaltfläche «Zahlungstransaktion» oben auf der Rechnung; das Menü der Transaktionen erscheint nur im Entwicklermodus und existiert in Odoo 20 nicht. Nennt die Meldung rate_limit_exceeded, hat GoCardless diese Anfrage wegen des Limits abgelehnt, nicht wegen des Kunden oder seines Mandats.
• Versuchen Sie nach einer Weile, die Rechnung erneut mit der gespeicherten Zahlungsmethode des Kunden einzuziehen.
• Tritt das häufig auf, prüfen Sie die Uhrzeit des Odoo-Servers: Die Wartezeit ergibt sich aus der Differenz zu ratelimit-reset, und eine vorgehende Uhr verkürzt sie.
• Brauchen Sie GoCardless, bewahren Sie die request_id aus der Meldung auf: Die Dokumentation verlangt sie bei Kontakt mit dem Support.

Mit unserem Konnektor

In Odoo 17, 18, 19 und 20 behandelt der Konnektor den 429 als Pause: Er wartet die von GoCardless genannte Zeit, wiederholt die Anfrage einmal und lässt die Transaktion bei fortbestehendem Limit auf Fehler stehen, mit der request_id, damit Sie wissen, was passiert ist und was Sie GoCardless mitteilen können.

Weiterlesen