GoCardless refund_payment_invalid_state : ce prélèvement ne peut pas encore être remboursé

Ce que dit GoCardless

Dans la référence des remboursements, GoCardless ajoute un délai : « A refund can only be created once it is outside the safer refund period (7 calendar days after the charge date) otherwise an error is returned. ». Cette période peut être désactivée : « The safer refund period can be disabled by contacting GoCardless. ». Et il rappelle pourquoi elle existe : « A payment that has been (partially) refunded can still receive a late failure or chargeback from the customer's bank. ».

Les remboursements par l'API, par ailleurs, sont désactivés par défaut : « This endpoint is disabled by default. To enable it, you will need to enable refunds on your GoCardless Dashboard. ».

Les règles de délai, en un coup d'œil

Les deux ne comptent pas à partir du même point. GoCardless compte à partir de la date de débit du paiement. Le connecteur compte à partir du dernier changement d'état de la transaction du prélèvement dans Odoo. Si GoCardless a retiré la période sécurisée, entre 2 et 7 jours le remboursement peut aboutir.

Quand refund_payment_invalid_state apparaît avec le connecteur

Odoo ne permet de rembourser qu'une transaction confirmée, et le connecteur la confirme lorsque GoCardless indique confirmed ou paid_out. Ce reason signifie donc que le paiement a changé chez GoCardless et qu'Odoo ne le sait pas encore : un échec tardif, que GoCardless peut communiquer alors que le paiement est déjà confirmé, ou un remboursement demandé par le client dont l'événement n'est pas encore arrivé.

Ce que fait le connecteur

1. En dessous de 2 jours, il n'envoie rien : Odoo s'arrête avec « GoCardless cannot refund a collection until it has settled. This one was charged … day(s) ago; refunds are possible after 2 days. ».
2. Sinon, il envoie le remboursement à GoCardless avec sa clé d'idempotence. Si GoCardless le rejette, pour ce reason, pour la période sécurisée ou pour tout autre motif, la transaction de remboursement passe à « Erreur » avec « GoCardless rejected the request. » et, dessous, le message de GoCardless avec le reason et le request_id.
3. S'il l'accepte, la transaction reste « En attente » avec « Refund submitted. GoCardless will deduct it from a future payout. », puis passe à « Confirmé » lorsque GoCardless le paie ou le déduit d'un versement.

Depuis la version 1.1.5, un remboursement en erreur n'affiche pas le bouton « Retry collection » : un remboursement n'est pas un prélèvement, et GoCardless n'a rien à réessayer. Si GoCardless ne parvient pas à rendre l'argent au client, le connecteur passe le remboursement en erreur avec « GoCardless could not pay this refund back (…). ». 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 could not pay this refund back (…). ».

Que faire

1. Ouvrez la transaction du prélèvement 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. Depuis là, le bouton de remboursements mène à la transaction du remboursement et à son message.
2. Si le reason est refund_payment_invalid_state, consultez le paiement dans le Dashboard GoCardless. Si l'échec est tardif ou si le client a demandé un remboursement, il n'y a rien à rembourser : l'argent n'est plus chez vous. Odoo le reflétera à l'arrivée de l'événement ; la tâche qui récupère chaque heure les événements manqués le fera.
3. Si le refus vient de la période sécurisée, attendez 7 jours après la date de débit, ou demandez à GoCardless de la retirer.
4. Pour rembourser à nouveau, faites-le depuis le paiement du prélèvement, avec son bouton de remboursement. Le connecteur accepte les remboursements partiels.

Avec notre connecteur

Dans Odoo 17, 18, 19 et 20, le connecteur n'envoie pas de remboursements de prélèvements de moins de 2 jours, consigne en erreur, avec leur request_id, ceux que GoCardless rejette, et ne propose pas de réessayer un remboursement, qui n'est pas un prélèvement.

À lire aussi