GoCardless total_amount_confirmation_invalid: il totale rimborsato non torna

Cosa dice GoCardless

Il riferimento dei rimborsi spiega il primo: «total_amount_confirmation_invalid if the confirmation amount doesn't match the total amount refunded for the payment.». E per cosa serve: «This safeguard is there to prevent two processes from creating refunds without awareness of each other.».

Quel campo, secondo GoCardless, è la somma dei rimborsi che il pagamento ha già più quello che si sta creando, in centesimi. Nel suo esempio, un rimborso di 100 porta un total_amount_confirmation di 150: su quel pagamento erano già stati restituiti 50.

Come calcola il connettore quella cifra

Per ogni rimborso, il connettore somma i rimborsi di quell'incasso che in Odoo risultano in attesa, autorizzati o eseguiti, e vi aggiunge il nuovo. Quelli in errore non contano. Questa somma va come total_amount_confirmation.

Che includa anche quelli in attesa conta: un rimborso in corso è già stato richiesto a GoCardless, e se non lo sommasse la cifra risulterebbe troppo bassa e GoCardless rifiuterebbe il successivo.

Quando non torna

La cifra viene da ciò che Odoo sa. Se qualcuno ha restituito denaro di quell'incasso per una strada che non passa da Odoo, per esempio con un altro programma collegato allo stesso account GoCardless, GoCardless lo ha registrato e Odoo no. Il totale inviato dal connettore risulta quindi inferiore, e GoCardless rifiuta il rimborso. È esattamente il caso per cui esiste questa salvaguardia: se lo accettasse, il cliente riceverebbe due volte lo stesso denaro.

number_of_refunds_exceeded è un'altra cosa: il connettore consente rimborsi parziali, e GoCardless ne ammette al massimo 5 per pagamento. Il sesto viene rifiutato anche se resta un importo da restituire.

Cosa fa Odoo con il connettore

In Odoo un incasso si rimborsa dal suo pagamento, con il pulsante di rimborso, e solo se la sua transazione è confermata. Il connettore invia il rimborso con la sua chiave di idempotenza e, se GoCardless lo rifiuta, la transazione del rimborso passa a «Errore» con «GoCardless rejected the request.» e, sotto, il messaggio di GoCardless con il reason e il request_id tra parentesi quadre.

Dalla versione 1.1.5, un rimborso in errore non mostra il pulsante «Retry collection»: un rimborso non è un incasso.

Cosa fare

1. Apri la transazione dell'incasso 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. Da lì, il pulsante dei rimborsi porta alla transazione del rimborso e al suo messaggio.
2. Con total_amount_confirmation_invalid, controlla nella Dashboard di GoCardless i rimborsi di quel pagamento. Se ce n'è uno eseguito fuori da Odoo, il denaro è già tornato al cliente: non restituirlo di nuovo da Odoo.
3. Con number_of_refunds_exceeded, quel pagamento non accetta più rimborsi in GoCardless. Se devi ancora restituire qualcosa, dovrà passare da un'altra via.
4. Per non arrivare al limite, raggruppa in un unico rimborso quanto da restituire su uno stesso incasso.
5. Se ti serve GoCardless, conserva 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 invia in ogni rimborso il totale di quanto rimborsato su quell'incasso, inclusi quelli in corso, così che GoCardless blocchi un rimborso doppio invece di pagarlo, e lascia il rifiuto nella transazione con il suo request_id.

Continua a leggere