GoCardless mandate_replaced: het mandaat heeft een vervanger

Wat GoCardless zegt

De documentatie van gebeurtenissen legt het zo uit: "The mandate has been cancelled and replaced by a new mandate (for example, because the creditor has moved to a new Service User Number).". En wat de gebeurtenis bevat: "The event will include links[new_mandate] with the ID of the new mandate.".

mandate_replaced is een fout invalid_state: de actie is in de huidige status niet geldig. Bij dat soort fouten vraagt GoCardless de gebruiker te informeren en niet opnieuw te proberen ("invalid_state → inform the end user, do not allow retry.").

Wanneer verschijnt het

De wijziging wordt niet door de klant of diens bank veroorzaakt: de gebeurtenis replaced heeft als bron gocardless, en de gedocumenteerde oorzaak is dat de crediteur, het account waarmee je bij GoCardless incasseert, is overgestapt naar een ander schema-identifier. GoCardless annuleert het oude mandaat en maakt er een nieuw voor in de plaats.

mandate_replaced verschijnt alleen als Odoo met het oude mandaat probeert te incasseren: de incasso van een abonnement dat wordt verlengd, of een betaling die wordt geregistreerd met de opgeslagen betaalmethode van de klant, voordat Odoo de gebeurtenis heeft verwerkt.

Wat Odoo met de connector doet

Bij de gebeurtenis replaced:

1. Haalt Odoo het nieuwe mandaat uit links.new_mandate.
2. Koppelt het opgeslagen betaalmethode van de klant aan dat nieuwe mandaat en houdt het als geldig, in plaats van het als verloren te beschouwen. Stond de methode gearchiveerd, dan wordt ze opnieuw geactiveerd; Odoo 17 laat een betaalmethode niet dearchiveren, en daar maakt de connector een nieuwe betaalmethode voor het nieuwe mandaat aan.
3. Schrijft dit in het klantdossier: "The GoCardless mandate is usable again (replaced).".

Die notitie schrijft de connector zelf bij het verwerken van de gebeurtenis, zonder dat iemand ingrijpt. 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.

Bij mandate_replaced in een betaling doet de connector niets bijzonders: bij het aanmaken van een betaling behandelt hij alleen mandate_is_inactive apart. De transactie gaat naar "Fout" met "GoCardless rejected the request." en daaronder het bericht van GoCardless met mandate_replaced en de request_id tussen haakjes. Het nieuwe mandaat haalt hij uit de gebeurtenis, niet uit de fout.

Wat te doen

1. Blijft een betaling op een fout met mandate_replaced staan, open dan de transactie vanuit de factuur, met de knop "Betalingstransactie" bovenaan; het menu met transacties verschijnt alleen in de ontwikkelaarsmodus, en in Odoo 20 bestaat het niet.
2. Controleer in het klantdossier of de notitie staat dat het mandaat opnieuw bruikbaar is (replaced). Staat ze er, dan verwijst de betaalmethode al naar het nieuwe mandaat.
3. Staat ze er niet, dan is de gebeurtenis nog niet binnengekomen. De taak die elk uur verloren gebeurtenissen ophaalt, brengt die alsnog binnen; duurt dat langer, controleer dan of de webhooks van GoCardless bij Odoo aankomen.
4. Is de betaalmethode actueel, incasseer de factuur dan opnieuw.

Met onze connector

In Odoo 17, 18, 19 en 20 volgt de connector het nieuwe mandaat zodra GoCardless de vervanging meldt: de klant behoudt zijn betaalmethode en de volgende factuur wordt geïncasseerd met het mandaat dat GoCardless in de plaats heeft gezet.

Lees verder