Come recuperare i pagamenti falliti in Chargebee

Chargebee ha un sistema di solleciti maturo: classifica gli errori di pagamento, ritenta secondo il proprio calendario o il tuo, scrive ai clienti con un link per aggiornare la carta e applica un’azione finale quando niente funziona. Gran parte del recupero che puoi ottenere da Chargebee si riduce a una manciata di impostazioni e a quanto sono scritte bene le tue email. Questa guida spiega quelle impostazioni e cosa aggiungerci intorno.

Si attiene alla documentazione di Chargebee: Dunning, Smart and manual dunning, What is Smart Dunning, quale webhook scatta durante il dunning, l’API Invoices, l’evento payment_failed, il Self-Serve Portal e come i clienti aggiornano il metodo di pagamento (tutti consultati a novembre 2026). Chargebee ha due generazioni di dunning; questa guida descrive quella attuale e segnala dove la versione precedente è diversa.

Come funziona il dunning di Chargebee

Quando l’addebito di un rinnovo automatico fallisce, la fattura entra in dunning. Chargebee poi ritenta il pagamento e invia email di promemoria durante un periodo di dunning: il numero di giorni in cui la fattura resta in dunning prima che venga eseguita l’azione finale. I nuovi tentativi avvengono solo all’interno di quella finestra.

Con l’incasso automatico attivo, l’abbonamento resta Active durante il dunning. Cosa succede dopo dipende dalle tue impostazioni.

Due modalità di nuovo tentativo

La pagina Dunning di Chargebee descrive due modalità:

	Modalità Smart	Modalità Custom
Chi sceglie i tempi	Chargebee, in base all’errore del gateway	Tu, in giorni dopo il primo fallimento
Nuovi tentativi massimi	Fino a 12	Fino a 5
Rifiuti hard	Non ritentati finché il metodo di pagamento non cambia	La documentazione descrive tentativi nei giorni che imposti
Date esatte	Non garantite	Fisse

La modalità Smart classifica i codici di errore del gateway come rifiuti hard o soft. I rifiuti hard aspettano che il cliente aggiorni il metodo di pagamento. Per i rifiuti soft, Chargebee sceglie un momento per ritentare in base alla categoria dell’errore e alle probabilità di recupero. La documentazione di Chargebee dice che in questa modalità le date esatte dei tentativi non possono essere garantite. Anche un “Collect Now” manuale conta come tentativo. Un articolo di aiuto di Chargebee nota che Smart Dunning è disponibile da determinati piani, quindi verifica il tuo.

La modalità Custom ti permette di impostare i giorni dei tentativi. L’esempio di Chargebee: con un periodo di dunning di 8 giorni e una frequenza di “1,4,8”, i tentativi avvengono 1, 4 e 8 giorni dopo il primo fallimento.

Chargebee promuove anche Revive, una modalità di nuovi tentativi basata sul machine learning che opera entro i limiti di Smart Dunning. Verifica con Chargebee la disponibilità sul tuo piano.

Fallimenti 3D Secure

Qualunque modalità tu scelga, Chargebee dice che i pagamenti falliti a causa di 3D Secure vengono ritentati solo il giorno prima della fine del periodo di dunning, se il cliente non ha agito. Questi clienti devono completare l’autenticazione da soli, quindi è l’email a recuperarli, non il nuovo tentativo.

L’azione finale

Quando tutti i tentativi falliscono, scegli cosa succede:

all’abbonamento: disdirlo o mantenerlo attivo;
alla fattura: segnarla come non pagata, stralciarla o annullarla.

Disdire è l’opzione rigida; mantenere attivo l’abbonamento con la fattura non pagata ti dà più tempo per raggiungere il cliente, al prezzo di servire qualcuno che non ha pagato. Scegli consapevolmente invece di lasciare l’impostazione predefinita.

Dunning v1

I siti più vecchi potrebbero essere ancora su Dunning v1. Gli articoli di aiuto di Chargebee indicano numeri di tentativi diversi per la v1, quindi se il tuo sito la usa, controlla le impostazioni nella dashboard invece di affidarti a un articolo, e valuta il passaggio alla versione attuale.

Email di sollecito e link di aggiornamento della carta

Chargebee invia email di sollecito durante i tentativi, e quelle email includono un link dove il cliente può aggiornare il metodo di pagamento sulle pagine ospitate di Chargebee (guida all’aggiornamento del metodo di pagamento). Chargebee può anche avvisare i clienti quando una carta sta per scadere, è scaduta o non è più valida.

Ci sono altri tre modi per ottenere un nuovo metodo di pagamento:

Request payment method. Dalla pagina di un cliente o di un abbonamento nella dashboard, il personale può inviare un link sicuro alla pagina ospitata di Chargebee.
Self-Serve Portal. Una volta attivato in Settings › Configure Chargebee › Checkout and Self-Serve Portal, i clienti possono gestire i metodi di pagamento e pagare le fatture non saldate (Self-Serve Portal).
API. L’API delle pagine ospitate per gestire le fonti di pagamento restituisce un URL a cui reindirizzare il cliente, se vuoi il link nella tua app o nelle tue email.

I modelli di email predefiniti sono un punto di partenza. Modificali perché il cliente riconosca il tuo marchio, capisca cosa è fallito e veda un solo pulsante chiaro.

Eventi e webhook

L’indicazione di Chargebee per seguire il dunning è ascoltare payment_failed e leggere il dunning_status della fattura:

`dunning_status`	Significato
`in_progress`	La fattura è in dunning, restano tentativi
`exhausted`	L’ultimo tentativo è fallito; il periodo di dunning è finito
`success`	Un pagamento è stato incassato durante il dunning
`stopped`	Il dunning è stato fermato per questa fattura

Ogni tentativo fallito durante il dunning genera un evento payment_failed; solo l’ultimo porta exhausted (quale evento segna la chiusura del dunning). payment_succeeded scatta quando un pagamento viene incassato. Usali per mantenere sincronizzati i tuoi registri, per fermare ogni comunicazione aggiuntiva nel momento in cui un pagamento riesce e per sapere quando è avvenuta l’azione finale.

Una configurazione di recupero, passo dopo passo

Scegli una modalità di nuovo tentativo. La modalità Smart è la scelta predefinita sensata per i pagamenti con carta se il tuo piano la include, perché evita tentativi inutili sui rifiuti hard. Usa la modalità Custom se ti servono date prevedibili, per esempio per allinearti a quando vengono pagati i tuoi clienti.
Imposta il periodo di dunning in base al tuo ciclo di fatturazione. Un piano mensile non può aspettare quanto uno annuale.
Scegli consapevolmente l’azione finale per l’abbonamento e per la fattura.
Attiva e riscrivi le email di sollecito. Invia la prima al primo fallimento, con il link di aggiornamento. Per i rifiuti hard, l’email è l’unica cosa che recupererà il pagamento.
Gestisci 3D Secure separatamente. Di’ a quei clienti che la loro banca ha bisogno che confermino il pagamento, e invia subito il link.
Attiva il Self-Serve Portal così i clienti che ignorano l’email possono comunque sistemare la carta dalla tua app.
Attiva gli avvisi di scadenza della carta per intercettare i fallimenti prima che accadano.
Ascolta payment_failed e payment_succeeded e registra l’esito per tipo di errore, così puoi vedere quali fallimenti la tua configurazione recupera e quali no.

Cosa aggiungere sopra

I tentativi e le email di Chargebee coprono bene le basi. Quello che lascia a te è soprattutto la comunicazione: email che sembrano scritte da una persona, nella lingua del cliente, che dicono cosa fare per il fallimento specifico; risposte che arrivano a qualcuno; e un follow-up per i clienti persi, così puoi provare a riconquistarli.

Farlo con NoChurn

NoChurn si collega al tuo sito Chargebee con una chiave API e ne segue i webhook. Lavora accanto alle tue impostazioni di dunning Chargebee: invia email di recupero scritte dall’IA, riviste da te, con un link perché il cliente aggiorni il metodo di pagamento, e aggiunge flussi di disdetta, email di win-back a 30, 60 e 90 giorni e un punteggio di churn da 0 a 100. Fatturazione, addebito e gateway di pagamento restano a Chargebee. Le contestazioni arrivano dal gateway dietro Chargebee; con Stripe o Braintree, NoChurn raccoglie le prove e redige una risposta inviata solo dopo la tua revisione. NoChurn è gratuito sotto i 300 $ di MRR. Vedi NoChurn + Chargebee.