GoCardless total_amount_confirmation_invalid: suma zwróconych kwot się nie zgadza

Co mówi GoCardless

Dokumentacja zwrotów wyjaśnia pierwszy z nich: „total_amount_confirmation_invalid if the confirmation amount doesn't match the total amount refunded for the payment.”. Oraz po co ono jest: „This safeguard is there to prevent two processes from creating refunds without awareness of each other.”.

To pole, według GoCardless, to suma zwrotów już zapisanych przy płatności plus tworzony zwrot, w groszach. W ich przykładzie zwrot na 100 ma total_amount_confirmation równe 150: z tej płatności wcześniej zwrócono już 50.

Jak konektor liczy tę kwotę

Przy każdym zwrocie konektor sumuje zwroty tej płatności, które w Odoo są oczekujące, autoryzowane lub wykonane, i dodaje nowy. Zwroty w błędzie się nie liczą. Ta suma trafia jako total_amount_confirmation.

Liczenie także oczekujących ma znaczenie: zwrot w drodze jest już zlecony do GoCardless, więc gdyby go nie uwzględnić, kwota byłaby za niska i GoCardless odrzuciłby kolejny zwrot.

Kiedy kwota się nie zgadza

Kwota wynika z tego, co wie Odoo. Jeśli ktoś zwrócił pieniądze z tej płatności inną drogą, na przykład innym programem podłączonym do tego samego konta GoCardless, GoCardless ma to zapisane, a Odoo nie. Suma wysłana przez konektor jest wtedy za niska i GoCardless odrzuca zwrot. Dokładnie na taki przypadek działa to zabezpieczenie: gdyby zaakceptował zwrot, klient dostałby te same pieniądze dwa razy.

number_of_refunds_exceeded to coś innego: konektor pozwala na zwroty częściowe, a GoCardless przyjmuje najwyżej 5 zwrotów na płatność. Szósty zostanie odrzucony, nawet jeśli nadal pozostaje kwota do zwrotu.

Co robi Odoo z konektorem

W Odoo płatność za zlecenie zwraca się z jej poziomu, przyciskiem zwrotu, i tylko wtedy, gdy jej transakcja jest potwierdzona. Konektor wysyła zwrot z kluczem idempotentności, a jeśli GoCardless go odrzuci, transakcja zwrotu przechodzi w stan „Błąd” z komunikatem „GoCardless rejected the request.” i poniżej komunikatem GoCardless z reason oraz request_id w nawiasach kwadratowych.

Od wersji 1.1.5 zwrot w błędzie nie pokazuje przycisku „Retry collection”: zwrot to nie obciążenie.

Co zrobić

1. Otwórz transakcję obciążenia z faktury, przyciskiem „Transakcja płatnicza” u góry; menu transakcji pojawia się tylko w trybie deweloperskim, a w Odoo 20 go nie ma. Stamtąd przycisk zwrotów prowadzi do transakcji zwrotu i jej komunikatu.
2. Przy total_amount_confirmation_invalid sprawdź w Dashboardzie GoCardless zwroty tej płatności. Jeśli któryś wykonano poza Odoo, pieniądze już wróciły do klienta: nie zwracaj ich ponownie z Odoo.
3. Przy number_of_refunds_exceeded ta płatność nie przyjmuje w GoCardless więcej zwrotów. Jeśli nadal trzeba coś zwrócić, musi to pójść inną drogą.
4. Aby nie dojść do limitu, połącz w jeden zwrot wszystko, co trzeba zwrócić z tego samego obciążenia.
5. Jeśli potrzebujesz GoCardless, zachowaj request_id z komunikatu: ich dokumentacja prosi o podanie go przy kontakcie z pomocą techniczną.

Z naszym konektorem

W Odoo 17, 18, 19 i 20 konektor wysyła przy każdym zwrocie sumę zwróconych kwot z tej płatności, łącznie z tymi w drodze, aby GoCardless zatrzymał podwójny zwrot zamiast go wykonać, a odrzucenie zostawia w transakcji wraz z jej request_id.

Czytaj dalej