GoCardless 409 idempotent_creation_conflict: el cobrament ja existia

Què diu GoCardless

La pàgina de límits de GoCardless ho completa: si ja existeix un recurs amb aquesta clau, la resposta és un 409 amb links.conflicting_resource_id, que assenyala el recurs que ja està creat. Les claus poden tenir fins a 128 caràcters i GoCardless les recorda almenys 30 dies.

El problema que resol

Una petició pot tardar: GoCardless talla les que passen de 29 segons, i la xarxa pot caure abans. Si Odoo demana un cobrament i no rep resposta, no sap si GoCardless l'ha creat. Repetir la petició sense més és perillós; la pròpia documentació de GoCardless avisa que reintentar sense clau d'idempotència després d'un temps d'espera esgotat pot cobrar el mateix pagament dos cops.

Amb clau, el segon intent no crea res: si el primer ha arribat, GoCardless contesta amb aquest 409 i l'identificador del cobrament que ja existeix.

Com l'usa el connector

El connector envia una clau d'idempotència a cada petició que crea un cobrament, un reemborsament, un reintent o la sol·licitud del mandat. La clau no és aleatòria. Es calcula amb l'operació, la transacció d'Odoo i l'identificador de la base de dades, de manera que:

• repetir el mateix cobrament envia exactament la mateixa clau;
• una còpia de la base per a proves no xoca amb la de producció encara que les dues emetin la mateixa factura.

Quan arriba el 409, el connector llegeix conflicting_resource_id, demana aquest recurs a GoCardless i l'adopta com a resposta. Per a tu no hi ha error: la transacció queda enllaçada al cobrament que ja existia, i la factura segueix el seu curs normal.

Quan GoCardless no contesta

Si la petició es queda sense resposta, el connector la repeteix una vegada amb la mateixa clau. Sense clau no repeteix res. Si tampoc hi ha resposta, avisa sense donar el cobrament per perdut: «GoCardless did not answer, so it is not known yet whether it took the request. It will be sent again, safely, within the hour.». La transacció queda pendent, no en error, perquè en error Odoo podria generar un altre cobrament amb una altra referència i una altra clau.

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, com la renovació d'una subscripció o el reenviament del propi connector: «GoCardless did not answer, so it is not known yet whether it took the request. It will be sent again, safely, within the hour.».

Què fer

Amb el connector, normalment res: el 409 es resol sol. Si el veus en un altre programa connectat al mateix compte de GoCardless, comprova dues coses. La primera, que no estiguis reutilitzant una clau per a operacions diferents. La segona, que el recurs de conflicting_resource_id sigui el que esperaves: si ho és, el reintent ha funcionat com cal. Si no ho és, guarda el request_id de la resposta: GoCardless demana incloure'l en contactar amb el seu suport, i el connector l'afegeix als seus missatges d'error.

Amb el nostre connector

A Odoo 17, 18, 19 i 20 el connector aplica la regla que GoCardless demana per no cobrar dos cops: clau fixa per operació, repetició només amb la mateixa clau i adopció del recurs existent quan arriba el 409.

Continua llegint