GoCardless access_token_revoked: Odoo non riesce più a parlare con il tuo account

Cosa dice GoCardless

Per Odoo i tre significano la stessa cosa: la credenziale con cui chiede le cose non è più valida. Nella sua tabella dei codici HTTP, GoCardless riserva il 401 a questo caso: «Missing or invalid Authorization header, or the user has been disabled.». Sono errori invalid_api_usage, quelli che dipendono da come viene fatta la richiesta, e per questi GoCardless chiede di avvisare il team tecnico («alert your dev team»).

Quando il token smette di funzionare

Il connettore si collega a GoCardless in due modi, e il token termina in modo diverso in ciascuno:

• «Connect my GoCardless account» è la connessione in due clic, tramite FlexigoTech: un'integrazione di partner. Secondo la guida per i partner di GoCardless, il commerciante può revocare quell'accesso dalla sua Dashboard («they can revoke your access from the GoCardless dashboard») oppure chiudere il proprio account. A quel punto GoCardless invia un ultimo webhook e il token smette di funzionare: «Your access token stops working, so you can't make any more API calls for that user.».
• «Paste an access token (advanced)» è la modalità in cui crei tu il token nella Dashboard di GoCardless e lo incolli in Odoo. Se lo revochi o lo disattivi lì, Odoo se ne accorge alla richiesta successiva, quando GoCardless la rifiuta.

Cosa fa Odoo con il connettore

Con la connessione in due clic, quell'ultimo webhook arriva senza id evento, come organisations · disconnected. Il connettore lo applica così:

1. Cancella il token e il segreto del webhook, e la connessione del provider passa a «Disconnected in GoCardless».
2. Scrive nel contatto della tua azienda «GoCardless reports that the account was disconnected from Odoo on … (…). No collection can be taken until it is connected again.», con la data e la causa comunicate da GoCardless.
3. Crea l'attività «GoCardless disconnected», perché qualcuno se ne accorga senza aprire il provider.

Da quel momento il connettore non richiama più GoCardless con quel provider: l'attività pianificata oraria lo salta, e un incasso con il metodo di pagamento salvato di un cliente passa a «Errore» con «This provider is not connected to GoCardless any more: connect it again first.».

Senza quell'avviso, il token resta salvato e GoCardless rifiuta ogni richiesta. In un incasso, la transazione passa a «Errore» con «GoCardless rejected the request.» e, sotto, il messaggio di GoCardless con il reason (access_token_revoked, access_token_not_active o unauthorized) e il request_id tra parentesi quadre. La fattura resta da incassare, e l'attività oraria non ritenta una transazione in errore.

Il connettore non è tradotto in italiano: questi testi compaiono sempre in inglese, anche in un Odoo in italiano, sia che li avvii un utente sia un'azione pianificata. L'avviso sul contatto e l'attività li scrive il connettore senza nessuno davanti, all'applicazione del webhook: «GoCardless reports that the account was disconnected from Odoo on … (…). No collection can be taken until it is connected again.» e «GoCardless disconnected». I messaggi di un incasso seguono la stessa regola; se lo avvia un'azione pianificata, come il rinnovo di un abbonamento: «This provider is not connected to GoCardless any more: connect it again first.» e «GoCardless rejected the request.».

Cosa fare

1. Apri la transazione dalla fattura, con il pulsante «Transazione di pagamento» in alto; il menu delle transazioni compare solo in modalità sviluppatore e in Odoo 20 non esiste. Se il messaggio dice che il provider non è più connesso, o cita uno dei tre reason, il problema è la connessione, non il cliente né il suo mandato.
2. Con la connessione in due clic, apri il provider di pagamento GoCardless e riconnetti con «Connect my GoCardless account».
3. In modalità avanzata, crea un nuovo token nella Dashboard di GoCardless, incollalo in «GoCardless Access Token» e premi «Test connection». Il connettore chiede a GoCardless il creditore del tuo account con quel token: se GoCardless lo rifiuta, vedrai il suo errore in quel momento e non all'incasso successivo.
4. Con la connessione di nuovo attiva, incassa di nuovo le fatture rimaste scoperte. Le transazioni in errore non vengono reinviate da sole.
5. Se ti serve GoCardless, conserva il request_id del messaggio: la sua documentazione chiede di indicarlo quando si contatta il supporto.

Con il nostro connettore

In Odoo 17, 18, 19 e 20 il connettore non permette che un token non più valido si trasformi in una catena di incassi falliti senza spiegazioni: se GoCardless segnala la disconnessione, lo dice nell'azienda e in un'attività, e se non la segnala, ogni rifiuto riporta il reason e il request_id di GoCardless.

Continua a leggere