GoCardless mandate_not_inactive: mandatu nie można reaktywować

Co mówi GoCardless

GoCardless oddziela obie części tekstu myślnikiem. W referencji API szczegółowo to opisuje: „This will fail with a mandate_not_inactive error if the mandate is already being submitted, or is active.”. To błąd invalid_state, a przy takich błędach GoCardless zaleca poinformować użytkownika i nie ponawiać próby („invalid_state → inform the end user, do not allow retry.”).

Które mandaty można reaktywować

Reaktywacja ma więcej warunków niż sam stan:

• To funkcja z ograniczeniami: „Restricted this endpoint requires approved custom payment pages”.
• Działa tylko dla mandatu anulowanego z Dashboardu lub przez API: „A mandate can only be reinstated if it has been cancelled through the dashboard or the API.”. Mandatu anulowanego przez bank nie da się: „Any mandate that has been cancelled by the bank cannot be reinstated.”.
• Dotyczy mandatów anulowanych lub wygasłych („Reinstates a cancelled or expired mandate to the banks.”), a mandat można przedstawić ponownie do 10 razy („Mandates can be resubmitted up to 10 times.”).

Po złożeniu prośby proces przebiega jak przy zakładaniu mandatu: pojawia się resubmission_requested, a potem, jak podaje GoCardless, „so you will receive a submitted webhook, followed by a reinstated or failed webhook up to two working days later.”.

Co robi konektor w Odoo

Na karcie metody płatności klienta konektor pokazuje przycisk „Reinstate mandate (sandbox)”. Pojawia się tylko wtedy, gdy mandat pochodzi z GoCardless, dostawca nie jest w produkcji (w Odoo 17, 18 i 19 według stanu dostawcy, w Odoo 20 według pola produkcji) i „Mandate Status” ma wartość cancelled, failed lub expired.

Po kliknięciu:

1. Konektor prosi GoCardless o reaktywację tego mandatu.
2. Jeśli GoCardless ją przyjmie, stan przechodzi na reinstate_requested, a na karcie klienta widać: „Reinstatement of the GoCardless mandate requested. It stays unusable until the bank confirms it.”. Metoda płatności pozostaje zarchiwizowana.
3. Gdy przyjdzie reinstated, konektor uznaje mandat za ważny: reaktywuje go i zapisuje: „The GoCardless mandate is usable again (reinstated).”.

Jeśli GoCardless odpowie mandate_not_inactive, konektor tego nie przechwytuje: Odoo pokazuje „GoCardless rejected the request.” z komunikatem GoCardless, reason i request_id, a mandat zostaje bez zmian. Dzieje się tak, gdy Odoo uważa mandat za martwy, a w GoCardless jest już aktywny lub przedstawiany, bo jego zdarzenia jeszcze nie dotarły do Odoo. Po zaakceptowanej prośbie przycisk już się nie pokazuje, bo stan przechodzi na reinstate_requested.

Notatkę, że mandat znów można używać, zapisuje konektor przy przetwarzaniu zdarzenia, bez udziału człowieka. Konektor nie jest przetłumaczony na polski: te teksty zawsze pojawiają się po angielsku, także w Odoo po polsku, niezależnie od tego, czy uruchamia je użytkownik, czy zaplanowane działanie: „The GoCardless mandate is usable again (reinstated).”.

Co zrobić

1. Gdy pojawi się mandate_not_inactive, znajdź mandat w Dashboardzie GoCardless. Jeśli jest aktywny lub przedstawiany, nie ma czego reaktywować: poczekaj, aż dotrą jego zdarzenia. Zadanie, które co godzinę odzyskuje zagubione zdarzenia, je przyniesie.
2. Jeśli mandat anulował bank, nie próbuj: GoCardless nie reaktywuje takich mandatów. Poproś klienta o nowy mandat.
3. W produkcji konektor nie oferuje reaktywacji: drogą jest nowy mandat podpisany przez klienta.
4. Aby to przetestować, użyj sandboxa GoCardless z dostawcą w trybie testowym.

Z naszym konektorem

W Odoo 17, 18, 19 i 20 konektor oferuje reaktywację mandatu anulowanego, nieudanego lub wygasłego, i to tylko poza produkcją, a nie używa go ponownie, dopóki GoCardless nie potwierdzi reaktywacji swoim zdarzeniem.

Czytaj dalej