GoCardless mandate_replaced: mandat ma swojego następcę

Co mówi GoCardless

Dokumentacja zdarzeń wyjaśnia to tak: „The mandate has been cancelled and replaced by a new mandate (for example, because the creditor has moved to a new Service User Number).”. A zdarzenie zawiera: „The event will include links[new_mandate] with the ID of the new mandate.”.

mandate_replaced to błąd invalid_state: operacja nie jest dozwolona w bieżącym stanie zasobu. Przy takich błędach GoCardless zaleca poinformować użytkownika i nie ponawiać próby („invalid_state → inform the end user, do not allow retry.”).

Kiedy się pojawia

Zmiany nie powoduje klient ani jego bank: zdarzenie replaced ma źródło gocardless, a udokumentowaną przyczyną jest to, że wierzyciel, czyli konto, przez które pobierasz płatności w GoCardless, przeszedł na inny identyfikator schematu. GoCardless anuluje stary mandat i tworzy nowy w jego miejsce.

mandate_replaced pojawia się tylko wtedy, gdy Odoo próbuje obciążyć stary mandat: przy odnawianiu subskrypcji albo przy płatności zarejestrowanej zapisaną metodą płatności klienta, zanim Odoo zastosuje zdarzenie.

Co robi Odoo z konektorem

Po zdarzeniu replaced:

1. Pobiera nowy mandat z links.new_mandate.
2. Przypisuje do tego mandatu zapisaną metodę płatności klienta i uznaje ją za poprawną, zamiast uznać ją za utraconą. Jeśli metoda była zarchiwizowana, zostaje reaktywowana; w Odoo 17 nie można odarchiwizować metody płatności, więc wtedy konektor tworzy nową dla nowego mandatu.
3. Zapisuje to w karcie klienta: „The GoCardless mandate is usable again (replaced).”.

Tę notatkę konektor zapisuje przy stosowaniu zdarzenia, bez udziału użytkownika. W bazie danych założonej po polsku widnieje ona w tym samym języku, co konektor: „The GoCardless mandate is usable again (replaced).”.

Przy mandate_replaced w obciążeniu konektor nie robi nic szczególnego: przy tworzeniu obciążenia wyodrębnia tylko mandate_is_inactive. Transakcja przechodzi w stan „Błąd” z komunikatem „GoCardless rejected the request.” i poniżej z komunikatem GoCardless z mandate_replaced oraz request_id w nawiasach kwadratowych. Nowy mandat pobiera ze zdarzenia, a nie z błędu. Ten komunikat pojawia się w języku osoby uruchamiającej obciążenie; jeśli uruchamia je zaplanowane działanie, w bazie założonej po angielsku i przełączonej potem na polski zostaje po angielsku: „GoCardless rejected the request.”.

Co zrobić

1. Jeśli obciążenie zostało z błędem mandate_replaced, otwórz transakcję z faktury, przyciskiem „Transakcja płatnicza” u góry; menu transakcji jest widoczne tylko w trybie deweloperskim, a w Odoo 20 nie istnieje.
2. Sprawdź w karcie klienta, czy jest już notatka, że mandat można ponownie użyć (replaced). Jeśli jest, metoda płatności wskazuje już nowy mandat.
3. Jeśli jej nie ma, zdarzenie jeszcze nie dotarło. Zadanie, które co godzinę odzyskuje zgubione zdarzenia, je przywróci; jeśli trwa to dłużej, sprawdź, czy webhooki GoCardless docierają do Odoo.
4. Gdy metoda płatności jest aktualna, ponów obciążenie faktury.

Z naszym konektorem

W Odoo 17, 18, 19 i 20 konektor śledzi nowy mandat, gdy tylko GoCardless zgłosi zastąpienie: klient zachowuje swoją metodę płatności, a kolejna faktura zostaje obciążona mandatem, który GoCardless ustanowił w jego miejsce.

Czytaj dalej