GoCardless refer_to_payer: MS02, MS03, RR04 i SL01 w polecie SEPA

Jedna przyczyna, cztery kody

Wszystkie trzy wiersze pochodzą z tabeli nieudanych płatności (payments · failed) w dokumentacji GoCardless dla SEPA Core. W przeciwieństwie do innych przyczyn żadna z nich nie mówi, że mandat zostaje anulowany: klient nadal jest upoważniony do obciążeń, mimo że to konkretne obciążenie nie przeszło.

Co kryje się za każdym kodem

MS02 jest najbardziej jednoznaczną odpowiedzią: klient powiedział swojemu bankowi, żeby nie realizował tej składki. Konektor zapisał w komentarzu do kodu, że to kombinacja, którą zaobserwował w testowej płatności SEPA w sandboksie GoCardless. MS03 i RR04 są odwrotnością: płatność nie przechodzi, a bank nie podaje powodu, zwykle z przyczyn regulacyjnych, więc jedynym sposobem, by się dowiedzieć, co się dzieje, jest zapytanie klienta. SL01 wskazuje na konto: jego bank ogranicza obciążenia, które można na nie nałożyć, a zmienić to może tylko właściciel konta w swoim banku.

W przypadku MS02, RR04 i SL01 ponowne przedstawienie polecenia bez wcześniejszej rozmowy z klientem zwykle kończy się tak samo i może wiązać się z kolejną opłatą. MS03 ma wyjątek: według przewodnika Success+ w Austrii, Belgii, Niemczech, Luksemburgu i na Słowacji MS03 liczy się jako brak środków i Success+ może je ponowić. Jeśli tak jest, zdarzenie przychodzi z will_attempt_retry ustawionym na true.

Co robi Odoo z konektorem

Transakcję otwiera się z faktury, przyciskiem „Transakcja płatnicza” u góry; menu transakcji widoczne jest tylko w trybie deweloperskim, a w Odoo 20 w ogóle nie istnieje. Konektor zapisuje przyczynę w polu „GoCardless Cause”, a nie kod SEPA, i wyświetla: „GoCardless could not collect this payment (refer_to_payer).”. Dalej postępuje zgodnie z treścią zdarzenia:

• Jeśli will_attempt_retry ma wartość true, transakcja otrzymuje status „Oczekujące”, zaznaczane jest pole „Success+ Will Retry” i komunikat brzmi: „Success+ will retry it automatically; there is nothing to do.”. Przycisk ponowienia się nie pojawia.
• W przeciwnym razie transakcja przechodzi w stan „Błąd” i pojawia się przycisk „Retry collection”, o ile pozostały próby. Jeśli Odoo uznało już obciążenie za zrealizowane, konektor anuluje jego płatność, a faktura wraca do stanu oczekującej na zapłatę.
• Mandat pozostaje bez zmian. refer_to_payer nie znajduje się wśród przyczyn, dla których konektor archiwizuje mandat, więc metoda płatności klienta pozostaje dostępna przy kolejnym obciążeniu.

Ten ostatni punkt jest celowy: archiwizowanie mandatu z powodu jednorazowego odrzucenia zmusiłoby klienta do podpisania nowego bez powodu.

Oba komunikaty zapisuje konektor podczas stosowania zdarzenia, bez udziału człowieka. W bazie danych utworzonej po polsku również wyświetlają się w języku angielskim, ponieważ konektor nie jest przetłumaczony na polski i te teksty zawsze są w języku angielskim: „GoCardless could not collect this payment (refer_to_payer).” oraz „Success+ will retry it automatically; there is nothing to do.”.

Co zrobić zależnie od kodu

Odoo nie informuje, który z czterech kodów nadszedł: konektor zapisuje tylko przyczynę. Kod zobaczysz w GoCardless. Według ich centrum pomocy powód każdej porażki widać na osi czasu płatności w Dashboardzie („You are able to view the reason for a payment failure in the status timeline of the payment in your GoCardless dashboard.”). W trybie zaawansowanym dokładny kod znajduje się też w zdarzeniu (details.reason_code), a Dashboard przechowuje wysyłki webhooków z ostatnich 3 miesięcy w Developers > Webhooks wraz z ich treścią.

Gdy klient potwierdzi, że obciążenie przejdzie, użyj w transakcji przycisku „Retry collection” i potwierdź ostrzeżenie o opłacie. Konektor odpowie „Retry requested. GoCardless will confirm the new charge date.” i zostawi transakcję w stanie oczekującym. Pamiętaj o limicie: płatność można ponowić najwyżej 3 razy („Payments can be retried up to 3 times.”).

Z naszym konektorem

W Odoo 17, 18, 19 i 20 konektor zamienia refer_to_payer w nieopłaconą fakturę z widoczną przyczyną i mandatem, który nadal obowiązuje. Nie zgaduje kodu SEPA: Odoo zapisuje przyczynę w transakcji, a kod sprawdzasz w GoCardless. Decyzja o ponownym obciążeniu należy do ciebie, po rozmowie z klientem.

Czytaj dalej