GoCardless internal_server_error i request_timed_out: la fallada és a GoCardless

Què diu GoCardless

GoCardless agrupa aquests reasons al tipus gocardless, el dels errors que es produeixen dins de GoCardless: «These errors occurred within GoCardless while processing your request.». La seva taula de codis HTTP diu això dels dos codis:

A la pàgina de límits, GoCardless fixa a més quant pot durar una petició: 29 segons («Request timeout 29 seconds»).

Tres casos que el connector no tracta igual

El connector espera la resposta de GoCardless fins a 30 segons en cada petició. Amb un cobrament, un reemborsament o un reintent, Odoo pot trobar-se tres situacions diferents:

• GoCardless contesta amb un 500 o un 504, amb el reason a la resposta.
• GoCardless no contesta: la connexió es talla o s'acaben els 30 segons.
• La fallada arriba en aplicar un esdeveniment, quan el connector demana a GoCardless el pagament del qual parla l'esdeveniment.

Què fa el connector

Amb un 500 o un 504. El connector només repeteix una petició quan es queda sense resposta o després d'un 429. Amb un 500 o un 504 sí que hi ha resposta, així que la dona per rebutjada. En un cobrament, la transacció passa a «Error» amb «GoCardless rejected the request.» i, a sota, el missatge de GoCardless amb el reason i el request_id entre corxetes. La tasca de cada hora no reenvia una transacció en error. Si GoCardless arribés a crear el cobrament igualment, el seu primer esdeveniment l'enllaça: cada cobrament porta a les seves metadades la referència de la transacció d'Odoo, el connector la busca amb ella i li aplica l'estat del pagament. Una transacció en error torna així a «Pendent» o passa a «Confirmat».

Sense resposta. El connector repeteix la petició una vegada, amb la mateixa clau d'idempotència. Si tampoc contesta ningú, no dona el cobrament per perdut: la transacció queda pendent amb «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 tasca de cada hora la torna a enviar amb la mateixa clau; si GoCardless ja l'havia creat, contesta 409 i el connector adopta el que ja existeix.

En aplicar un esdeveniment. Amb cada esdeveniment d'un pagament, el connector demana aquest pagament a GoCardless. Si aquesta consulta falla, el webhook contesta 500 perquè GoCardless torni a enviar l'enviament, i els esdeveniments que ja s'han aplicat no s'apliquen dues vegades. La recuperació de cada hora tampoc deixa enrere un esdeveniment que ha fallat.

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 rejected the request.» i «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

1. Obre la transacció 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. Si el missatge esmenta internal_server_error o request_timed_out, la fallada va ser de GoCardless, no del client ni del seu mandat.
2. Abans de tornar a cobrar la factura, cerca el cobrament al Dashboard de GoCardless: el connector posa com a descripció de cada cobrament la referència de la seva transacció d'Odoo. Si hi és, no cobris una altra vegada; el seu esdeveniment enllaçarà la transacció.
3. Si no hi és, torna a cobrar la factura amb el mètode de pagament desat del client. Un cobrament nou és una altra transacció, amb una altra clau d'idempotència: per això convé mirar abans.
4. Si es repeteix, escriu al suport de GoCardless amb el request_id del missatge: la seva documentació demana incloure'l en contactar amb el seu suport.

Amb el nostre connector

A Odoo 17, 18, 19 i 20 el connector separa un error de GoCardless d'una petició sense resposta: el primer queda en error amb el seu request_id, la segona queda pendent i es reenvia amb la mateixa clau, i en tots dos casos l'esdeveniment d'un cobrament que sí que existeix l'enllaça amb la seva transacció.

Continua llegint