Fout mandate_is_inactive van GoCardless bij het aanmaken van een incasso vanuit Odoo

Wat GoCardless zegt

GoCardless scheidt de twee delen van de tekst met een streepje. Volgens GoCardless betekent een invalid_state-fout dat de actie niet geldig is in de huidige staat van de resource. Hier is de resource het mandaat: geannuleerd, mislukt of verlopen, dus het accepteert geen incasso's meer.

Hoe je bij deze fout terechtkomt

Normaal gesproken hoort Odoo via een GoCardless-gebeurtenis dat een mandaat is komen te vervallen voordat het ermee probeert te incasseren. Deze fout verschijnt wanneer dat niet is gebeurd: de melding kwam niet aan of te laat, of het mandaat werd vlak voor de incasso geannuleerd. De incasso kan komen van een abonnement dat wordt verlengd of van een betaling die is geregistreerd met de bewaarde betaalmethode van de klant. De meldingen van GoCardless komen binnen via webhook: met de verbinding in twee klikken via FlexigoTech Cloud, of in de geavanceerde modus naar het eindpunt dat je zelf hebt aangemaakt in het Dashboard van GoCardless. Als die route faalt, merkt Odoo het niet op tijd.

Wat de connector doet

Zonder speciale afhandeling zie je de fout zoals hij is, met de tekst van de API, en blijft het mandaat worden aangeboden voor de volgende factuur. De connector doet iets anders:

1. Herkent de reason mandate_is_inactive in het antwoord.
2. Vraagt GoCardless naar dat mandaat om de status te bevestigen.
3. Als het geannuleerd, mislukt, verlopen, verbruikt of geblokkeerd is, archiveert hij het in Odoo. Als dit de eerste melding van dat dode mandaat is, schrijft hij het in de klantkaart, met de status van het mandaat tussen haakjes ("The GoCardless direct debit mandate of … is no longer usable (cancelled). No further collection can be taken against it. Ask the customer to set up a new mandate."), en maakt hij de activiteit "GoCardless mandate lost".
4. Zet de transactie op "Fout" met een eigen melding, in plaats van de ruwe fout: "The customer's GoCardless mandate is …, so it cannot be charged. Ask the customer for a new mandate.".

Als het mandaat blijkt actief te zijn, raakt de connector het niet aan en toont de transactie de fout van GoCardless: "GoCardless rejected the request." gevolgd door het bericht van de API en de request_id. Dezelfde afhandeling geldt voor de knop om een incasso opnieuw te proberen wanneer GoCardless mandate_is_inactive antwoordt.

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: "The GoCardless direct debit mandate of … is no longer usable (cancelled). No further collection can be taken against it. Ask the customer to set up a new mandate.", "GoCardless mandate lost", "The customer's GoCardless mandate is …, so it cannot be charged. Ask the customer for a new mandate." en "GoCardless rejected the request.".

Waarom je beter niet opnieuw probeert

GoCardless zegt het in de beschrijving van de invalid_state-fouten: je moet de gebruiker informeren en niet laten opnieuw proberen. Een geannuleerd mandaat wordt niet weer actief door er vaker tegenaan te gaan; de klant moet een nieuw mandaat tekenen of, in sommige gevallen en alleen met speciale rechten van GoCardless, het mandaat laten reactiveren.

Wat te doen

• Bekijk het bericht van de transactie en de notitie van de connector in de klantkaart. De transactie open je vanuit de factuur, met de knop "Betalingstransactie" bovenaan; het transactiemenu verschijnt alleen in de ontwikkelaarsmodus, en in Odoo 20 bestaat het niet. Beide teksten vertellen je in welke staat het mandaat zich bevindt.
• Vraag de klant om een nieuw mandaat en incasseer daarmee de openstaande factuur.
• Als het vaak gebeurt, controleer dan of de webhooks van GoCardless bij je Odoo aankomen: die waarschuwen voordat de incasso komt. Toch vraagt de connector elk uur de gebeurtenissen op die verloren zijn gegaan.

Met onze connector

In Odoo 17, 18, 19 en 20 zet de connector een API-fout om in een duidelijke taak: het dode mandaat verdwijnt uit de lijst met betaalmethoden, de klant wordt in zijn kaart gewaarschuwd en de factuur blijft openstaan tot er een werkend mandaat is.

Lees verder