Cosa fare quando un mandato GoCardless viene revocato

Su GoCardless, ogni pagamento dipende da un mandato: l’autorizzazione del cliente ad addebitare il suo conto. Quando il mandato viene revocato, non funziona più nient’altro. I pagamenti in sospeso si fermano, gli abbonamenti collegati terminano e nessun nuovo tentativo può aiutare. È l’evento più importante da gestire bene in un’attività basata sull’addebito diretto, e anche quello in cui un’email automatica “aggiorna i tuoi dati” ha più probabilità di essere sbagliata.

Questa guida spiega perché i mandati terminano, cosa succede agli abbonamenti e ai pagamenti collegati, come leggere la causa e come ottenere un nuovo mandato quando il cliente vuole continuare a pagare. Si attiene alla documentazione di GoCardless: il riferimento degli eventi dei mandati, il riferimento degli eventi degli abbonamenti, la guida per sviluppatori Responding to mandate events e l’articolo del centro assistenza sugli stati dei mandati (tutti consultati a novembre 2026). Il sito di documentazione di GoCardless non era raggiungibile dal nostro ambiente di ricerca, quindi abbiamo verificato anche le descrizioni di campi ed endpoint sulle librerie client ufficiali dell’API di GoCardless (per esempio gocardless-pro-ruby), che sono generate dallo stesso schema dell’API. Per il lato pagamenti del recupero, vedi come recuperare i pagamenti in addebito diretto falliti con GoCardless.

Stati del mandato

GoCardless documenta questi stati del mandato:

Stato	Significato
pending_customer_approval	Non ancora firmato da un secondo firmatario
pending_submission	Non ancora inviato alla banca del cliente
submitted	Inviato, non ancora elaborato
active	Attivato dalla banca del cliente; si possono prelevare pagamenti
suspended_by_payer	Sospeso dal pagatore
failed	Non è stato possibile crearlo
cancelled	Revocato
expired	Scaduto per inattività
consumed	Usato e non riutilizzabile (solo per gli schemi autorizzati per singolo pagamento)
blocked	Bloccato; non si possono creare pagamenti

Solo i mandati active possono essere addebitati, e un nuovo tentativo manuale di pagamento richiede un mandato attivo. Ogni mandato ha anche una next_possible_charge_date, che conta quando imposti un sostituto e vuoi sapere quando puoi incassare.

Perché un mandato viene revocato

L’evento cancelled arriva con details.cause, details.origin e, quando l’origine è la banca, details.reason_code. Usa cause per la tua logica. GoCardless avverte che reason_code è specifico dello schema e può essere incoerente tra le banche.

La guida per sviluppatori di GoCardless elenca diverse cause per un mandato revocato, tra cui:

• bank_account_closed: il conto bancario del cliente è stato chiuso.
• invalid_bank_details: le coordinate bancarie non sono valide.
• mandate_cancelled: il mandato è stato revocato.

Sull’ultima, le pagine di GoCardless non sono coerenti tra loro. Il riferimento API degli eventi dei mandati descrive mandate_cancelled come un mandato revocato dal cliente o dalla sua banca, mentre la guida per sviluppatori più vecchia lo usa per le revoche fatte tramite dashboard o API e descrive in modo diverso una revoca lato banca da parte del cliente. Non affidarti solo a cause per distinguere “il cliente ha revocato in banca” da “l’abbiamo revocato noi”: leggi anche origin (bank, api, gocardless, customer e così via). Un’origine api significa che è stato il tuo sistema, o un’app che hai collegato.

Un mandato scaduto è diverso: GoCardless fa scadere i mandati per inattività. Nessuno ha deciso di fermarsi; il mandato semplicemente non è stato usato.

Cosa succede a pagamenti e abbonamenti

Un mandato revocato si porta dietro altre cose:

• Pagamenti in sospeso. Il riferimento dell’API di GoCardless per l’endpoint di revoca dice che revocare un mandato annulla tutti i pagamenti associati annullabili. Un pagamento già inviato alle banche può ancora essere incassato o fallire da solo.
• Abbonamenti. Il riferimento degli eventi degli abbonamenti di GoCardless mostra abbonamenti disdetti perché il loro mandato è stato revocato, con cause come mandate_cancelled, bank_account_closed e invalid_bank_details.
• Pagamenti successivi. Un pagamento su un mandato revocato fallisce con la causa mandate_cancelled. Non è possibile ritentarlo: i nuovi tentativi richiedono un mandato attivo.

Quindi una sola revoca produce diversi eventi: il mandato, l’abbonamento e forse dei pagamenti. Raggruppali per cliente prima di inviare qualsiasi email, altrimenti il cliente potrebbe ricevere tre messaggi per una sola cosa.

Decidi cosa significa la revoca

Prima di scrivere al cliente, classifica la revoca in uno di tre casi:

Caso	Segnali	Risposta giusta
Il cliente ha cambiato o chiuso il conto	bank_account_closed, o una revoca seguita dal cliente che dice di aver cambiato banca	Chiedi le nuove coordinate tramite un nuovo mandato
Il cliente vuole smettere di pagare	Revocato in banca, spesso vicino a un rinnovo; nessuna risposta	Trattala come una disdetta: confermala, chiedi perché, chiudi l’accesso in modo pulito
L’hai revocato tu	origin è api o la dashboard	Controlla i tuoi log prima di dire qualsiasi cosa al cliente

La guida per sviluppatori di GoCardless è chiara su un punto: revoca tu stesso un mandato solo se il cliente lo ha chiesto esplicitamente.

Impostare un nuovo mandato

Quando il cliente vuole continuare:

1. Scrivi una volta, in modo semplice. Di’ che l’addebito diretto è stato revocato, che non si possono più prelevare pagamenti su di esso e che può impostarne uno nuovo in un minuto se vuole continuare. La guida di GoCardless raccomanda di avvisare il cliente e invitarlo a impostare un nuovo mandato se necessario.
2. Rimanda a un flusso ospitato. Su GoCardless, i nuovi mandati si raccolgono con una Billing Request e il suo Billing Request Flow ospitato. Invia quel link; non chiedere mai le coordinate bancarie via email.
3. Aspetta active. Un nuovo mandato passa per pending_submission e submitted prima di active. Se fallisce (per esempio perché il nuovo conto non supporta l’addebito diretto), ricevi un evento failed; chiedi al cliente di provare con un altro conto.
4. Ricrea ciò che è andato perso. Crea un nuovo abbonamento sul nuovo mandato, e un pagamento per qualsiasi importo ancora dovuto, alla next_possible_charge_date del mandato o dopo.
5. Di’ al cliente cosa verrà incassato e quando, prima che succeda.

E il ripristino?

L’API di GoCardless ha un’azione reinstate per i mandati revocati o scaduti. Invia di nuovo il mandato alle banche; poi ricevi resubmission_requested, submitted e reinstated o failed fino a due giorni lavorativi dopo, e un mandato può essere reinviato fino a 10 volte. Usala solo quando sai che il mandato dovrebbe essere ancora valido, per esempio dopo un errore dal tuo lato. Quando il cliente ha revocato in banca, ripristinarlo senza il suo accordo va contro la sua decisione, ed è probabile che porti a un fallimento o a un reclamo.

Mandati scaduti

Un mandato scaduto è il più facile da recuperare, perché nessuno si è opposto. Se prevedi di addebitare un cliente il cui mandato è rimasto inattivo (un piano annuale, o un cliente che ha messo in pausa), controlla lo stato del mandato prima della data di addebito. Se è scaduto, chiedi al cliente di impostare un nuovo mandato in anticipo, invece di scoprirlo con un pagamento fallito.

Una checklist

• Il tuo gestore di webhook elabora gli eventi dei mandati, non solo quelli dei pagamenti.
• Gli eventi vengono raggruppati per cliente prima che parta qualsiasi email.
• Sia cause sia origin vengono salvati e letti.
• Le revoche fatte dal tuo sistema vengono riconosciute e non comunicate ai clienti come “la tua banca ha revocato”.
• L’email per il nuovo mandato rimanda a un Billing Request Flow ospitato.
• Gli abbonamenti vengono ricreati solo dopo che il nuovo mandato è attivo.
• I mandati vengono controllati prima degli addebiti poco frequenti.

Farlo con NoChurn

GoCardless tiene i mandati, l’incasso e le coordinate bancarie. NoChurn importa clienti, mandati, abbonamenti e pagamenti, segue i webhook di GoCardless e legge lo stato dei mandati (attivo, revocato, scaduto). Quando un mandato viene revocato, l’email di recupero di NoChurn scritta dall’IA, che rivedi tu, rimanda il cliente a impostarne uno nuovo; quando invece il cliente vuole fermarsi, subentrano il flusso di disdetta con una disdetta in un clic sempre visibile e le email di win-back a 30, 60 e 90 giorni. Vedi NoChurn + GoCardless.