GoCardless internal_server_error en request_timed_out: de fout zit bij GoCardless

Wat GoCardless zegt

GoCardless groepeert deze reasons onder het type gocardless, dat van fouten die binnen GoCardless ontstaan: "These errors occurred within GoCardless while processing your request.". Hun tabel met HTTP-codes zegt dit over de twee codes:

Op de pagina met limieten stelt GoCardless bovendien vast hoe lang een verzoek mag duren: 29 seconden ("Request timeout 29 seconds").

Drie gevallen die de connector niet hetzelfde behandelt

De connector wacht per verzoek tot 30 seconden op het antwoord van GoCardless. Bij een incasso, een terugbetaling of een nieuwe poging kan Odoo drie verschillende situaties tegenkomen:

• GoCardless antwoordt met een 500 of een 504, met de reason in het antwoord.
• GoCardless antwoordt niet: de verbinding valt weg of de 30 seconden zijn voorbij.
• De fout komt bij het verwerken van een gebeurtenis, wanneer de connector bij GoCardless de betaling opvraagt waar de gebeurtenis over gaat.

Wat de connector doet

Bij een 500 of een 504. De connector herhaalt een verzoek alleen wanneer er geen antwoord komt of na een 429. Bij een 500 of een 504 is er wel een antwoord, dus wordt het als afgewezen beschouwd. Bij een incasso gaat de transactie naar "Fout" met "GoCardless rejected the request." en daaronder het bericht van GoCardless met de reason en de request_id tussen haken. De uurlijkse taak stuurt een transactie in fout niet opnieuw. Mocht GoCardless de incasso toch hebben aangemaakt, dan koppelt de eerste gebeurtenis die: elke incasso draagt in zijn metadata de referentie van de Odoo-transactie, de connector zoekt die op en past de betaalstatus toe. Een transactie in fout gaat zo terug naar "In behandeling" of wordt "Bevestigd".

Zonder antwoord. De connector herhaalt het verzoek één keer, met dezelfde idempotentiesleutel. Als ook dan niemand antwoordt, beschouwt hij de incasso niet als verloren: de transactie blijft in behandeling met "GoCardless did not answer, so it is not known yet whether it took the request. It will be sent again, safely, within the hour.". De uurlijkse taak stuurt het opnieuw met dezelfde sleutel; heeft GoCardless het al aangemaakt, dan antwoordt het met 409 en neemt de connector het bestaande over.

Bij het verwerken van een gebeurtenis. Bij elke gebeurtenis van een betaling vraagt de connector die betaling op bij GoCardless. Mislukt die opvraag, dan antwoordt de webhook met 500, zodat GoCardless de verzending opnieuw stuurt, en gebeurtenissen die al verwerkt zijn, worden niet twee keer verwerkt. Ook het uurlijkse herstel laat geen mislukte gebeurtenis liggen.

De connector is niet in het Nederlands vertaald: deze teksten verschijnen altijd in het Engels, ook in een Nederlandstalige Odoo, of een gebruiker of een geplande actie ze nu start: "GoCardless rejected the request." en "GoCardless did not answer, so it is not known yet whether it took the request. It will be sent again, safely, within the hour.".

Wat te doen

1. Open de transactie vanuit de factuur, met de knop "Betalingstransactie" bovenaan; het menu met transacties verschijnt alleen in de ontwikkelaarsmodus en bestaat niet in Odoo 20. Noemt het bericht internal_server_error of request_timed_out, dan lag de fout bij GoCardless en niet bij de klant of diens mandaat.
2. Zoek voordat u de factuur opnieuw int de incasso op in het Dashboard van GoCardless: de connector zet als omschrijving van elke incasso de referentie van zijn Odoo-transactie. Staat hij er, int dan niet opnieuw; de gebeurtenis koppelt de transactie.
3. Staat hij er niet, int de factuur dan opnieuw met de opgeslagen betaalmethode van de klant. Een nieuwe incasso is een andere transactie, met een andere idempotentiesleutel: daarom is het verstandig eerst te kijken.
4. Herhaalt het probleem zich, neem dan contact op met de support van GoCardless met de request_id uit het bericht: hun documentatie vraagt om die bij contact met hun support te vermelden.

Met onze connector

In Odoo 17, 18, 19 en 20 onderscheidt de connector een fout van GoCardless van een verzoek zonder antwoord: de eerste komt op fout met zijn request_id, het tweede blijft in behandeling en wordt opnieuw verstuurd met dezelfde sleutel, en in beide gevallen koppelt de gebeurtenis van een incasso die wel bestaat hem aan zijn transactie.

Lees verder