GoCardless access_token_revoked: Odoo kann Ihr Konto nicht mehr erreichen

Was GoCardless meldet

Für Odoo bedeuten alle drei dasselbe: Die Zugangsdaten, mit denen angefragt wird, sind nicht mehr gültig. In seiner Tabelle der HTTP-Codes reserviert GoCardless den 401 für diesen Fall: «Missing or invalid Authorization header, or the user has been disabled.». Es handelt sich um invalid_api_usage-Fehler, also solche, die aus der Art der Anfrage entstehen; dafür verlangt GoCardless, das technische Team zu informieren («alert your dev team»).

Wann ein Token ungültig wird

Der Konnektor verbindet sich auf zwei Wegen mit GoCardless, und der Token erlischt bei jedem anders:

• «Connect my GoCardless account» ist die Verbindung mit zwei Klicks über FlexigoTech: eine Partner-Integration. Laut dem Partnerleitfaden von GoCardless kann der Händler diesen Zugriff im GoCardless-Dashboard widerrufen («they can revoke your access from the GoCardless dashboard») oder sein Konto schließen. Dann sendet GoCardless ein letztes Webhook, und der Token funktioniert nicht mehr: «Your access token stops working, so you can't make any more API calls for that user.».
• «Paste an access token (advanced)» ist der Modus, in dem Sie den Token selbst im GoCardless-Dashboard erstellen und in Odoo einfügen. Wenn Sie ihn dort widerrufen oder deaktivieren, bemerkt Odoo das bei der nächsten Anfrage, wenn GoCardless sie ablehnt.

Was der Konnektor in Odoo tut

Bei der Verbindung mit zwei Klicks kommt dieses letzte Webhook ohne Ereignis-ID an, als organisations · disconnected. Der Konnektor verarbeitet es so:

1. Er löscht den Token und das Webhook-Geheimnis, und die Verbindung des Anbieters wechselt zu «Disconnected in GoCardless».
2. Er schreibt in den Kontakt Ihres Unternehmens «GoCardless reports that the account was disconnected from Odoo on … (…). No collection can be taken until it is connected again.», mit Datum und Ursache laut GoCardless.
3. Er legt die Aktivität «GoCardless disconnected» an, damit jemand es erfährt, ohne den Anbieter öffnen zu müssen.

Ab diesem Moment ruft der Konnektor GoCardless mit diesem Anbieter nicht mehr auf: Die stündliche Aufgabe überspringt ihn, und eine Einziehung mit der gespeicherten Zahlungsmethode eines Kunden wird auf «Fehler» gesetzt, mit «This provider is not connected to GoCardless any more: connect it again first.».

Ohne diesen Hinweis bleibt der Token gespeichert, und GoCardless lehnt jede Anfrage ab. Bei einer Einziehung wird die Transaktion auf «Fehler» gesetzt mit «GoCardless rejected the request.» und darunter der Meldung von GoCardless mit dem Reason (access_token_revoked, access_token_not_active oder unauthorized) sowie der request_id in eckigen Klammern. Die Rechnung bleibt zur Einziehung offen, und die stündliche Aufgabe sendet eine fehlerhafte Transaktion nicht erneut.

Den Hinweis im Kontakt und die Aktivität schreibt der Konnektor ohne Beteiligung eines Benutzers beim Verarbeiten des Webhooks. Die Texte erscheinen immer auf Englisch: Der Konnektor ist nicht ins Deutsche übersetzt, auch in einem deutschen Odoo, egal ob ein Benutzer oder eine geplante Aktion sie auslöst. Die Meldungen einer Einziehung erscheinen so: «GoCardless reports that the account was disconnected from Odoo on … (…). No collection can be taken until it is connected again.» und «GoCardless disconnected». Wird die Einziehung durch eine geplante Aktion ausgelöst, etwa die Verlängerung eines Abonnements, gilt dieselbe Regel: «This provider is not connected to GoCardless any more: connect it again first.» und «GoCardless rejected the request.».

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. Wenn die Meldung sagt, dass der Anbieter nicht mehr verbunden ist, oder einen der drei Reasons nennt, liegt das Problem an der Verbindung, nicht am Kunden oder seinem Mandat.
2. Bei der Verbindung mit zwei Klicks öffnen Sie den Zahlungsanbieter GoCardless und verbinden Sie erneut über «Connect my GoCardless account».
3. Im erweiterten Modus erstellen Sie im GoCardless-Dashboard einen neuen Token, fügen ihn in «GoCardless Access Token» ein und klicken auf «Test connection». Der Konnektor fragt mit diesem Token den Gläubiger Ihres Kontos bei GoCardless ab: Lehnt GoCardless ihn ab, sehen Sie den Fehler sofort und nicht erst bei der nächsten Einziehung.
4. Wenn die Verbindung wieder steht, ziehen Sie die Rechnungen erneut ein, die offen geblieben sind. Fehlerhafte Transaktionen werden nicht automatisch erneut gesendet.
5. Falls Sie GoCardless kontaktieren müssen, notieren Sie die request_id aus der Meldung: Laut deren Dokumentation soll sie beim Support angegeben werden.

Mit unserem Konnektor

In Odoo 17, 18, 19 und 20 lässt der Konnektor nicht zu, dass ein ungültiger Token zu einer Kette fehlgeschlagener Einziehungen ohne Erklärung wird: Meldet GoCardless die Trennung, wird sie im Unternehmen und in einer Aktivität festgehalten, und wenn GoCardless nichts meldet, enthält jede Ablehnung den Reason und die request_id von GoCardless.

Weiterlesen