GoCardless access_token_revoked: Odoo kan niet meer met je account praten

Wat GoCardless zegt

Voor Odoo betekenen de drie hetzelfde: de referentie waarmee het verzoeken doet, werkt niet meer. In hun tabel met HTTP-codes reserveert GoCardless de 401 voor dat geval: "Missing or invalid Authorization header, or the user has been disabled.". Het zijn invalid_api_usage-fouten, die komen door de manier waarop het verzoek is gedaan, en voor die fouten vraagt GoCardless om het technische team te waarschuwen ("alert your dev team").

Wanneer het token ophoudt te werken

De connector verbindt op twee manieren met GoCardless, en het token sterft op een andere manier in elk geval:

• "Connect my GoCardless account" is de verbinding in twee klikken, via FlexigoTech: een partnerintegratie. Volgens de partnergids van GoCardless kan de handelaar die toegang intrekken via zijn Dashboard ("they can revoke your access from the GoCardless dashboard") of zijn account sluiten. Dan stuurt GoCardless een laatste webhook en werkt het token niet meer: "Your access token stops working, so you can't make any more API calls for that user.".
• "Paste an access token (advanced)" is de modus waarin jij het token aanmaakt in het Dashboard van GoCardless en het in Odoo plakt. Als je het daar intrekt of deactiveert, ontdekt Odoo dat bij het volgende verzoek, wanneer GoCardless het afwijst.

Wat Odoo met de connector doet

Bij de verbinding in twee klikken komt die laatste webhook zonder event-id, als organisations · disconnected. De connector verwerkt hem zo:

1. Hij wist het token en het geheim van de webhook, en de verbinding van de provider wordt "Disconnected in GoCardless".
2. Hij schrijft op het contact van je bedrijf "GoCardless reports that the account was disconnected from Odoo on … (…). No collection can be taken until it is connected again.", met de datum en de oorzaak die GoCardless meldt.
3. Hij maakt de activiteit "GoCardless disconnected", zodat iemand het ziet zonder de provider te openen.

Vanaf dat moment roept de connector GoCardless met die provider niet meer aan: de taak van elk uur slaat hem over, en een incasso met de opgeslagen betaalmethode van een klant krijgt de status "Fout" met "This provider is not connected to GoCardless any more: connect it again first.".

Zonder die melding blijft het token opgeslagen en wijst GoCardless elk verzoek af. Bij een incasso krijgt de transactie de status "Fout" met "GoCardless rejected the request." en daaronder het bericht van GoCardless met de reason (access_token_revoked, access_token_not_active of unauthorized) en de request_id tussen vierkante haken. De factuur blijft openstaan voor incasso, en de taak van elk uur stuurt een transactie in fout niet opnieuw.

De melding op het contact en de activiteit schrijft de connector zonder dat iemand erbij is, bij het verwerken van de webhook. De connector is niet in het Nederlands vertaald: deze teksten verschijnen altijd in het Engels, ook in een Nederlandstalige Odoo, of een gebruiker of een geplande actie ze nu start: "GoCardless reports that the account was disconnected from Odoo on … (…). No collection can be taken until it is connected again." en "GoCardless disconnected". De berichten van een incasso verschijnen in de taal van wie hem start; start een geplande actie hem, zoals de verlenging van een abonnement, dan geldt dezelfde regel: "This provider is not connected to GoCardless any more: connect it again first." en "GoCardless rejected the request.".

Wat te doen

1. Open de transactie vanaf de factuur, via de knop "Betalingstransactie" bovenaan; het menu met transacties verschijnt alleen in de ontwikkelaarsmodus, en in Odoo 20 bestaat het niet. Als het bericht zegt dat de provider niet meer verbonden is, of een van de drie reasons noemt, ligt het probleem bij de verbinding, niet bij de klant of zijn mandaat.
2. Bij de verbinding in twee klikken open je de betaalprovider GoCardless en verbind je opnieuw met "Connect my GoCardless account".
3. In de geavanceerde modus maak je een nieuw token aan in het Dashboard van GoCardless, plak je het in "GoCardless Access Token" en klik je op "Test connection". De connector vraagt met dat token de schuldeiser van je account op: als GoCardless het afwijst, zie je de fout op dat moment en niet pas bij de volgende incasso.
4. Als de verbinding weer werkt, incasseer je de facturen die openstaan opnieuw. Transacties in fout worden niet vanzelf opnieuw verstuurd.
5. Heb je GoCardless nodig, bewaar dan de request_id uit het bericht: hun documentatie vraagt om die bij contact met hun support te vermelden.

Met onze connector

In Odoo 17, 18, 19 en 20 laat de connector niet toe dat een dood token overgaat in een reeks mislukte incasso's zonder uitleg: als GoCardless de afkoppeling meldt, zegt de connector dat op het bedrijf en in een activiteit, en als GoCardless dat niet meldt, bevat elke afwijzing de reason en de request_id van GoCardless.

Lees verder