GoCardless total_amount_confirmation_invalid: het teruggegeven totaal klopt niet

Wat GoCardless zegt

De referentie van de terugbetalingen legt de eerste uit: "total_amount_confirmation_invalid if the confirmation amount doesn't match the total amount refunded for the payment.". En waarvoor het dient: "This safeguard is there to prevent two processes from creating refunds without awareness of each other.".

Dat veld, zegt GoCardless, is de som van de terugbetalingen die de betaling al heeft plus de nieuwe die wordt aangemaakt, in centen. In hun voorbeeld heeft een terugbetaling van 100 een total_amount_confirmation van 150: van die betaling was al 50 teruggestort.

Hoe de connector dat getal berekent

Voor elke terugbetaling telt de connector de terugbetalingen van die incasso op die in Odoo in behandeling, goedgekeurd of gedaan zijn, en voegt de nieuwe toe. Die in fout tellen niet mee. Die som gaat mee als total_amount_confirmation.

Dat ook de lopende meetelt, is belangrijk: een terugbetaling die onderweg is, is al bij GoCardless aangevraagd. Als die niet werd meegeteld, zou het getal te laag zijn en zou GoCardless de volgende afwijzen.

Wanneer het niet klopt

Het getal komt uit wat Odoo weet. Als iemand geld van die incasso heeft teruggestort via een weg die niet over Odoo loopt, bijvoorbeeld met een ander programma dat op dezelfde GoCardless-rekening is aangesloten, dan staat dat bij GoCardless genoteerd en bij Odoo niet. Het totaal dat de connector stuurt, is dan te laag, en GoCardless weigert de terugbetaling. Dit is precies het geval waarvoor dit vangnet bestaat: als het de terugbetaling zou accepteren, zou de klant hetzelfde geld twee keer ontvangen.

number_of_refunds_exceeded is iets anders: de connector staat gedeeltelijke terugbetalingen toe, en GoCardless accepteert er maximaal 5 per betaling. De zesde wordt geweigerd, ook al staat er nog bedrag open om terug te betalen.

Wat Odoo met de connector doet

In Odoo wordt een incasso terugbetaald vanaf de betaling, met de knop voor terugbetaling, en alleen als de transactie bevestigd is. De connector stuurt de terugbetaling met zijn idempotentiesleutel en, als GoCardless ze weigert, gaat de transactie van de terugbetaling naar "Fout" met "GoCardless rejected the request." en daaronder het bericht van GoCardless met de reason en de request_id tussen haakjes.

Vanaf versie 1.1.5 toont een terugbetaling in fout de knop "Retry collection" niet: een terugbetaling is geen incasso.

Wat te doen

1. Open de transactie van de incasso vanuit de factuur, met de knop "Betalingstransactie" bovenaan; het menu met transacties verschijnt alleen in de ontwikkelaarsmodus, en in Odoo 20 bestaat het niet. Vanuit daar leidt de knop voor terugbetalingen naar de transactie van de terugbetaling en het bericht ervan.
2. Bij total_amount_confirmation_invalid kijk je in het Dashboard van GoCardless naar de terugbetalingen van die betaling. Als er één buiten Odoo is gedaan, is het geld al naar de klant teruggegaan: betaal het niet opnieuw terug vanuit Odoo.
3. Bij number_of_refunds_exceeded accepteert die betaling bij GoCardless geen terugbetalingen meer. Als je toch nog iets moet terugbetalen, zal dat via een andere weg moeten.
4. Om de limiet niet te bereiken, voeg je wat van één incasso terug te betalen samen in één terugbetaling.
5. Als je GoCardless nodig hebt, bewaar dan de request_id van het bericht: hun documentatie vraagt om die mee te sturen bij contact met hun support.

Met onze connector

In Odoo 17, 18, 19 en 20 stuurt de connector bij elke terugbetaling het totaal van wat van die incasso is terugbetaald, inclusief de lopende, zodat GoCardless een dubbele terugbetaling tegenhoudt in plaats van die uit te voeren, en de afwijzing zet hij in de transactie met de request_id.

Lees verder