Come aggiungere un flusso di disdetta agli abbonamenti Mollie

Mollie gestisce gli addebiti ricorrenti, ma il posto in cui un cliente decide di andarsene è la tua app. La Subscriptions API ti dà gli strumenti per annullare un abbonamento, cambiarne importo o intervallo, o spostarne la data di inizio. Ciò che non ti dà è una schermata di disdetta. Quella parte la costruisci tu, ed è lì che un buon flusso di disdetta ripaga.

Questa guida mostra cosa ti permette di fare l’API di Mollie quando un cliente vuole disdire, e come trasformarlo in un flusso di disdetta breve e onesto. Si attiene alla documentazione di Mollie: Cancel subscription, Update subscription, Get subscription, Revoke mandate e la guida ai pagamenti ricorrenti (tutti consultati a novembre 2026). Abbiamo anche verificato le descrizioni dei campi con il client API Node.js ufficiale di Mollie.

Cosa ti dà Mollie

Un abbonamento Mollie appartiene a un cliente e addebita un importo fisso a un intervallo, su un mandato. I campi che contano per un flusso di disdetta:

Campo	Significato
status	pending, active, canceled, suspended o completed. Dipende dal fatto che il mandato del cliente sia in attesa, valido o non valido.
amount	L’importo costante addebitato a ogni pagamento.
interval	Tempo tra gli addebiti, come 1 month o 14 days.
nextPaymentDate	Il prossimo addebito programmato; assente quando l’abbonamento è terminato.
times, timesRemaining	Per gli abbonamenti con un numero fisso di addebiti.
canceledAt	Quando è stato annullato.
metadata	I tuoi dati, inoltrati a ogni pagamento creato dall’abbonamento.

E le chiamate:

• Annullare: DELETE /v2/customers/:customerId/subscriptions/:id. Il riferimento di Mollie dice che un abbonamento può essere annullato in qualsiasi momento in questo modo.
• Aggiornare: PATCH sulla stessa risorsa. I campi aggiornabili sono amount, description, interval, startDate, times, mandateId, metadata e webhookUrl. Un abbonamento annullato non può essere aggiornato.
• Revocare il mandato: DELETE sul mandato del cliente. Non puoi più addebitare quel conto o quella carta con esso, e tutti gli abbonamenti collegati vengono annullati.

Nota cosa manca nell’elenco: la Subscriptions API di Mollie non ha un endpoint di pausa. Qualsiasi offerta di “pausa” va costruita con le chiamate qui sopra.

Annullare l’abbonamento, non il mandato

Quando un cliente disdice, annulla l’abbonamento. Revocare il mandato ferma anche tutti gli altri abbonamenti collegati e significa che il cliente dovrà rifare il checkout se mai tornerà. Revoca un mandato solo quando il cliente ti chiede di fermare tutti gli addebiti su quel conto, o quando hai un motivo per non fidarti.

Decidi anche cosa significa “disdire” per l’accesso. Mollie ferma gli addebiti futuri quando annulli; non sa cosa il cliente ha già pagato. La maggior parte delle aziende in abbonamento mantiene l’accesso fino alla fine del periodo pagato. Salva tu quella data, a partire dall’ultimo pagamento riuscito e dall’intervallo.

Progettare il flusso

Un flusso di disdetta ha tre compiti: capire perché il cliente se ne va, offrire qualcosa adatto a quel motivo e disdire in modo pulito se vuole comunque andarsene. Limitalo a poche schermate.

1. Chiedere il motivo

Una domanda, un tocco. Un breve elenco funziona meglio di un campo di testo libero:

• Troppo caro
• Non lo uso abbastanza
• Manca una funzione
• Passo a un altro prodotto
• Problemi tecnici
• Esigenza temporanea, tornerò
• Altro (con una casella di testo facoltativa)

Salva la risposta nel tuo database e, se utile, nei metadata dell’abbonamento, così viaggia con il record del cliente.

2. Fare un’offerta adatta

Ogni offerta deve corrispondere a qualcosa che Mollie sa davvero fare:

Motivo	Offerta	Come su Mollie
Troppo caro	Un prezzo più basso per qualche mese	PATCH sull’amount; programma un secondo aggiornamento per ripristinarlo
Non lo uso abbastanza	Un piano più economico o un intervallo più lungo	PATCH sull’amount e, se serve, sull’interval
Esigenza temporanea	Saltare un periodo	Sposta il prossimo addebito con startDate, oppure annulla e crea un nuovo abbonamento più avanti (provalo prima, vedi sotto)
Funzione mancante, cambio di prodotto, problemi tecnici	Nessuno sconto; chiedi dettagli, indirizza a una persona	Niente da cambiare su Mollie

Mollie applica un amount modificato a tutti gli addebiti futuri. Non esiste uno “sconto per 3 mesi” integrato, quindi uno sconto temporaneo significa ricordarsi di ripristinare l’importo, o creare l’abbonamento con times e uno successivo. Di’ al cliente esattamente quanto pagherà e da quando.

Per un’offerta “salta un periodo”, la documentazione di Mollie elenca startDate tra i campi che puoi aggiornare, ma non descrive nel dettaglio come questo sposti il prossimo addebito su un abbonamento attivo. Provalo in modalità test e controlla nextPaymentDate prima di offrirlo ai clienti. L’alternativa, annullare ora e creare più avanti un nuovo abbonamento sullo stesso mandato, è prevedibile ma dipende dal fatto che il mandato sia ancora valido in quel momento.

3. Disdire, sempre a un clic

Il pulsante di disdetta deve essere visibile a ogni passaggio, non nascosto dietro l’offerta. Un cliente che dice no all’offerta deve essere disdetto con un solo clic in più, con una conferma che indichi:

• che l’abbonamento è annullato,
• la data in cui termina l’accesso,
• che non verranno presi altri pagamenti.

Le regole a tutela dei consumatori in diversi paesi spingono in questa direzione (vedi le regole click-to-cancel), e così il semplice interesse su Mollie: un cliente che non trova come disdire un abbonamento con addebito diretto SEPA può chiedere alla sua banca di stornare l’addebito. Il centro assistenza di Mollie dice che non puoi contestare uno storno SEPA richiesto entro 8 settimane. Uno storno ti costa più di una disdetta pulita.

Collegarlo all’API

1. Carica l’abbonamento con Get subscription quando il cliente apre il flusso, così mostri l’importo, l’intervallo e la data del prossimo addebito corretti.
2. Su “accetta l’offerta”, chiama Update subscription con i nuovi valori, poi recuperalo di nuovo e mostra il risultato. Registra l’offerta e il motivo.
3. Su “disdici”, chiama Cancel subscription. Usa una chiave di idempotenza così un doppio clic non crea problemi, e mostra la conferma a partire dalla data di fine che hai salvato.
4. Riconcilia. Mollie può anche terminare un abbonamento da sé, per esempio dopo pagamenti falliti. Controlla regolarmente lo stato dell’abbonamento (o a ogni webhook di pagamento) perché la tua app e Mollie concordino.
5. Tieni un registro di ogni passaggio: motivo mostrato, offerta mostrata, offerta accettata o rifiutata, ora della disdetta. Ti servirà per le domande al supporto e per eventuali storni bancari successivi.

Cosa misurare

• Quota di clienti che avviano il flusso e accettano un’offerta.
• Quota di offerte accettate che pagano ancora tre mesi dopo.
• Motivi per piano, per fonte di iscrizione e per anzianità.
• Storni dopo la disdetta, che dovrebbero essere vicini a zero se il flusso è chiaro.

Fai attenzione al primo numero. Un’offerta che ritarda una disdetta di un mese non è un salvataggio.

Farlo con NoChurn

Mollie mantiene l’abbonamento, il mandato e gli addebiti. NoChurn aggiunge il flusso di disdetta vero e proprio: motivi, un’offerta adatta al motivo e una disdetta in un clic sempre visibile, ospitata da NoChurn o costruita nella tua interfaccia con l’API headless. Per Mollie, le offerte accettate cambiano l’importo dell’abbonamento e una disdetta termina l’abbonamento, tramite l’API di Mollie. I motivi alimentano le email di win-back ai giorni 30, 60 e 90 e il churn score. Vedi NoChurn + Mollie.