GoCardless refund_payment_invalid_state: deze incasso kan nog niet worden terugbetaald

Wat GoCardless zegt

In de referentie voor terugbetalingen voegt GoCardless een termijn toe: "A refund can only be created once it is outside the safer refund period (7 calendar days after the charge date) otherwise an error is returned.". Die periode kan worden uitgeschakeld: "The safer refund period can be disabled by contacting GoCardless.". En het vertelt waarom ze bestaat: "A payment that has been (partially) refunded can still receive a late failure or chargeback from the customer's bank.".

Terugbetalingen via de API staan bovendien standaard uit: "This endpoint is disabled by default. To enable it, you will need to enable refunds on your GoCardless Dashboard.".

De termijnregels in één oogopslag

De twee tellen niet vanaf dezelfde datum. GoCardless telt vanaf de incassodatum van de betaling. De connector telt vanaf de laatste statuswijziging van de incassotransactie in Odoo. Als GoCardless de veilige periode heeft opgeheven, kan de terugbetaling tussen 2 en 7 dagen wel doorgaan.

Wanneer verschijnt refund_payment_invalid_state met de connector

Odoo laat alleen een bevestigde transactie terugbetalen, en de connector bevestigt haar wanneer GoCardless confirmed of paid_out zegt. Met de connector betekent deze reason dus dat de betaling in GoCardless is veranderd en Odoo dat nog niet weet: een late fout, die GoCardless kan melden terwijl de betaling al bevestigd was, of een terugboeking door de klant waarvan het event nog niet is aangekomen.

Wat de connector doet

1. Bij minder dan 2 dagen stuurt hij niets: Odoo stopt met "GoCardless cannot refund a collection until it has settled. This one was charged … day(s) ago; refunds are possible after 2 days.".
2. Anders stuurt hij de terugbetaling naar GoCardless met de idempotentiesleutel. Als GoCardless ze weigert, om deze reason, door de veilige periode of om een andere reden, gaat de terugbetalingstransactie naar "Fout" met "GoCardless rejected the request." en daaronder het bericht van GoCardless met de reason en de request_id.
3. Als GoCardless ze accepteert, staat de transactie op "In behandeling" met "Refund submitted. GoCardless will deduct it from a future payout.", en gaat ze naar "Bevestigd" wanneer GoCardless ze uitbetaalt of verrekent met een uitbetaling.

Vanaf versie 1.1.5 toont een terugbetaling in fout de knop "Retry collection" niet: een terugbetaling is geen incasso, en er is niets wat GoCardless opnieuw kan proberen. Als GoCardless het geld niet aan de klant kan laten terugkeren, zet de connector de terugbetaling op fout met "GoCardless could not pay this refund back (…).". Die tekst schrijft hij bij het toepassen 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: "GoCardless could not pay this refund back (…).".

Wat te doen

1. Open de incassotransactie vanuit de factuur, met de knop "Betalingstransactie" bovenaan; het transactiemenu verschijnt alleen in de ontwikkelaarsmodus, en in Odoo 20 bestaat het niet. Vanaf daar leidt de terugbetalingsknop naar de terugbetalingstransactie en haar bericht.
2. Als de reason refund_payment_invalid_state is, bekijk de betaling dan in het GoCardless Dashboard. Als ze laat is mislukt of de klant ze heeft teruggeboekt, valt er niets meer terug te betalen: het geld is niet meer bij jou. Odoo zal het weergeven zodra het event aankomt; de taak die elk uur de gemiste events ophaalt, haalt het op.
3. Als de afwijzing van de veilige periode komt, wacht dan tot er 7 dagen zijn verstreken sinds de incassodatum, of vraag GoCardless om die op te heffen.
4. Om opnieuw terug te betalen, doe dat vanuit de betaling van de incasso, met de terugbetalingsknop. De connector staat gedeeltelijke terugbetalingen toe.

Met onze connector

In Odoo 17, 18, 19 en 20 stuurt de connector geen terugbetalingen van incasso's van minder dan 2 dagen, zet hij de terugbetalingen die GoCardless weigert op fout met hun request_id, en biedt hij geen opnieuw proberen aan voor een terugbetaling, die geen incasso is.

Lees verder