GoCardless internal_server_error et request_timed_out : la panne vient de GoCardless

Ce que dit GoCardless

GoCardless regroupe ces reasons dans le type gocardless, celui des erreurs survenues à l'intérieur de GoCardless : « These errors occurred within GoCardless while processing your request. ». Sa table des codes HTTP dit ceci de ces deux codes :

Sur la page des limites, GoCardless fixe par ailleurs la durée maximale d'une requête : 29 secondes (« Request timeout 29 seconds »).

Trois cas que le connecteur ne traite pas de la même façon

Le connecteur attend la réponse de GoCardless jusqu'à 30 secondes pour chaque requête. Lors d'un encaissement, d'un remboursement ou d'une nouvelle tentative, Odoo peut se trouver face à trois situations différentes :

• GoCardless répond par un 500 ou un 504, avec le reason dans la réponse.
• GoCardless ne répond pas : la connexion est coupée ou les 30 secondes sont écoulées.
• La panne survient lors du traitement d'un événement, quand le connecteur demande à GoCardless le paiement auquel se rapporte l'événement.

Ce que fait le connecteur

Avec un 500 ou un 504. Le connecteur ne répète une requête que lorsqu'elle reste sans réponse, ou après un 429. Avec un 500 ou un 504, il y a une réponse, donc il la considère comme un rejet. Pour un encaissement, la transaction passe en « Erreur » avec « GoCardless rejected the request. » et, en dessous, le message de GoCardless avec le reason et le request_id entre crochets. La tâche horaire ne renvoie pas une transaction en erreur. Si GoCardless créait tout de même l'encaissement, son premier événement le relie : chaque encaissement porte dans ses métadonnées la référence de la transaction Odoo, le connecteur la recherche et applique l'état du paiement. Une transaction en erreur repasse ainsi en « En attente » ou passe en « Confirmé ».

Sans réponse. Le connecteur répète la requête une fois, avec la même clé d'idempotence. Si personne ne répond toujours, il ne considère pas l'encaissement comme perdu : la transaction reste en attente avec « GoCardless did not answer, so it is not known yet whether it took the request. It will be sent again, safely, within the hour. ». La tâche horaire la renvoie avec la même clé ; si GoCardless l'avait déjà créée, il répond 409 et le connecteur adopte ce qui existe déjà.

Lors du traitement d'un événement. Pour chaque événement d'un paiement, le connecteur demande ce paiement à GoCardless. Si cette consultation échoue, le webhook répond 500 pour que GoCardless renvoie l'envoi, et les événements déjà appliqués ne sont pas appliqués deux fois. La récupération horaire ne laisse pas non plus un événement en échec de côté.

Le connecteur n'est pas traduit en français : ces textes apparaissent toujours en anglais, même dans un Odoo en français, qu'ils soient déclenchés par un utilisateur ou par une action planifiée : « GoCardless rejected the request. » et « GoCardless did not answer, so it is not known yet whether it took the request. It will be sent again, safely, within the hour. ».

Que faire

1. Ouvrez la transaction depuis la facture, avec le bouton « Transaction de paiement » en haut ; le menu des transactions n'apparaît qu'en mode développeur, et il n'existe pas dans Odoo 20. Si le message cite internal_server_error ou request_timed_out, la panne vient de GoCardless, et non du client ni de son mandat.
2. Avant de réencaisser la facture, cherchez l'encaissement dans le Dashboard de GoCardless : le connecteur met comme description de chaque encaissement la référence de sa transaction Odoo. S'il est là, n'encaissez pas une seconde fois ; son événement reliera la transaction.
3. S'il n'y est pas, réencaissez la facture avec le moyen de paiement enregistré du client. Un nouvel encaissement est une autre transaction, avec une autre clé d'idempotence : d'où l'intérêt de vérifier avant.
4. Si l'erreur se répète, écrivez au support de GoCardless avec le request_id du message : leur documentation demande de l'inclure lorsqu'on les contacte.

Avec notre connecteur

Dans Odoo 17, 18, 19 et 20, le connecteur distingue une erreur de GoCardless d'une requête sans réponse : la première passe en erreur avec son request_id, la seconde reste en attente et est renvoyée avec la même clé, et dans les deux cas l'événement d'un encaissement qui existe bel et bien le relie à sa transaction.

À lire aussi