GoCardless 429 rate_limit_exceeded : trop de requêtes par minute

Ce que dit GoCardless

La page des limites de GoCardless donne le chiffre : 1 600 requêtes par minute dans une intégration standard, et 1 600 par minute et par marchand dans une intégration partenaire. Au-delà, l'API renvoie le 429, et GoCardless précise que ces requêtes peuvent être renvoyées sans problème : « These requests are safe to retry. ». Pour savoir quand, il renvoie aux en-têtes de la réponse : ratelimit-limit, ratelimit-remaining et ratelimit-reset.

D'où viennent tant de requêtes

La limite compte toutes les requêtes adressées à l'API, pas seulement celles qui créent des prélèvements. Avec le connecteur, chaque prélèvement sur un mandat enregistré est une requête, qu'il provienne d'un abonnement qui se renouvelle ou d'un paiement enregistré avec le moyen de paiement du client. Chaque événement de paiement qui arrive dans Odoo en est une autre, car le connecteur ne se fie pas seulement à la notification : il demande ce paiement à GoCardless et applique l'état qu'il lui renvoie. Un lot important au même moment, comme de nombreux renouvellements simultanés pendant que arrivent les événements des prélèvements précédents, additionne les deux.

GoCardless classe ce reason parmi les erreurs invalid_api_usage, celles qui viennent de la manière dont la requête est faite, et pour celles-ci il demande d'alerter l'équipe technique (« alert your dev team »). Un 429 isolé n'en a pas besoin ; un rejet qui se répète chaque jour, si.

Ce que fait le connecteur

1. Il lit l'en-tête ratelimit-reset et calcule le temps restant : l'heure indiquée moins celle du serveur Odoo.
2. Il attend ce délai, au minimum 1 seconde et au maximum 65. Si l'en-tête est absent ou illisible, il attend 1 seconde. Le plafond existe pour qu'une horloge mal réglée ne bloque pas indéfiniment le processus Odoo qui attend.
3. Il répète la requête une seule fois.
4. Si la répétition reçoit de nouveau un 429, il n'attend plus : il la traite comme n'importe quel autre rejet de l'API.

Le connecteur ne compte pas ses requêtes et ne les freine pas à l'avance. Il ne lit pas ratelimit-remaining : il n'attend que lorsque GoCardless a déjà répondu 429.

Si la deuxième tentative échoue aussi

Cela dépend de ce qu'Odoo était en train de faire à ce moment-là.

• S'il s'agissait d'un prélèvement, la transaction passe en « Erreur » avec « GoCardless rejected the request. » et, dessous, le message de GoCardless avec rate_limit_exceeded et le request_id entre crochets. La facture reste à encaisser.
• S'il appliquait un événement de GoCardless, le webhook répond 500 afin que GoCardless renvoie l'envoi, et les événements déjà appliqués ne le sont pas deux fois. La récupération horaire ne laisse pas non plus un événement en échec de côté : elle le redemande lors du passage suivant.

Un 429 n'est pas la même chose qu'un prélèvement sans réponse. Sans réponse, le connecteur ne sait pas si GoCardless a créé le prélèvement : il le laisse en attente et le renvoie, avec la même clé, dans moins d'une heure. Avec un 429, il y a bien une réponse : GoCardless n'a pas accepté la requête, et c'est pourquoi la transaction passe en erreur.

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, comme le renouvellement d'un abonnement : « GoCardless rejected the request. ».

Que faire

• 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 mentionne rate_limit_exceeded, GoCardless a rejeté cette requête à cause de la limite, et non à cause du client ou de son mandat.
• Après un moment, encaissez de nouveau la facture avec le moyen de paiement enregistré du client.
• Si cela vous arrive souvent, vérifiez l'heure du serveur Odoo : le délai d'attente se calcule en soustrayant celle de ratelimit-reset, et une horloge en avance le raccourcit.
• Si vous devez contacter GoCardless, gardez le request_id du message : leur documentation demande de l'inclure lorsque vous contactez leur support.

Avec notre connecteur

Dans Odoo 17, 18, 19 et 20, le connecteur traite le 429 comme une pause : il attend ce que demande GoCardless, répète une fois et, si la limite persiste, laisse la transaction en erreur avec le request_id afin que vous sachiez ce qui s'est passé et ce que vous pouvez transmettre à GoCardless.

À lire aussi