Componenti aggiuntivi per abbonamenti

​

Cosa sono i componenti aggiuntivi?

​

Vantaggi principali

​

Creazione dei componenti aggiuntivi

​

Configurazione dei componenti aggiuntivi

• Prezzo: imposta l’importo del componente aggiuntivo (price) nell’unità monetaria più piccola. Il componente aggiuntivo viene fatturato in base al ciclo dell’abbonamento principale
• Valuta: imposta il prezzo base in qualsiasi valuta che Dodo Payments può addebitare. Il selettore di valute ricercabile fissa USD, GBP, EUR e INR in cima; i clienti al di fuori della valuta di base vengono fatturati tramite Adaptive Currency
• Quantità: i clienti scelgono una quantità quando il componente aggiuntivo viene associato a un abbonamento
• Disponibilità: associa il componente aggiuntivo ai prodotti in abbonamento tramite l’elenco addons di ciascun prodotto. Il componente aggiuntivo non dispone di una propria impostazione di disponibilità
• Impostazioni fiscali: configura l’tax_category appropriato

​

Per iniziare

​

Casi d’uso comuni

• Fatturazione basata sui posti: membri aggiuntivi del team, licenze utente o utenti simultanei
• Upgrade delle funzionalità: funzionalità premium, analisi avanzate o supporto prioritario
• Estensioni dell’utilizzo: spazio di archiviazione aggiuntivo, chiamate API o quote di larghezza di banda
• Servizi aggiuntivi: servizi professionali, formazione o ore di consulenza

​

Esempi di integrazione

​

Sessioni di checkout con componenti aggiuntivi

const session = await client.checkoutSessions.create({
  product_cart: [
    {
      product_id: 'pdt_123',
      quantity: 1,
      addons: [
        {
          addon_id: 'addon_456',
          quantity: 3 // 3 additional seats
        }
      ]
    }
  ],
  customer: { email: 'customer@example.com' },
  return_url: 'https://yourapp.com/success'
});

session = client.checkout_sessions.create(
    product_cart=[
        {
            "product_id": "pdt_123",
            "quantity": 1,
            "addons": [
                {
                    "addon_id": "addon_456",
                    "quantity": 3  # 3 additional seats
                }
            ]
        }
    ],
    customer={"email": "customer@example.com"},
    return_url="https://yourapp.com/success"
)

curl -X POST https://test.dodopayments.com/checkouts \
  -H "Authorization: Bearer $DODO_PAYMENTS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "product_cart": [
      {
        "product_id": "pdt_123",
        "quantity": 1,
        "addons": [
          {
            "addon_id": "addon_456",
            "quantity": 3
          }
        ]
      }
    ],
    "customer": {"email": "customer@example.com"},
    "return_url": "https://yourapp.com/success"
  }'

const session = await client.checkoutSessions.create({
  product_cart: [{ product_id: 'pdt_123', quantity: 1 }],
  feature_flags: {
    allow_editing_addons: true // customers can edit add-ons at checkout
  },
});

​

Modifiche al piano con componenti aggiuntivi

// Add add-ons to existing subscription
await client.subscriptions.changePlan('sub_123', {
  product_id: 'pdt_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: 'pdt_new',
  quantity: 1,
  proration_billing_mode: 'difference_immediately',
  addons: [] // Empty array removes all existing add-ons
});

# Add add-ons to existing subscription
client.subscriptions.change_plan(
    'sub_123',
    product_id='pdt_new',
    quantity=1,
    proration_billing_mode='difference_immediately',
    addons=[
        {'addon_id': 'addon_123', 'quantity': 2}
    ]
)

# Remove all existing add-ons
client.subscriptions.change_plan(
    'sub_123',
    product_id='pdt_new',
    quantity=1,
    proration_billing_mode='difference_immediately',
    addons=[]
)

​

Prezzi dinamici

interface AddonSelection {
  price: number;
  quantity: number;
}

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

​

Gestione tramite API

​

Best practice

• Inizia in modo semplice: lancia 2-3 componenti aggiuntivi principali ed espandi le opzioni in base al feedback e all’utilizzo dei clienti.
• Mantieni chiarezza nei prezzi: comunica chiaramente il prezzo e il valore dei componenti aggiuntivi, affinché i clienti capiscano cosa ricevono in cambio del costo aggiuntivo.
• Testa accuratamente: verifica le combinazioni di componenti aggiuntivi per assicurarti che i calcoli dei prezzi rimangano accurati e che i flussi di checkout funzionino senza problemi.

​

Considerazioni di progettazione

• Proposta di valore chiara: ogni componente aggiuntivo dovrebbe offrire un vantaggio chiaro e comprensibile ai clienti
• Raggruppamento logico: raggruppa i componenti aggiuntivi correlati nel flusso di checkout
• Quantità flessibili: consenti ai clienti di modificare le quantità dei componenti aggiuntivi secondo necessità
• Prezzi trasparenti: mostra chiaramente i costi totali durante tutto il processo di checkout

​

Contenuti correlati