GoCardless mandate_not_inactive: il mandato non si può riattivare

Cosa dice GoCardless

GoCardless separa le due parti del testo con un trattino. Nel riferimento dell'API lo specifica: «This will fail with a mandate_not_inactive error if the mandate is already being submitted, or is active.». È un errore invalid_state e, per questi casi, GoCardless chiede di avvisare l'utente senza consentire nuovi tentativi («invalid_state → inform the end user, do not allow retry.»).

Quali mandati si possono riattivare

La riattivazione ha condizioni più restrittive dello stato:

• È una funzione limitata: «Restricted this endpoint requires approved custom payment pages».
• Vale solo per un mandato annullato dalla Dashboard o dall'API: «A mandate can only be reinstated if it has been cancelled through the dashboard or the API.». Un mandato annullato dalla banca no: «Any mandate that has been cancelled by the bank cannot be reinstated.».
• Serve per mandati annullati o scaduti («Reinstates a cancelled or expired mandate to the banks.»), e un mandato può essere ripresentato fino a 10 volte («Mandates can be resubmitted up to 10 times.»).

Dopo la richiesta il processo è quello di una nuova attivazione: arriva resubmission_requested e poi, come dice GoCardless, «so you will receive a submitted webhook, followed by a reinstated or failed webhook up to two working days later.».

Cosa fa Odoo con il connettore

Nella scheda del metodo di pagamento del cliente, il connettore mostra il pulsante «Reinstate mandate (sandbox)». Compare solo se il mandato è di GoCardless, il provider non è in produzione (in Odoo 17, 18 e 19, lo stato del provider; in Odoo 20, la casella di produzione) e «Mandate Status» è cancelled, failed o expired.

Premendolo:

1. Il connettore chiede a GoCardless la riattivazione di quel mandato.
2. Se GoCardless l'accetta, lo stato passa a reinstate_requested e nella scheda del cliente compare «Reinstatement of the GoCardless mandate requested. It stays unusable until the bank confirms it.». Il metodo di pagamento resta archiviato.
3. Quando arriva reinstated, il connettore lo considera di nuovo valido: lo riattiva e scrive «The GoCardless mandate is usable again (reinstated).».

Se GoCardless risponde mandate_not_inactive, il connettore non lo intercetta: Odoo mostra «GoCardless rejected the request.» con il messaggio di GoCardless, il reason e il request_id, e il mandato resta com'era. Succede quando Odoo ritiene il mandato non più valido mentre in GoCardless è già attivo o in invio, perché i suoi eventi non sono ancora arrivati a Odoo. Dopo una richiesta accettata il pulsante non compare più, perché lo stato passa a reinstate_requested.

La nota che il mandato è di nuovo utilizzabile la scrive il connettore nell'applicare l'evento, senza intervento di nessuno. Il connettore non è tradotto in italiano: questi testi compaiono sempre in inglese, anche in un Odoo in italiano, sia che li avvii un utente sia un'azione pianificata: «The GoCardless mandate is usable again (reinstated).».

Cosa fare

1. Se compare mandate_not_inactive, cerca il mandato nella Dashboard di GoCardless. Se è attivo o in invio, non c'è nulla da riattivare: attendi l'arrivo dei suoi eventi. L'azione pianificata che ogni ora recupera gli eventi persi li porta.
2. Se il mandato è stato annullato dalla banca, non provarci: GoCardless non riattiva questi mandati. Chiedi al cliente un nuovo mandato.
3. In produzione, il connettore non offre la riattivazione: la strada è un nuovo mandato firmato dal cliente.
4. Per provarlo, usa il sandbox di GoCardless con il provider in test.

Con il nostro connettore

In Odoo 17, 18, 19 e 20 il connettore offre la riattivazione di un mandato annullato, fallito o scaduto solo fuori dalla produzione e non lo riutilizza finché GoCardless non conferma la riattivazione con il suo evento.

Continua a leggere