GoCardless mandate_not_inactive: het mandaat kan niet worden gereactiveerd

Wat GoCardless zegt

GoCardless scheidt de twee delen van de tekst met een streepje. In de API-referentie staat het zo uitgewerkt: "This will fail with a mandate_not_inactive error if the mandate is already being submitted, or is active.". Het is een invalid_state-fout, en daarvoor vraagt GoCardless de gebruiker te informeren en geen nieuwe poging toe te staan ("invalid_state → inform the end user, do not allow retry.").

Welke mandaten kunnen worden gereactiveerd

Voor reactivering gelden meer voorwaarden dan alleen de status:

• Het is een beperkte functie: "Restricted this endpoint requires approved custom payment pages".
• Het geldt alleen voor een mandaat dat via het Dashboard of de API is geannuleerd: "A mandate can only be reinstated if it has been cancelled through the dashboard or the API.". Een mandaat dat de bank heeft geannuleerd kan niet: "Any mandate that has been cancelled by the bank cannot be reinstated.".
• Het werkt voor geannuleerde of verlopen mandaten ("Reinstates a cancelled or expired mandate to the banks."), en een mandaat kan tot 10 keer opnieuw worden ingediend ("Mandates can be resubmitted up to 10 times.").

Na de aanvraag verloopt het proces als bij een nieuwe machtiging: er komt resubmission_requested en daarna, zoals GoCardless zegt, "so you will receive a submitted webhook, followed by a reinstated or failed webhook up to two working days later.".

Wat Odoo met de connector doet

Op het betaalmethodeformulier van de klant zet de connector de knop "Reinstate mandate (sandbox)". Die verschijnt alleen als het mandaat van GoCardless is, de provider niet in productie staat (in Odoo 17, 18 en 19 de status van de provider; in Odoo 20 het productievinkje) en "Mandate Status" cancelled, failed of expired is.

Bij klikken:

1. De connector vraagt GoCardless om reactivering van dat mandaat.
2. Als GoCardless dit accepteert, wordt de status reinstate_requested en staat op het klantformulier "Reinstatement of the GoCardless mandate requested. It stays unusable until the bank confirms it.". De betaalmethode blijft gearchiveerd.
3. Wanneer reinstated binnenkomt, keurt de connector het weer goed: hij activeert de betaalmethode weer en schrijft "The GoCardless mandate is usable again (reinstated).".

Als GoCardless mandate_not_inactive teruggeeft, vangt de connector dat niet op: Odoo toont "GoCardless rejected the request." met het bericht van GoCardless, de reason en de request_id, en het mandaat blijft zoals het was. Dat gebeurt als Odoo denkt dat het mandaat dood is terwijl het bij GoCardless al actief is of wordt ingediend, omdat de events nog niet bij Odoo zijn aangekomen. Na een geaccepteerde aanvraag verschijnt de knop niet meer, omdat de status reinstate_requested is.

De notitie dat het mandaat weer bruikbaar is, schrijft de connector bij het verwerken van het event, zonder dat iemand erbij zit. 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 mandate is usable again (reinstated).".

Wat te doen

1. Bij mandate_not_inactive zoek je het mandaat op in het Dashboard van GoCardless. Is het actief of wordt het ingediend, dan is er niets te reactiveren: wacht tot de events binnenkomen. De taak die elk uur verloren events ophaalt, haalt ze op.
2. Heeft de bank het mandaat geannuleerd, probeer het dan niet: GoCardless reactiveert die niet. Vraag de klant om een nieuw mandaat.
3. In productie biedt de connector geen reactivering: de weg is een nieuw mandaat dat de klant ondertekent.
4. Om het te testen gebruik je de sandbox van GoCardless met de provider in test.

Met onze connector

In Odoo 17, 18, 19 en 20 biedt de connector alleen reactivering van een geannuleerd, mislukt of verlopen mandaat aan, en alleen buiten productie, en hij gebruikt het mandaat pas weer wanneer GoCardless de reactivering met zijn event bevestigt.

Lees verder