> ## Documentation Index
> Fetch the complete documentation index at: https://docs.dodopayments.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Gestione degli Abbonamenti

> Invia automaticamente sequenze di email per recuperare abbonamenti scaduti o cancellati chiedendo ai clienti di aggiornare il loro metodo di pagamento.

<Info>
  La Gestione degli Abbonamenti invia automaticamente sequenze di email ai clienti i cui abbonamenti sono scaduti a causa di un pagamento fallito o cancellazione da parte del cliente, chiedendo loro di aggiornare il loro metodo di pagamento e riattivarli.
</Info>

## Che Cos'è la Gestione degli Abbonamenti?

La Gestione rileva automaticamente quando un abbonamento entra in uno stato recuperabile e invia una sequenza di email chiedendo al cliente di agire:

* **Abbonamenti in sospeso**: Pagamento del rinnovo fallito (fondi insufficienti, carta scaduta, ecc.)
* **Abbonamenti cancellati**: Cancellazione da parte del cliente tramite il portale clienti

## Come Funziona la Gestione

<Steps>
  <Step title="Trigger">
    La gestione viene attivata quando un abbonamento entra in uno dei due stati:

    * **In sospeso**: Pagamento del rinnovo fallito (fondi insufficienti, carta scaduta, ecc.)
    * **Cancellato**: Il cliente ha cancellato il proprio abbonamento dal portale clienti
  </Step>

  <Step title="Email Sequence">
    In base allo stato di attivazione, il sistema invia fino a 4 email di gestione a intervalli configurati. Ogni email include un link al portale clienti dove il cliente può aggiornare il proprio metodo di pagamento o riacquistare l'abbonamento.
  </Step>

  <Step title="Recovery">
    Quando il cliente aggiorna il suo metodo di pagamento tramite il portale clienti, viene automaticamente creato un addebito per i saldi rimanenti. Se il pagamento ha successo, l'abbonamento viene riattivato e il tentativo di gestione viene contrassegnato come recuperato.
  </Step>
</Steps>

## Ciclo di Vita degli Stati

| Stato        | Descrizione                                                                               |
| ------------ | ----------------------------------------------------------------------------------------- |
| `recovering` | Il tentativo di gestione è attivo; le email vengono inviate                               |
| `recovered`  | Il cliente ha aggiornato il metodo di pagamento e il pagamento è riuscito                 |
| `exhausted`  | Tutte le email inviate senza recupero, o stato dell'abbonamento cambiato inaspettatamente |

<Info>
  Quando un tentativo di gestione è contrassegnato come `exhausted`, lo stato dell'abbonamento non viene modificato. L'abbonamento rimane nel suo stato attuale (in sospeso o cancellato).
</Info>

## Configurare la Gestione

Attiva e configura la gestione dalle **Impostazioni** nel tuo dashboard.

<Frame caption="Dunning settings in the dashboard showing enable toggle, on-hold sequence, and cancelled sequence">
  <img src="https://mintcdn.com/dodopayments/tvJ2MmXYymW0IZ3R/images/recovery/dunning-settings.png?fit=max&auto=format&n=tvJ2MmXYymW0IZ3R&q=85&s=7389a9413d6008800e7ca8a5c4cd1ee5" alt="Pagina delle impostazioni di gestione con attivazione toggle, quattro email in sospeso a intervalli di 1, 3, 5 e 7 giorni, e quattro email cancellate agli stessi intervalli" style={{ maxHeight: '500px', width: 'auto' }} width="2250" height="1628" data-path="images/recovery/dunning-settings.png" />
</Frame>

### Sequenze di Email

La gestione supporta due sequenze di email — **In Sospeso** e **Cancellato** — ciascuna con un massimo di 4 email configurabili.

Ogni email ha i seguenti campi configurabili:

| Impostazione   | Descrizione                                                    |
| -------------- | -------------------------------------------------------------- |
| **Abilitato**  | Attiva o disattiva singole email senza eliminarle              |
| **Ritardo**    | Quanto tempo dopo l'evento di attivazione inviare questa email |
| **Oggetto**    | Oggetto dell'email con segnaposti variabili                    |
| **Corpo**      | Corpo dell'email HTML con segnaposti variabili                 |
| **Rispondi-A** | Indirizzo email per le risposte dei clienti                    |

**Tempi di invio email predefiniti:**

| Sequenza   | Email # | Ritardo predefinito |
| ---------- | ------- | ------------------- |
| In Sospeso | 1       | 1 giorno            |
| In Sospeso | 2       | 3 giorni            |
| In Sospeso | 3       | 5 giorni            |
| In Sospeso | 4       | 7 giorni            |
| Cancellato | 1       | 1 giorno            |
| Cancellato | 2       | 3 giorni            |
| Cancellato | 3       | 5 giorni            |
| Cancellato | 4       | 7 giorni            |

### Esempio di Email di Gestione

La gestione invia diverse email a seconda dello stato dell'abbonamento. Di seguito sono riportati esempi di ciascun tipo come visto dal cliente.

<Tabs>
  <Tab title="On Hold">
    <Frame caption="Dunning email sent when a renewal payment fails and the subscription is on hold">
      <img src="https://mintcdn.com/dodopayments/tvJ2MmXYymW0IZ3R/images/recovery/dunning-on-hold-email.png?fit=max&auto=format&n=tvJ2MmXYymW0IZ3R&q=85&s=5e46040ed49a4da84569afdeeb87c813" alt="Email di gestione per un abbonamento in sospeso che mostra il nome del negozio, messaggio sul pagamento fallito, dettagli dell'abbonamento con piano e importo, e un pulsante Aggiorna Metodo di Pagamento" style={{ maxHeight: '500px', width: 'auto' }} width="1070" height="1502" data-path="images/recovery/dunning-on-hold-email.png" />
    </Frame>
  </Tab>

  <Tab title="Cancelled">
    <Frame caption="Dunning email sent when a customer cancels their subscription">
      <img src="https://mintcdn.com/dodopayments/tvJ2MmXYymW0IZ3R/images/recovery/dunning-cancelled-email.png?fit=max&auto=format&n=tvJ2MmXYymW0IZ3R&q=85&s=f404fbf9415df4e4bd01562a90bd2456" alt="Email di gestione per un abbonamento cancellato che mostra il nome del negozio, messaggio sulla cancellazione, dettagli dell'abbonamento con piano e importo, e un pulsante Riacquista Abbonamento" style={{ maxHeight: '500px', width: 'auto' }} width="1070" height="1502" data-path="images/recovery/dunning-cancelled-email.png" />
    </Frame>
  </Tab>
</Tabs>

## Esperienza di Recupero Cliente

Quando un cliente clicca sul link in un'email di gestione, viene indirizzato al portale clienti dove può vedere lo stato del suo abbonamento e aggiornare il suo metodo di pagamento.

<Frame caption="Customer portal showing an on-hold subscription with option to update payment method">
  <img src="https://mintcdn.com/dodopayments/tvJ2MmXYymW0IZ3R/images/recovery/customer-recovery-page.png?fit=max&auto=format&n=tvJ2MmXYymW0IZ3R&q=85&s=f498d3654afd3d70447b7b8ce7bf3767" alt="Portale clienti che mostra un abbonamento in sospeso per il Piano Pro a $95.00/annuo con un pulsante Aggiorna metodo di pagamento e un avviso sul pagamento fallito" style={{ maxHeight: '500px', width: 'auto' }} width="2144" height="734" data-path="images/recovery/customer-recovery-page.png" />
</Frame>

Dopo che il cliente aggiorna il suo metodo di pagamento, viene automaticamente creato un addebito per eventuali importi dovuti. Se il pagamento ha successo, l'abbonamento viene riattivato immediatamente.

Per un abbonamento cancellato, il cliente viene indirizzato a una pagina di checkout che ha già l'abbonamento aggiunto come prodotto.

## Analisi

Monitora le prestazioni della gestione dalla scheda **Recupero** nella sezione **Analisi** del tuo dashboard.

<Frame caption="Recovery analytics dashboard showing ACR and dunning metrics">
  <img src="https://mintcdn.com/dodopayments/B3-0kuKcZDP1TiJD/images/recovery/recovery-analytics.png?fit=max&auto=format&n=B3-0kuKcZDP1TiJD&q=85&s=d3bf0c7474818bc4584b75654423e14c" alt="Dashboard delle analisi di recupero che mostra il conteggio delle voci di gestione, le percentuali di successo, le entrate recuperate e la suddivisione delle prestazioni per email" style={{ maxHeight: '500px', width: 'auto' }} width="2548" height="2190" data-path="images/recovery/recovery-analytics.png" />
</Frame>

| Metrica                     | Descrizione                                                          |
| --------------------------- | -------------------------------------------------------------------- |
| **Voci di Gestione**        | Numero totale di tentativi di gestione creati                        |
| **Percentuale di Successo** | Percentuale di tentativi di gestione che hanno portato a un recupero |
| **Entrate Recuperate**      | Entrate totali recuperate tramite la gestione                        |
| **Recupero per Tentativo**  | Suddivisione di quale email nella sequenza ha portato al recupero    |

## Eventi Webhook

| Evento              | Descrizione                                                 |
| ------------------- | ----------------------------------------------------------- |
| `dunning.started`   | È stato avviato un tentativo di gestione per un abbonamento |
| `dunning.recovered` | Un abbonamento è stato recuperato tramite la gestione       |

<Card title="Recovery Webhook Payloads" icon="code" href="/developer-resources/webhooks/intents/recovery">
  Visualizza gli schemi completi del payload webhook per gli eventi di gestione.
</Card>

## Casi Limite

| Scenario                                                            | Comportamento                                                                                           |
| ------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------- |
| Il cliente aggiorna il metodo di pagamento prima di qualsiasi email | Il recupero viene rilevato; il tentativo di gestione viene contrassegnato come recuperato               |
| Il cliente acquista un altro abbonamento dalla stessa azienda       | Il tentativo di gestione viene contrassegnato come esaurito                                             |
| Tutte le email di gestione esaurite                                 | Il tentativo di gestione viene contrassegnato come esaurito; lo stato dell'abbonamento non è modificato |

## Pratiche Migliori

* **Inizia con i predefiniti**: La tempistica predefinita delle email è progettata con spaziatura ragionevole (1, 3, 5 e 7 giorni) per evitare di sovraccaricare i clienti pur mantenendo l'urgenza.
* **Monitora le percentuali di successo**: Monitora quale email nella sequenza guida il maggior numero di recuperi. Se le email successive hanno conversioni quasi zero, considera di disattivarle.
* **Coordina con il supporto**: Assicurati che il tuo team di supporto sappia che vengono inviate email di gestione, così possono assistere i clienti che si rivolgono a loro.
* **Rivedi gli stati degli abbonamenti**: Abbina la gestione ai webhook `subscription.on_hold` e `subscription.cancelled` per un monitoraggio completo del ciclo di vita.

<Info>
  La gestione funziona insieme ai flussi di abbonamenti in sospeso e di riattivazione esistenti nel portale clienti. Una volta abilitato, funziona automaticamente senza richiedere integrazioni aggiuntive.
</Info>

## Correlati

<CardGroup cols={2}>
  <Card title="Recovery Webhooks" icon="webhook" href="/developer-resources/webhooks/intents/recovery">
    Reagisci agli eventi `dunning.started` e `dunning.recovered`.
  </Card>

  <Card title="Abandoned Cart Recovery" icon="cart-shopping" href="/features/recovery/abandoned-cart-recovery">
    Recupera checkout incompleti o falliti una tantum con email mirate.
  </Card>

  <Card title="Customer Portal" icon="id-card" href="/features/customer-portal">
    I clienti aggiornano i metodi di pagamento tramite il portale clienti.
  </Card>

  <Card title="Subscriptions" icon="repeat" href="/features/subscription">
    Comprendi gli stati degli abbonamenti che attivano i flussi di gestione.
  </Card>
</CardGroup>
