Gestire i pagamenti ricorrenti falliti con Mollie

Mollie rende semplice avviare i pagamenti ricorrenti: un primo pagamento crea un mandato, e abbonamenti o addebiti su richiesta si basano su quel mandato. Cosa succede quando uno di questi addebiti fallisce è meno evidente. Mollie riprova? Quando cancella l’abbonamento? Cosa riceve davvero il tuo webhook? E come riporti un cliente su un metodo di pagamento funzionante?

Questa guida risponde a queste domande partendo dalla documentazione di Mollie: Recurring payments, Webhooks, Next-gen webhooks, Status reasons, la Chargebacks API, Update subscription e gli articoli del centro assistenza di Mollie sui pagamenti SEPA Direct Debit falliti e sui mandati dopo uno storno (tutti consultati a novembre 2026).

Come funzionano i pagamenti ricorrenti di Mollie

Il modello di Mollie ha tre elementi, descritti nella guida ai pagamenti ricorrenti:

1. Un primo pagamento. Crei un pagamento per un cliente con sequenceType impostato su first. Il cliente lo completa con il normale checkout.
2. Un mandato. Quando il primo pagamento va a buon fine, Mollie salva un mandato per quel cliente e quel metodo di pagamento. Un mandato non limita né l’importo né il numero di addebiti.
3. Addebiti ricorrenti. O crei tu i pagamenti con sequenceType impostato su recurring (serve un mandato con stato valid), oppure crei un abbonamento e Mollie addebita in base al suo intervallo. Per gli abbonamenti il cliente ha bisogno di un mandato con stato pending o valid.

Il cliente passa dal checkout una sola volta. È il punto di forza del modello, ed è anche il motivo per cui il recupero è diverso rispetto alle piattaforme con carta salvata: quando un mandato smette di funzionare, sul mandato stesso non c’è un modulo «aggiorna la carta». Il cliente deve fare un nuovo primo pagamento.

Cosa succede quando un pagamento dell’abbonamento fallisce

Mollie riprova. Secondo la guida ai pagamenti ricorrenti:

• Se un pagamento dell’abbonamento fallisce, Mollie può riprovarlo fino a 5 volte, una volta al giorno, a seconda del motivo del fallimento.
• Il comportamento dei nuovi tentativi può variare per metodo di pagamento e motivo del fallimento.
• Se un nuovo tentativo va a buon fine, la data del prossimo addebito viene aggiornata in base all’ultimo pagamento riuscito e al tuo intervallo.
• Una volta esauriti tutti i tentativi, l’abbonamento viene cancellato.

Alcuni motivi di fallimento saltano questo schema. La stessa pagina elenca motivi che cancellano subito l’abbonamento e altri che lo cancellano dopo episodi ripetuti:

Comportamento	Esempi di motivi SEPA elencati da Mollie
Cancellazione immediata	IBAN non valido (AC01), conto chiuso (AC04), debitore deceduto (MD07)
Cancellazione dopo che lo stesso problema si ripete	Nessun mandato (MD01), storno richiesto dal cliente (MD06), rifiuto del debitore (MS02), motivo non specificato

Se l’abbonamento ha un mandato fisso impostato (il suo campo mandateId), cancellarlo per questi motivi revoca anche il mandato.

Una cautela: un vecchio articolo di assistenza di Mollie indica una soglia diversa per gli abbonamenti SEPA (cancellazione dopo 2 fallimenti, non applicabile ai fondi insufficienti). La documentazione per sviluppatori è il riferimento più recente, ma testa il comportamento per i tuoi metodi di pagamento invece di dare per scontato un numero. Per i fondi insufficienti (AM04), il centro assistenza di Mollie suggerisce di riprovare l’addebito diretto o di contattare il cliente.

Due conseguenze pratiche:

• Devi sapere quando Mollie ha cancellato un abbonamento, perché la tua app deve reagire. Gli abbonamenti cancellati non possono essere aggiornati tramite l’API, quindi recuperare significa creare un nuovo abbonamento.
• I nuovi tentativi da soli non risolvono un conto chiuso o un mandato revocato. Questi clienti devono pagare di nuovo tramite il checkout.

Webhook che portano solo un ID

I webhook classici di Mollie sono volutamente minimi. Come spiega il riferimento sui webhook, Mollie chiama il tuo webhookUrl con un parametro POST id, l’ID dell’oggetto che è cambiato (per un pagamento, id=tr_...), e nient’altro. Il tuo handler deve recuperare l’oggetto dall’API e leggerne lo stato attuale.

Cosa costruire attorno a questo:

1. Recupera sempre. Non dedurre cosa è successo dal fatto che sia arrivata una chiamata. Leggi il pagamento, controllane lo stato e, per i pagamenti degli abbonamenti, controlla l’ID dell’abbonamento e lo stato dell’abbonamento stesso.
2. Rispondi HTTP 200 in fretta. Mollie considera qualsiasi altra risposta, o una risposta più lenta di 15 secondi, un fallimento e riprova a intervalli crescenti, fino a 10 tentativi in circa 26 ore. Non puoi riattivare manualmente una chiamata webhook da Mollie.
3. Rendi l’elaborazione idempotente. Lo stesso pagamento può essere segnalato più di una volta, e lo stato che leggi può essere cambiato da quando la chiamata è partita.
4. Riconcilia a intervalli regolari. Poiché non puoi rigiocare le chiamate, un job periodico che elenca pagamenti e abbonamenti recenti recupera tutto ciò che un endpoint in errore ha perso.

Mollie offre anche i next-gen webhooks, firmati con un header X-Mollie-Signature calcolato con il tuo secret del webhook. Se li usi, verifica la firma prima di agire. In ogni caso, considera la tua lettura dall’API come fonte di verità.

Chargeback

I clienti possono stornare i pagamenti, e Mollie li espone tramite la Chargebacks API:

• GET /v2/chargebacks elenca i chargeback di tutti i tuoi pagamenti, dal più recente, con paginazione.
• Gli endpoint a livello di pagamento elencano o recuperano i chargeback di un singolo pagamento.

Per il SEPA Direct Debit un cliente può stornare un pagamento entro 8 settimane e, secondo il centro assistenza di Mollie, Mollie revoca il mandato dopo uno storno. Qualsiasi addebito successivo richiede un nuovo mandato, quindi un chargeback su un pagamento ricorrente è anche un problema di metodo di pagamento, non solo un importo perso. Per le contestazioni sulle carte, l’articolo sui chargeback delle carte di Mollie spiega che, a seconda del caso, potresti poter rispondere con della documentazione entro un numero limitato di giorni.

Quando arriva un chargeback su un abbonamento, decidi in modo esplicito: sospendere l’accesso, contattare il cliente o chiudere l’abbonamento. Non lasciare che sia il prossimo addebito programmato a scoprire che il mandato non c’è più.

Chiedere al cliente di pagare di nuovo

Quando i tentativi sono finiti, il mandato è revocato o il conto è chiuso, recuperare significa riportare il cliente al checkout. Il flusso che segue il modello documentato da Mollie:

1. Rileva il fallimento dal tuo handler del webhook dopo aver recuperato il pagamento, e annota il motivo del fallimento dal riferimento status reasons quando disponibile.
2. Scrivi al cliente il giorno stesso. Spiega che il pagamento non è andato a buon fine, senza citare codici bancari, e includi un solo link.
3. Fai puntare il link a un nuovo primo pagamento. Crea un pagamento per lo stesso cliente con sequenceType first per l’importo dovuto. Pagarlo salda quanto dovuto e crea un nuovo mandato in un solo passaggio. I payment links di Mollie sono un altro modo per incassare l’importo, ma verifica se il metodo che usi crea un mandato per gli addebiti futuri.
4. Riavvia l’abbonamento sul nuovo mandato una volta pagato. Se Mollie aveva già cancellato il vecchio abbonamento, creane uno nuovo con una data di inizio coerente con il periodo appena pagato dal cliente.
5. Invia dei promemoria se il link non viene usato: dopo qualche giorno, poi un ultimo avviso con la data in cui termina l’accesso.
6. Offri un altro metodo di pagamento nel promemoria. Un cliente il cui conto bancario è stato chiuso potrebbe preferire una carta, e il primo pagamento gli permette di scegliere.

Una checklist

• Il tuo handler del webhook recupera ogni oggetto e risponde 200 in fretta.
• Salvi lo stato dell’abbonamento e reagisci quando Mollie lo cancella.
• I motivi definitivi (conto chiuso, IBAN non valido, mandato revocato) portano subito a un’email «paga di nuovo», senza attendere.
• I fondi insufficienti ricevono tempo: i nuovi tentativi di Mollie, più un promemoria.
• I chargeback vengono controllati e segnano il mandato come inutilizzabile nella tua app.
• Un job programmato riconcilia pagamenti e abbonamenti nel caso in cui alcune chiamate webhook siano andate perse.

Farlo con NoChurn

L’elaborazione dei pagamenti, i mandati, i nuovi tentativi di Mollie e i dati di carte e conti restano tutti su Mollie. NoChurn si collega al tuo account Mollie, importa clienti, mandati e abbonamenti e, poiché i webhook di Mollie portano solo un ID, rilegge il pagamento prima di agire. Aggiunge email di recupero scritte dall’IA che controlli prima dell’invio, con un link per pagare di nuovo e impostare un nuovo metodo di pagamento. I chargeback sono mostrati in sola lettura nella timeline del cliente e contano nel churn score da 0 a 100. NoChurn aggiunge anche flussi di disdetta con motivi, offerte e una disdetta in un clic sempre visibile, ed email di win-back a 30, 60 e 90 giorni basate sul motivo della disdetta. Vedi NoChurn + Mollie.