GoCardless 409 idempotent_creation_conflict: l'addebito esisteva già

Cosa dice GoCardless

La pagina dei limiti di GoCardless lo completa: se esiste già una risorsa con quella chiave, la risposta è un 409 con links.conflicting_resource_id, che indica la risorsa già creata. Le chiavi possono avere fino a 128 caratteri e GoCardless le ricorda per almeno 30 giorni.

Il problema che risolve

Una richiesta può richiedere tempo: GoCardless interrompe quelle che superano i 29 secondi, e la rete può cadere prima. Se Odoo richiede un addebito e non riceve risposta, non sa se GoCardless lo ha creato. Ripetere la richiesta senza altro è pericoloso; la stessa documentazione di GoCardless avverte che riprovare senza chiave di idempotenza dopo un timeout scaduto può addebitare due volte lo stesso pagamento.

Con la chiave, il secondo tentativo non crea nulla: se il primo è arrivato, GoCardless risponde con questo 409 e l'identificativo dell'addebito già esistente.

Come lo usa il connettore

Il connettore invia una chiave di idempotenza in ogni richiesta che crea un addebito, un rimborso, un nuovo tentativo o la richiesta del mandato. La chiave non è casuale. Viene calcolata con l'operazione, la transazione di Odoo e l'identificativo del database, in modo che:

• ripetere lo stesso addebito invii esattamente la stessa chiave;
• una copia del database per i test non entri in conflitto con quella di produzione, anche se entrambe emettono la stessa fattura.

Quando arriva il 409, il connettore legge conflicting_resource_id, richiede quella risorsa a GoCardless e la adotta come risposta. Per te non c'è alcun errore: la transazione risulta collegata all'addebito già esistente, e la fattura prosegue il suo corso normale.

Quando GoCardless non risponde

Se la richiesta resta senza risposta, il connettore la ripete una volta con la stessa chiave. Senza chiave non ripete nulla. Se anche così non c'è risposta, segnala la situazione senza dare l'addebito per perso: «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 transazione resta in sospeso, non in errore, perché in errore Odoo potrebbe generare un altro addebito con un altro riferimento e un'altra chiave.

Il connettore non è tradotto in italiano: questi testi compaiono sempre in inglese, anche in un Odoo in italiano, sia che li avvii un utente sia un'azione pianificata: «GoCardless did not answer, so it is not known yet whether it took the request. It will be sent again, safely, within the hour.». Un'azione pianificata, come il rinnovo di un abbonamento o il reinvio del connettore stesso, scrive il messaggio senza nessuno davanti.

Cosa fare

Con il connettore, di solito, nulla: il 409 si risolve da solo. Se lo vedi in un altro programma collegato allo stesso account GoCardless, verifica due cose. La prima, che non stai riutilizzando una chiave per operazioni diverse. La seconda, che la risorsa indicata in conflicting_resource_id sia quella che ti aspettavi: se lo è, il nuovo tentativo ha funzionato come doveva. Se non lo è, conserva il request_id della risposta: GoCardless chiede di includerlo quando contatti il suo supporto, e il connettore lo aggiunge ai suoi messaggi di errore.

Con il nostro connettore

In Odoo 17, 18, 19 e 20 il connettore applica la regola che GoCardless richiede per non addebitare due volte: chiave fissa per operazione, ripetizione solo con la stessa chiave e adozione della risorsa esistente quando arriva il 409.

Continua a leggere