GoCardless internal_server_error i request_timed_out: błąd leży po stronie GoCardless

Co mówi GoCardless

GoCardless grupuje te reasons w typ gocardless, czyli błędy powstałe wewnątrz GoCardless: „These errors occurred within GoCardless while processing your request.”. Jego tabela kodów HTTP mówi o obu kodach tak:

Na stronie limitów GoCardless określa też, jak długo może trwać żądanie: 29 sekund („Request timeout 29 seconds”).

Trzy przypadki, które konektor traktuje inaczej

Konektor czeka na odpowiedź GoCardless do 30 sekund w każdym żądaniu. Przy pobraniu, zwrocie lub ponowieniu Odoo może natrafić na trzy różne sytuacje:

• GoCardless odpowiada 500 lub 504, z reasonem w odpowiedzi.
• GoCardless nie odpowiada: połączenie się zrywa albo mijają 30 sekund.
• Błąd pojawia się przy zastosowaniu zdarzenia, gdy konektor pyta GoCardless o płatność, której dotyczy zdarzenie.

Co robi konektor

Przy 500 lub 504. Konektor powtarza żądanie tylko wtedy, gdy zostaje bez odpowiedzi, albo po 429. Przy 500 lub 504 odpowiedź jest, więc traktuje ją jako odrzuconą. Przy pobraniu transakcja przechodzi w stan „Błąd” z komunikatem „GoCardless rejected the request.”, a pod spodem pojawia się komunikat GoCardless z reasonem i request_id w nawiasach kwadratowych. Zadanie co godzinę nie wysyła ponownie transakcji w błędzie. Gdyby GoCardless mimo wszystko utworzył pobranie, jego pierwsze zdarzenie je połączy: każde pobranie niesie w metadanych referencję transakcji Odoo, konektor wyszukuje ją po niej i stosuje do płatności stan. Transakcja w błędzie wraca wtedy do „Oczekujące” albo przechodzi w „Potwierdzone”.

Brak odpowiedzi. Konektor powtarza żądanie raz, z tym samym kluczem idempotencji. Jeśli nadal nikt nie odpowiada, nie uznaje pobrania za stracone: transakcja pozostaje oczekująca z komunikatem „GoCardless did not answer, so it is not known yet whether it took the request. It will be sent again, safely, within the hour.”. Zadanie co godzinę wysyła je ponownie z tym samym kluczem; jeśli GoCardless już je utworzył, odpowiada 409 i konektor przejmuje to, co już istnieje.

Przy zastosowaniu zdarzenia. Przy każdym zdarzeniu płatności konektor pyta GoCardless o tę płatność. Jeśli to zapytanie się nie powiedzie, webhook odpowiada 500, aby GoCardless ponowił wysyłkę, a zdarzenia już zastosowane nie są stosowane drugi raz. Odzyskiwanie co godzinę również nie pomija zdarzenia, które się nie powiodło.

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, na przykład odnowienie subskrypcji albo ponowna wysyłka przez sam konektor: „GoCardless rejected the request.” oraz „GoCardless did not answer, so it is not known yet whether it took the request. It will be sent again, safely, within the hour.”.

Co zrobić

1. Otwórz transakcję z faktury, przyciskiem „Transakcja płatnicza” u góry; menu transakcji widoczne jest tylko w trybie deweloperskim, a w Odoo 20 nie istnieje. Jeśli komunikat wymienia internal_server_error lub request_timed_out, błąd leży po stronie GoCardless, nie klienta ani jego mandatu.
2. Zanim ponownie pobierzesz płatność za fakturę, poszukaj pobrania w Dashboardzie GoCardless: konektor jako opis każdego pobrania wpisuje referencję swojej transakcji Odoo. Jeśli ją znajdziesz, nie pobieraj ponownie; jej zdarzenie połączy transakcję.
3. Jeśli jej nie ma, ponownie pobierz płatność za fakturę zapisaną metodą płatności klienta. Nowe pobranie to inna transakcja, z innym kluczem idempotencji, dlatego warto najpierw sprawdzić.
4. Jeśli błąd się powtarza, napisz do wsparcia GoCardless, podając request_id z komunikatu: ich dokumentacja prosi o jego podanie przy kontakcie z pomocą techniczną.

Z naszym konektorem

W Odoo 17, 18, 19 i 20 konektor odróżnia błąd GoCardless od żądania bez odpowiedzi: pierwszy trafia do błędu z request_id, drugi pozostaje oczekujący i jest wysyłany ponownie z tym samym kluczem, a w obu przypadkach zdarzenie istniejącego pobrania łączy je z transakcją.

Czytaj dalej