> ## 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.

# Componenti aggiuntivi per abbonamenti

> Migliora i tuoi prodotti in abbonamento con componenti aggiuntivi flessibili per la fatturazione basata su posti, aggiornamenti delle funzionalità e modelli di prezzo creativi

<Info>
  Gli add-on sono prodotti aggiuntivi che possono essere collegati ai tuoi prodotti di abbonamento principali, consentendo modelli di prezzo flessibili e esperienze cliente potenziate. Che tu abbia bisogno di fatturazione basata sui posti, aggiornamenti delle funzionalità o strutture di prezzo personalizzate, gli add-on ti danno il potere di creare proposte di abbonamento sofisticate.
</Info>

<CardGroup cols={2}>
  <Card title="Seat-Based Billing" icon="users" href="/developer-resources/seat-based-pricing">
    Crea add-on per posti aggiuntivi del team, licenze utente o aggiornamenti di capacità con prezzi per posto.
  </Card>

  <Card title="Usage Extensions" icon="bolt" href="/features/usage-based-billing/introduction">
    Estendi i limiti d'uso, le chiamate API o le quote di dati con prezzi flessibili per i componenti aggiuntivi.
  </Card>
</CardGroup>

## Cosa sono gli add-on?

Gli add-on sono prodotti supplementari che i clienti possono acquistare insieme all'abbonamento principale. Sono perfetti per:

* **Fatturazione basata sui posti**: membri del team aggiuntivi, licenze utente o utenti concorrenti
* **Aggiornamenti delle funzionalità**: funzionalità premium, analisi avanzate o supporto prioritario
* **Estensioni d'uso**: spazio di archiviazione extra, chiamate API o quote di larghezza di banda
* **Add-on di servizio**: servizi professionali, formazione o ore di consulenza

<Frame>
  <img src="https://mintcdn.com/dodopayments/ajOhO6Du1yNsg0hy/images/cookbooks/seat-based/seat-based-addons.png?fit=max&auto=format&n=ajOhO6Du1yNsg0hy&q=85&s=ea4ce0d437201c92590eea6c31a14e80" alt="Componenti aggiuntivi collegati ai prodotti in abbonamento nel dashboard" style={{ maxHeight: '500px', width: 'auto' }} width="2338" height="1196" data-path="images/cookbooks/seat-based/seat-based-addons.png" />
</Frame>

## Vantaggi principali

* **Modelli di prezzo flessibili**: Offri piani base con add-on opzionali per creare strutture di prezzo sofisticate. Puoi soddisfare segmenti di clientela diversi con upgrade che crescono man mano che le esigenze cambiano.
* **Ottimizzazione dei ricavi**: Aumenta il tuo ricavo medio per utente (ARPU) presentando add-on rilevanti. Ciò consente opportunità di upsell naturali man mano che i clienti aggiungono funzionalità.
* **Gestione semplificata**: Gestisci tutti i componenti di prezzo da un unico dashboard. Gli add-on vengono inclusi automaticamente sia nelle sessioni di checkout sia nella gestione degli abbonamenti.
* **Scelta del cliente**: Consenti ai clienti di personalizzare il proprio abbonamento selezionando solo gli add-on di cui hanno bisogno, migliorando così la soddisfazione e riducendo il churn.

## Creare add-on

Gli add-on vengono creati come prodotti separati nel dashboard di Dodo Payments e poi associati ai prodotti di abbonamento principali. Questa separazione ti consente di:

* Riutilizzare gli add-on su più prodotti di abbonamento
* Gestire i prezzi in modo indipendente
* Monitorare separatamente le performance degli add-on
* Aggiornare gli add-on senza influire sugli abbonamenti base

<Frame>
  <img src="https://mintcdn.com/dodopayments/ajOhO6Du1yNsg0hy/images/cookbooks/seat-based/seat-based-addons-creation.png?fit=max&auto=format&n=ajOhO6Du1yNsg0hy&q=85&s=d2c17b4a9f2f9a1b19f537f0507656a4" alt="Creazione di componenti aggiuntivi nell'interfaccia del dashboard" style={{ maxHeight: '500px', width: 'auto' }} width="2348" height="1606" data-path="images/cookbooks/seat-based/seat-based-addons-creation.png" />
</Frame>

### Configurazione dell'add-on

Durante la creazione degli add-on puoi configurare:

* **Prezzo**: Imposta un prezzo una tantum o ricorrente per l'add-on
* **Ciclo di fatturazione**: Deve corrispondere al ciclo dell'abbonamento
* **Limiti di quantità**: Imposta quantità minime e massime per cliente
* **Disponibilità**: Controlla quali prodotti di abbonamento possono utilizzare l'add-on
* **Impostazioni fiscali**: Configura le categorie fiscali appropriate

### Per iniziare

Pronto a implementare gli add-on nel tuo business in abbonamento? Ecco come iniziare:

<Steps>
  <Step title="Plan Your Add-ons">
    Individua le funzionalità, i servizi o le capacità che potrebbero avvantaggiare i tuoi clienti come add-on.

    Considera:

    * Cosa richiedono frequentemente i clienti?
    * Quali funzionalità potrebbero essere monetizzate separatamente?
    * Cosa creerebbe percorsi di upgrade naturali?
  </Step>

  <Step title="Create Your First Add-on">
    Usa il dashboard o l'API di Dodo Payments per creare il tuo primo prodotto add-on.

    <Card title="Dashboard Guide" icon="box" href="/developer-resources/seat-based-pricing">
      Segui la nostra guida passo passo per creare add-on nel dashboard.
    </Card>
  </Step>

  <Step title="Attach to Subscriptions">
    Collega gli add-on ai prodotti di abbonamento appropriati dove devono essere disponibili.
  </Step>

  <Step title="Test Integration">
    Crea sessioni di checkout di test con diverse combinazioni di add-on per garantire che tutto funzioni correttamente.
  </Step>

  <Step title="Monitor Performance">
    Monitora i tassi di adozione degli add-on e l'impatto sui ricavi per ottimizzare la strategia di pricing.
  </Step>
</Steps>

## Gestione tramite API

Dodo Payments fornisce un'API completa per gestire gli add-on in modo programmatico:

<AccordionGroup>
  <Accordion title="Create Add-ons">
    Usa l'endpoint `POST /addons` per creare nuovi add-on con prezzi, descrizioni e opzioni di configurazione personalizzate.

    <Card title="API Reference" icon="code" href="/api-reference/addons/create-addon">
      Consulta la documentazione API completa per la creazione di add-on.
    </Card>
  </Accordion>

  <Accordion title="Update Add-ons">
    Modifica gli add-on esistenti usando l'endpoint `PATCH /addons/{id}` per aggiornare prezzi, descrizioni o disponibilità.

    <Card title="API Reference" icon="code" href="/api-reference/addons/update-addon">
      Scopri come aggiornare i dettagli degli add-on in modo programmatico.
    </Card>
  </Accordion>

  <Accordion title="List and Retrieve">
    Usa `GET /addons` per elencare tutti gli add-on o `GET /addons/{id}` per recuperare i dettagli di un add-on specifico.

    <Card title="API Reference" icon="code" href="/api-reference/addons/list-addons">
      Accedi alla documentazione API completa per l'elenco e il recupero.
    </Card>
  </Accordion>

  <Accordion title="Image Management">
    Aggiorna le immagini degli add-on usando l'endpoint `PUT /addons/{id}/images` per una migliore presentazione del prodotto.

    <Card title="API Reference" icon="code" href="/api-reference/addons/update-addon-images">
      Scopri come gestire le immagini degli add-on tramite API.
    </Card>
  </Accordion>
</AccordionGroup>

## Casi d'uso comuni

* **Fatturazione basata sui posti**: membri del team aggiuntivi, licenze utente o utenti concorrenti
* **Aggiornamenti delle funzionalità**: funzionalità premium, analisi avanzate o supporto prioritario
* **Estensioni d'uso**: spazio di archiviazione extra, chiamate API o quote di larghezza di banda
* **Add-on di servizio**: servizi professionali, formazione o ore di consulenza

## Esempi di integrazione

### Sessioni di checkout con add-on

Quando crei sessioni di checkout puoi includere add-on con quantità personalizzate:

```typescript theme={null}
const session = await client.checkoutSessions.create({
  product_cart: [
    {
      product_id: 'your_subscription_id',
      quantity: 1,
      addons: [
        {
          addon_id: 'your_addon_id',
          quantity: 3 // 3 additional seats
        }
      ]
    }
  ],
  // ... other checkout options
});
```

<Tip>
  Per consentire ai clienti di aggiungere o rimuovere add-on da soli nella pagina di pagamento, imposta il flag della funzionalità [`allow_editing_addons`](/developer-resources/checkout-session#optional-fields) su `true` quando crei la sessione. Per impostazione predefinita è `false` e si applica solo ai prodotti in abbonamento.

  ```typescript theme={null}
  const session = await client.checkoutSessions.create({
    product_cart: [{ product_id: 'your_subscription_id', quantity: 1 }],
    feature_flags: {
      allow_editing_addons: true // customers can edit add-ons at checkout
    },
  });
  ```
</Tip>

### Modifiche al Piano con Add-on

Modifica gli abbonamenti esistenti per aggiungere, rimuovere o aggiornare gli add-on:

```typescript theme={null}
// Add add-ons to existing subscription
await client.subscriptions.changePlan('sub_123', {
  product_id: 'prod_new',
  quantity: 1,
  proration_billing_mode: 'difference_immediately',
  addons: [
    { addon_id: 'addon_123', quantity: 2 }
  ]
});

// Remove all existing add-ons
await client.subscriptions.changePlan('sub_123', {
  product_id: 'prod_new',
  quantity: 1,
  proration_billing_mode: 'difference_immediately',
  addons: [] // Empty array removes all existing add-ons
});
```

### Prezzi Dinamici

Calcola i costi totali dinamicamente in base alle selezioni degli add-on:

```typescript theme={null}
function calculateTotalCost(basePrice: number, addons: AddonSelection[]) {
  const addonTotal = addons.reduce((sum, addon) => 
    sum + (addon.price * addon.quantity), 0
  );
  return basePrice + addonTotal;
}
```

## Migliori Pratiche

* **Inizia in modo semplice**: Lancia con 2-3 add-on principali e amplia le opzioni in base al feedback dei clienti e all'uso.
* **Mantieni la chiarezza dei prezzi**: Comunica chiaramente il prezzo e il valore degli add-on, affinché i clienti comprendano cosa ottengono per il costo aggiuntivo.
* **Testa accuratamente**: Convalida le combinazioni di add-on per garantire che i calcoli dei prezzi rimangano accurati e i flussi di pagamento funzionino senza problemi.

### Considerazioni di Design

* **Valore Proporzionale Chiaro**: Ogni add-on dovrebbe avere un beneficio chiaro che i clienti possano comprendere facilmente
* **Raggruppamento Logico**: Raggruppa gli add-on correlati nel tuo flusso di pagamento
* **Quantità Flessibili**: Consenti ai clienti di regolare le quantità degli add-on secondo necessità
* **Prezzi Trasparenti**: Mostra chiaramente i costi totali durante tutto il processo di pagamento

<Info>
  Gli add-on sono un modo potente per creare modelli di prezzo flessibili e scalabili che crescono con i tuoi clienti. Inizia con casi d'uso semplici e amplia man mano che scopri cosa funziona meglio per la tua attività e per i tuoi clienti.
</Info>
