Subscription Dunning invia email ai clienti il cui abbonamento è scaduto dopo un pagamento non riuscito o che lo hanno annullato, chiedendo loro di aggiornare il metodo di pagamento o effettuare nuovamente l’acquisto. Funziona automaticamente dopo l’attivazione.
Che Cos’è la Gestione degli Abbonamenti?
Dunning rileva quando un abbonamento entra in uno stato recuperabile e invia una sequenza di email che invitano il cliente ad agire. Tre stati avviano una sequenza:- Abbonamenti On Hold: un pagamento di rinnovo non è riuscito, ad esempio a causa di fondi insufficienti o di una carta scaduta.
- Abbonamenti Past Due: un pagamento di rinnovo non è riuscito mentre è aperto un periodo di tolleranza.
- Abbonamenti annullati: il cliente ha annullato l’abbonamento dal Customer Portal.
Come Funziona la Gestione
1
Trigger
Un abbonamento entra in uno dei tre stati:
- On Hold: un pagamento di rinnovo non è riuscito.
- Past Due: un pagamento di rinnovo non è riuscito mentre è aperto un periodo di tolleranza.
- Cancelled: il cliente ha annullato l’abbonamento dal Customer Portal.
dunning.started. Non viene avviato alcun tentativo quando la sequenza corrispondente non contiene email abilitate; un abbonamento può avere al massimo un tentativo attivo alla volta.2
Grace Period
Se imposti un periodo di tolleranza, un rinnovo non riuscito sposta l’abbonamento a
past_due invece che a on_hold.La sequenza di email on-hold viene eseguita durante questa finestra, quindi al cliente viene chiesto di pagare mentre ha ancora accesso.Un pagamento non riuscito avvia una sequenza. La fine della finestra non ne avvia una seconda. Se la finestra termina con l’abbonamento on hold, le email rimanenti della sequenza vengono comunque inviate. Se termina con l’abbonamento annullato, il tentativo viene contrassegnato come exhausted.Il tentativo di dunning registra uno stato di attivazione past_due. Quando leggi le analisi di dunning, applica il filtro su past_due oltre che su on_hold.3
Email Sequence
In base allo stato di attivazione, Dodo Payments invia fino a 4 email di dunning agli intervalli configurati. Ogni email contiene un link al Customer Portal, dove il cliente può aggiornare il metodo di pagamento, oppure a un checkout dove può acquistare nuovamente un abbonamento annullato.
4
Recovery
Quando il cliente aggiorna il metodo di pagamento nel Customer Portal, Dodo Payments addebita automaticamente gli importi ancora dovuti. Se il pagamento va a buon fine, l’abbonamento viene riattivato e il tentativo di dunning viene contrassegnato come
recovered.Ciclo di vita degli stati
Ogni tentativo di dunning presenta uno di questi stati:Quando un tentativo di dunning viene contrassegnato come
exhausted, Dodo Payments non modifica l’abbonamento. Questo rimane nello stato attuale (past due, on hold o annullato).Configurazione di Dunning
Attiva e configura Dunning in Impostazioni → Recupero nella dashboard. Dunning è disattivato per impostazione predefinita.
Dunning settings in the dashboard showing enable toggle, on-hold sequence, and cancelled sequence
Sequenze di email
Dunning dispone di due sequenze di email, On Hold e Cancelled, ciascuna con un massimo di 4 email. Nella dashboard sono elencate come Email inviate al cliente quando l’abbonamento è on hold e Email inviate al cliente quando l’abbonamento è annullato. Un tentativopast_due utilizza la sequenza On Hold.
Ogni email presenta queste impostazioni:
In Riga dell’oggetto, Dodo Payments sostituisce questi segnaposto:
{store_name}, {store_owner_name}, {store_contact_email}, {subscription_id}, {failure_reason} e {payment_form_link}.
I ritardi predefiniti sono:
Esempi di email di Dunning
Dunning invia un’email diversa per ogni stato dell’abbonamento. Questi esempi mostrano ciò che vede il cliente.- On Hold
- Cancelled

Dunning email sent when a renewal payment fails and the subscription is on hold
Esperienza di recupero del cliente
Quando un cliente fa clic sul link in un’email di dunning on-hold, il Customer Portal si apre sull’abbonamento. Qui può visualizzare lo stato dell’abbonamento e aggiornare il metodo di pagamento.
Customer portal showing an on-hold subscription with option to update payment method
active.
Per un abbonamento annullato, il link apre una pagina di checkout con il prodotto dell’abbonamento già nel carrello.
Analisi
Monitora le prestazioni di Dunning in Analisi → Recupero nella dashboard.
Recovery analytics dashboard showing ACR and dunning metrics
Eventi webhook
Dunning invia due eventi webhook:Recovery Webhook Payloads
Visualizza gli schemi completi del payload webhook per gli eventi di dunning.
Casi limite
Dunning gestisce automaticamente questi casi:Best practice
- Inizia con i valori predefiniti: i ritardi predefiniti (1, 3, 5 e 7 giorni) distribuiscono le email nell’arco di una settimana, così i clienti non vengono sommersi ma ricevono comunque promemoria regolari.
- Monitora i tassi di recupero: controlla Tasso di recupero per email per vedere quale email genera più recuperi. Se le email successive recuperano quasi nulla, disattivale.
- Coordina l’assistenza: informa il team di supporto dell’invio delle email di dunning, così potrà aiutare i clienti che rispondono.
- Esamina gli stati degli abbonamenti: abbina Dunning ai webhook
subscription.on_holdesubscription.cancelledper monitorare l’intero ciclo di vita dell’abbonamento.
Dunning funziona insieme ai flussi esistenti on-hold e di riattivazione nel Customer Portal. Dopo l’attivazione, viene eseguito automaticamente senza richiedere attività di integrazione.
Correlati
Recovery Webhooks
Reagisci agli eventi
dunning.started e dunning.recovered.Abandoned Cart Recovery
Recupera checkout abbandonati o non riusciti con le email di recupero.
Customer Portal
I clienti aggiornano i propri metodi di pagamento nel Customer Portal.
Subscriptions
Gli stati degli abbonamenti che attivano Dunning.
