GoCardless internal_server_error e request_timed_out: il guasto è di GoCardless

Cosa dice GoCardless

GoCardless raggruppa questi reason nel tipo gocardless, quello degli errori che si verificano dentro GoCardless: «These errors occurred within GoCardless while processing your request.». La sua tabella dei codici HTTP dice questo dei due codici:

Nella pagina dei limiti, GoCardless fissa inoltre quanto può durare una richiesta: 29 secondi («Request timeout 29 seconds»).

Tre casi che il connettore non tratta allo stesso modo

Il connettore attende la risposta di GoCardless fino a 30 secondi per ogni richiesta. Con un incasso, un rimborso o un nuovo tentativo, Odoo può trovarsi di fronte a tre situazioni diverse:

• GoCardless risponde con un 500 o un 504, con il reason nella risposta.
• GoCardless non risponde: la connessione si interrompe o scadono i 30 secondi.
• Il guasto arriva nell'applicare un evento, quando il connettore chiede a GoCardless il pagamento a cui si riferisce l'evento.

Cosa fa il connettore

Con un 500 o un 504. Il connettore ripete una richiesta solo quando resta senza risposta o dopo un 429. Con un 500 o un 504 la risposta c'è, quindi la considera rifiutata. In un incasso, la transazione passa a «Errore» con «GoCardless rejected the request.» e, sotto, il messaggio di GoCardless con il reason e il request_id tra parentesi quadre. L'attività oraria non reinvia una transazione in errore. Se GoCardless creasse comunque l'incasso, il suo primo evento lo collega: ogni incasso porta nei propri metadati il riferimento della transazione di Odoo, il connettore lo cerca con esso e applica lo stato del pagamento. Una transazione in errore torna così «In sospeso» oppure passa a «Confermato».

Senza risposta. Il connettore ripete la richiesta una volta, con la stessa chiave di idempotenza. Se nemmeno così risponde nessuno, non considera perso l'incasso: la transazione resta in sospeso con «GoCardless did not answer, so it is not known yet whether it took the request. It will be sent again, safely, within the hour.». L'attività oraria la reinvia con la stessa chiave; se GoCardless l'aveva già creata, risponde 409 e il connettore adotta ciò che esiste già.

Nell'applicare un evento. Per ogni evento di un pagamento, il connettore chiede quel pagamento a GoCardless. Se questa richiesta fallisce, il webhook risponde 500 così che GoCardless reinvii l'invio, e gli eventi già applicati non vengono applicati due volte. Il recupero orario non lascia indietro nemmeno un evento fallito.

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 rejected the request.» e «GoCardless did not answer, so it is not known yet whether it took the request. It will be sent again, safely, within the hour.».

Cosa fare

1. Apri la transazione dalla fattura, con il pulsante «Transazione di pagamento» in alto; il menu delle transazioni compare solo in modalità sviluppatore e in Odoo 20 non esiste. Se il messaggio cita internal_server_error o request_timed_out, il guasto è di GoCardless, non del cliente né del suo mandato.
2. Prima di incassare di nuovo la fattura, cerca l'incasso nella Dashboard di GoCardless: il connettore indica come descrizione di ogni incasso il riferimento della propria transazione di Odoo. Se c'è, non incassare di nuovo; il suo evento collegherà la transazione.
3. Se non c'è, incassa di nuovo la fattura con il metodo di pagamento salvato del cliente. Un nuovo incasso è un'altra transazione, con un'altra chiave di idempotenza: per questo conviene controllare prima.
4. Se il problema si ripete, scrivi al supporto di GoCardless con il request_id del messaggio: la loro documentazione chiede di includerlo quando si contatta il supporto.

Con il nostro connettore

In Odoo 17, 18, 19 e 20 il connettore distingue un errore di GoCardless da una richiesta senza risposta: il primo finisce in errore con il suo request_id, la seconda resta in sospeso e viene reinviata con la stessa chiave, e in entrambi i casi l'evento di un incasso già esistente lo collega alla sua transazione.

Continua a leggere