GoCardless refer_to_payer: MS02, MS03, RR04 i SL01 en un cobrament SEPA

Una causa, quatre codis

Les tres files provenen de la taula de fallades de pagament (payments · failed) de la documentació de GoCardless per a SEPA Core. A diferència d'altres causes, cap no diu que el mandat es cancel·li: el client continua autoritzat perquè li cobris, encara que aquest adeudament concret no hagi passat.

Què hi ha darrere de cada codi

MS02 és la resposta més clara: el client va dir al seu banc que no pagués aquell rebut. El connector anota al seu codi que és la combinació que va veure en un pagament SEPA de prova del sandbox de GoCardless. MS03 i RR04 són el contrari: el pagament falla i el banc no dona el motiu, normalment per raons regulatòries, així que l'única manera de saber què passa és preguntar al client. SL01 apunta al compte: el seu banc limita els adeudaments directes que se li poden carregar, i això només ho pot canviar el titular amb el seu banc.

Amb MS02, RR04 i SL01, tornar a presentar l'adeudament sense parlar abans amb el client sol acabar igual i pot costar una altra comissió. MS03 té una excepció: segons la guia de Success+, a Àustria, Bèlgica, Alemanya, Luxemburg i Eslovàquia MS03 compta com a falta de fons, i Success+ el pot reintentar. Si és així, l'esdeveniment arriba amb will_attempt_retry a true.

Què fa Odoo amb el connector

La transacció s'obre des de la factura, amb el botó «Transacció de pagament» de dalt; el menú de transaccions només surt en mode desenvolupador, i a Odoo 20 no existeix. El connector guarda la causa al camp «GoCardless Cause», no el codi SEPA, i mostra «GoCardless could not collect this payment (refer_to_payer).». Després segueix el que digui l'esdeveniment:

• Si will_attempt_retry ve a true, la transacció queda «Pendent», la casella «Success+ Will Retry» es marca i el missatge ho diu: «Success+ will retry it automatically; there is nothing to do.». El botó de reintentar no surt.
• Si no, la transacció passa a «Error» i surt el botó «Retry collection», si queden reintents. Si Odoo ja donava el cobrament per fet, el connector anul·la el seu pagament i la factura torna a estar pendent de cobrament.
• El mandat no es toca. refer_to_payer no és entre les causes amb què el connector arxiva un mandat, així que el mètode de pagament del client continua disponible per al següent cobrament.

Aquest últim punt és deliberat: arxivar el mandat per un rebuig puntual obligaria el client a signar-ne un altre sense motiu.

Els dos missatges els escriu el connector en aplicar l'esdeveniment, sense ningú al davant. El connector no està traduït al català: aquests textos surten sempre en anglès, també en un Odoo en català, tant si els llança un usuari com una tasca programada: «GoCardless could not collect this payment (refer_to_payer).» i «Success+ will retry it automatically; there is nothing to do.».

Què fer segons el codi

Odoo no et diu quin dels quatre codis va arribar: el connector només guarda la causa. El codi el veus a GoCardless. Segons el seu centre d'ajuda, el motiu de cada fallada surt a la cronologia del pagament, al Dashboard («You are able to view the reason for a payment failure in the status timeline of the payment in your GoCardless dashboard.»). En el mode avançat, el codi exacte també va a l'esdeveniment (details.reason_code), i el Dashboard guarda els enviaments dels últims 3 mesos a Developers > Webhooks, amb el seu contingut.

Quan el client confirmi que el cobrament passarà, usa «Retry collection» a la transacció i confirma l'avís de la comissió. El connector respon «Retry requested. GoCardless will confirm the new charge date.» i la deixa pendent. Recorda el límit: un pagament es pot reintentar com a màxim 3 vegades («Payments can be retried up to 3 times.»).

Amb el nostre connector

A Odoo 17, 18, 19 i 20 el connector converteix refer_to_payer en una factura pendent amb la causa a la vista i un mandat que continua valent. No endevina el codi SEPA: Odoo guarda la causa a la transacció, i el codi el consultes a GoCardless. La decisió de tornar a cobrar és teva, després de parlar amb el client.

Continua llegint