GoCardless mandate_replaced : le mandat a un remplaçant

Ce que dit GoCardless

La documentation des événements l'explique ainsi : « The mandate has been cancelled and replaced by a new mandate (for example, because the creditor has moved to a new Service User Number). ». Et ce que transporte l'événement : « The event will include links[new_mandate] with the ID of the new mandate. ».

mandate_replaced est une erreur invalid_state : l'action n'est pas valable dans l'état actuel de la ressource. Pour ces erreurs, GoCardless demande d'informer l'utilisateur et de ne pas réessayer (« invalid_state → inform the end user, do not allow retry. »).

Quand cela se produit

Ce changement n'est pas provoqué par le client ni par sa banque : l'événement replaced a pour origine gocardless, et la cause documentée est que le créancier, le compte avec lequel vous encaissez dans GoCardless, est passé à un autre identifiant de schéma. GoCardless annule l'ancien mandat et en crée un nouveau à sa place.

mandate_replaced n'apparaît que si Odoo tente d'encaisser avec l'ancien mandat : l'encaissement d'un abonnement en cours de renouvellement, ou un paiement enregistré avec le moyen de paiement mémorisé du client, avant qu'Odoo n'ait appliqué l'événement.

Ce que fait Odoo avec le connecteur

Avec l'événement replaced :

1. Il prend le nouveau mandat dans links.new_mandate.
2. Il transfère au nouveau mandat le moyen de paiement mémorisé du client et le considère valide, au lieu de le considérer perdu. Si le moyen était archivé, il est réactivé ; Odoo 17 ne permet pas de désarchiver un moyen de paiement, et dans ce cas le connecteur en crée un nouveau pour le nouveau mandat.
3. Il l'écrit sur la fiche du client : « The GoCardless mandate is usable again (replaced). ».

Cette note est rédigée par le connecteur lors de l'application de l'événement, sans intervention humaine. 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 : « The GoCardless mandate is usable again (replaced). ».

Avec mandate_replaced sur un encaissement, le connecteur ne fait rien de particulier : lors de la création d'un encaissement, il ne traite à part que mandate_is_inactive. La transaction passe en « Erreur » avec le message « GoCardless rejected the request. » et, dessous, le message de GoCardless avec mandate_replaced et le request_id entre crochets. Le nouveau mandat est pris dans l'événement, et non dans l'erreur. Ce message reste en anglais, même lorsque l'encaissement est lancé depuis une interface en français.

Que faire

1. Si un encaissement reste en erreur avec mandate_replaced, 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.
2. Vérifiez sur la fiche du client si la note indiquant que le mandat est de nouveau utilisable (replaced) est présente. Si oui, le moyen de paiement pointe déjà vers le nouveau mandat.
3. Si elle n'est pas là, l'événement n'est pas encore arrivé. La tâche qui récupère chaque heure les événements manqués le fera ; si cela prend plus de temps, vérifiez que les webhooks de GoCardless parviennent bien à Odoo.
4. Une fois le moyen de paiement à jour, relancez l'encaissement de la facture.

Avec notre connecteur

Dans Odoo 17, 18, 19 et 20, le connecteur suit le nouveau mandat dès que GoCardless signale le remplacement : le client conserve son moyen de paiement, et la facture suivante est encaissée avec le mandat que GoCardless a mis en place à sa place.

À lire aussi