GoCardless MD01: mandate_cancelled e authorisation_disputed in un incasso SEPA

Tre eventi e quattro righe, lo stesso codice

Le quattro righe provengono dalla tabella SEPA Core della documentazione di GoCardless e riportano MD01; il pagamento annullato compare con due cause e lo stesso testo. Anche il mandato viene annullato, e GoCardless lo comunica con un evento proprio: «A payment under this mandate failed, indicating that the mandate has been cancelled at the customer's bank. Any subscriptions and pending payments will also be cancelled.».

Cosa cambia a seconda del momento

Se il cliente annulla il mandato prima che l'incasso venga addebitato, il pagamento fallisce: il denaro non è arrivato. Se lo contesta dopo l'addebito, è uno storno: il denaro è arrivato e viene restituito. E se c'erano pagamenti in attesa di essere presentati, GoCardless li annulla prima di inviarli. Il connettore annota nel suo codice di aver visto la causa authorisation_disputed con MD01 in un pagamento di prova della sandbox, come storno di un pagamento già regolato.

Cosa fa Odoo con il connettore

La transazione si apre 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. In tutti e tre i casi la transazione finisce in «Errore» con la causa in evidenza. Il messaggio dipende dall'evento: «GoCardless could not collect this payment (mandate_cancelled).» per un fallimento, e «GoCardless reported a chargeback for this payment (mandate_cancelled). The funds have been taken back and will be deducted from a future payout.» per uno storno. Se Odoo aveva già la fattura pagata con quell'incasso, il connettore annulla il pagamento e la fattura torna da saldare.

L'importante è il mandato. mandate_cancelled e authorisation_disputed sono tra le quattro cause per cui il connettore lo considera non più valido, quindi:

• archivia il metodo di pagamento del cliente, che smette di essere proposto per gli incassi;
• scrive nella sua scheda «The GoCardless direct debit mandate of … is no longer usable (mandate_cancelled). No further collection can be taken against it. Ask the customer to set up a new mandate.»;
• crea un'attività «GoCardless mandate lost».

Arrivano più eventi con la stessa notizia, quello del pagamento e quello del mandato, ma l'avviso compare una sola volta: il secondo trova il mandato già archiviato.

Tutti questi testi li scrive il connettore nell'applicare l'evento, senza nessuno davanti. Sono in inglese, perché il connettore non è tradotto in italiano e questi messaggi escono sempre in inglese, anche in un Odoo in italiano: «GoCardless could not collect this payment (mandate_cancelled).», «GoCardless reported a chargeback for this payment (mandate_cancelled). The funds have been taken back and will be deducted from a future payout.», «The GoCardless direct debit mandate of … is no longer usable (mandate_cancelled). No further collection can be taken against it. Ask the customer to set up a new mandate.» e «GoCardless mandate lost».

Cosa fare

Prima di chiedere un mandato nuovo, capisci perché l'ha annullato. Un cliente che ha smesso di voler il servizio ha bisogno di una disdetta, non di un'altra firma. Se è stato un errore suo o un cambiamento nella sua banca, chiedigli di firmare di nuovo e incassa con il mandato nuovo le fatture rimaste aperte. Se dice di non aver mai autorizzato l'addebito, verifica come è stato firmato il mandato prima di continuare a incassare.

Con il nostro connettore

In Odoo 17, 18, 19 e 20, il connettore distingue il fallimento dallo storno, riapre la fattura se serve, ritira il mandato e ti lascia l'attività di parlare con il cliente nella sua scheda. Quello che non fa è chiedere il mandato nuovo per conto tuo: quella conversazione spetta a te.

Continua a leggere