Skip to main content
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.
Dodo Payments crea quindi un tentativo di dunning e invia il webhook 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 page with enable toggle, four on-hold emails at 1, 3, 5, and 7 day intervals, and four cancelled emails at the same intervals

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 tentativo past_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.
Dunning email for an on-hold subscription showing store name, message about failed payment, subscription details with plan and amount, and an Update Payment Method button

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 for Pro Plan at $95.00/year with an Update payment method button and a warning banner about the failed payment

Customer portal showing an on-hold subscription with option to update payment method

Dopo che il cliente aggiorna il metodo di pagamento, Dodo Payments addebita gli importi ancora dovuti. Se il pagamento va a buon fine, l’abbonamento torna a 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 dunning entry counts, success rates, recovered revenue, and per-email performance breakdown

Recovery analytics dashboard showing ACR and dunning metrics

La sezione Dunning mostra queste metriche:

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_hold e subscription.cancelled per 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.
Ultima modifica il 26 settembre 2026