Erreur mandate_is_inactive de GoCardless lors de la création d'un encaissement depuis Odoo

Ce que dit GoCardless

GoCardless sépare les deux parties du texte par un tiret. Les erreurs invalid_state signifient, selon GoCardless, que l'action n'est pas valable dans l'état actuel de la ressource. Ici, la ressource est le mandat : annulé, échoué ou expiré, il n'accepte plus d'encaissements.

Comment on arrive à cette erreur

En général, Odoo apprend qu'un mandat n'est plus valable grâce à un événement GoCardless avant de tenter un encaissement. Cette erreur apparaît lorsque ce n'est pas le cas : l'avis n'est pas arrivé ou est arrivé trop tard, ou le mandat a été annulé juste avant l'encaissement. L'encaissement peut provenir d'un abonnement qui se renouvelle ou d'un paiement enregistré avec le moyen de paiement mémorisé du client. Les avis de GoCardless arrivent par webhook : avec la connexion en deux clics, via FlexigoTech Cloud ; en mode avancé, vers le endpoint que vous avez créé vous-même dans le Dashboard de GoCardless. Si ce chemin échoue, Odoo ne l'apprend pas à temps.

Ce que fait le connecteur

Sans traitement spécifique, vous verriez l'erreur telle quelle, avec le texte de l'API, et le mandat continuerait d'être proposé pour la facture suivante. Le connecteur fait autre chose :

1. Il reconnaît le reason mandate_is_inactive dans la réponse.
2. Il interroge GoCardless sur ce mandat pour confirmer son état.
3. S'il est annulé, échoué, expiré, consommé ou bloqué, il l'archive dans Odoo. Si c'est la première information sur ce mandat invalide, il l'écrit sur la fiche du client, avec l'état du mandat entre parenthèses (« The GoCardless direct debit mandate of … is no longer usable (cancelled). No further collection can be taken against it. Ask the customer to set up a new mandate. »), et crée l'activité « GoCardless mandate lost ».
4. Il fait passer la transaction à « Erreur » avec son propre message, au lieu de l'erreur brute : « The customer's GoCardless mandate is …, so it cannot be charged. Ask the customer for a new mandate. ».

Si le mandat s'avère actif, le connecteur n'y touche pas et la transaction affiche l'erreur de GoCardless : « GoCardless rejected the request. » suivi du message de l'API et de son request_id. Le même traitement s'applique au bouton de relance d'un encaissement lorsque GoCardless répond mandate_is_inactive.

Le connecteur n'est pas traduit en français : ses messages et libellés sortent toujours en anglais, même dans un Odoo en français. Lorsqu'un encaissement est lancé par une action planifiée, comme le renouvellement d'un abonnement, ces messages s'affichent sans que personne n'intervienne, et ils sont alors en anglais, comme indiqué ci-dessus.

Pourquoi il ne faut pas réessayer

GoCardless l'indique dans la description des erreurs invalid_state : il faut informer l'utilisateur et ne pas le laisser réessayer. Un mandat annulé ne redevient pas actif parce qu'on insiste ; il faut une nouvelle signature du client ou, dans certains cas et seulement avec des autorisations spéciales de GoCardless, une réactivation.

Que faire

• Consultez le message de la transaction et la note du connecteur sur la fiche du client. La transaction s'ouvre 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. Les deux textes indiquent l'état du mandat.
• Demandez au client un nouveau mandat et encaissez avec lui la facture en attente.
• Si cela arrive souvent, vérifiez que les webhooks de GoCardless parviennent bien à votre Odoo : ce sont eux qui préviennent avant l'encaissement. Malgré tout, le connecteur demande toutes les heures les événements qui auraient été perdus.

Avec notre connecteur

Dans Odoo 17, 18, 19 et 20, le connecteur transforme une erreur d'API en une tâche claire : le mandat invalide disparaît de la liste des moyens de paiement, le client est averti sur sa fiche et la facture reste en attente jusqu'à ce qu'un mandat fonctionnel soit disponible.

À lire aussi