GoCardless mandate_replaced: il mandato ha un sostituto

Cosa dice GoCardless

La documentazione degli eventi lo spiega così: «The mandate has been cancelled and replaced by a new mandate (for example, because the creditor has moved to a new Service User Number).». E quello che porta l'evento: «The event will include links[new_mandate] with the ID of the new mandate.».

mandate_replaced è un errore invalid_state: l'azione non è valida nello stato attuale della risorsa. Per questi errori GoCardless chiede di avvisare l'utente e non riprovare («invalid_state → inform the end user, do not allow retry.»).

Quando compare

La modifica non è provocata dal cliente né dalla sua banca: l'evento replaced ha origine gocardless, e la causa documentata è che il creditore, cioè l'account con cui incassi in GoCardless, è passato a un altro identificativo di schema. GoCardless annulla il mandato vecchio e ne crea uno nuovo al suo posto.

mandate_replaced compare solo se Odoo prova ad addebitare con il mandato vecchio: l'addebito di un abbonamento che si rinnova, o un pagamento registrato con il metodo di pagamento salvato del cliente, prima che Odoo abbia applicato l'evento.

Cosa fa Odoo con il connettore

Con l'evento replaced:

1. Prende il mandato nuovo da links.new_mandate.
2. Passa a quel mandato il metodo di pagamento salvato del cliente e lo considera valido, invece di darlo per perso. Se il metodo era archiviato, lo riattiva; Odoo 17 non permette di ripristinare un metodo di pagamento, e lì il connettore ne crea uno nuovo per il mandato nuovo.
3. Lo scrive nella scheda del cliente: «The GoCardless mandate is usable again (replaced).».

Questa nota la scrive il connettore nell'applicare l'evento, senza che nessuno intervenga. In un database creato in italiano compare così; in uno creato in inglese e poi passato all'italiano, in inglese: «The GoCardless mandate is usable again (replaced).».

Con mandate_replaced in un addebito, il connettore non fa nulla di speciale: alla creazione di un addebito tratta a parte solo mandate_is_inactive. La transazione passa a «Errore» con «GoCardless rejected the request.» e, sotto, il messaggio di GoCardless con mandate_replaced e il request_id tra parentesi quadre. Il mandato nuovo lo prende dall'evento, non dall'errore. Questo messaggio esce nella lingua di chi lancia l'addebito; se lo lancia un'azione pianificata, in un database creato in inglese e poi passato all'italiano esce in inglese: «GoCardless rejected the request.».

Cosa fare

1. Se un addebito resta in errore con mandate_replaced, apri la transazione dalla fattura, con il pulsante «Transazione di pagamento» in alto; il menu delle transazioni compare solo in modalità sviluppatore, e in Odoo 20 non esiste.
2. Controlla nella scheda del cliente se c'è la nota che il mandato può essere riutilizzato (replaced). Se c'è, il metodo di pagamento punta già al mandato nuovo.
3. Se non c'è, l'evento non è ancora arrivato. L'azione pianificata che ogni ora recupera gli eventi persi lo porta; se ci mette più di così, verifica che i webhook di GoCardless arrivino a Odoo.
4. Con il metodo di pagamento aggiornato, riprova ad addebitare la fattura.

Con il nostro connettore

In Odoo 17, 18, 19 e 20 il connettore segue il mandato nuovo appena GoCardless segnala la sostituzione: il cliente conserva il suo metodo di pagamento e la fattura successiva si incassa con il mandato che GoCardless ha lasciato al suo posto.

Continua a leggere