Modelli di fatturazione ibrida - Dodo Payments Documentation

La fatturazione ibrida combina due o più modelli di fatturazione in un’unica strategia di prezzo. Questo consente di acquisire valore da diverse dimensioni—commissioni ricorrenti, utilizzo, posti e funzionalità—offrendo al contempo ai clienti flessibilità e prevedibilità.

Usage-Based Billing

Base per la determinazione dei prezzi basata sul consumo.

Subscriptions

Base per la fatturazione ricorrente.

Add-ons

Estendi gli abbonamenti con upgrade opzionali.

Seat-Based Billing

Modelli di prezzo per utente.

Che cos’è la fatturazione ibrida?

La fatturazione ibrida combina più dimensioni di prezzo in un’unica offerta di prodotto. Invece di scegliere tra abbonamenti a tariffa fissa O prezzi basati sull’utilizzo, utilizzi entrambi insieme.

Perché usare la fatturazione ibrida?

Obiettivo aziendale	Soluzione ibrida
Ricavi prevedibili + potenziale di crescita	Abbonamento base + eccedenza di utilizzo
Prezzi per team scalabili	Per posto + componenti aggiuntivi
Acquisire clienti ed espandere in seguito	Commissione base ridotta + addebiti in base al consumo
Flessibilità aziendale	Spesa impegnata + addebiti on-demand
Prezzi equi per utilizzo variabile	Quantità inclusa + pagamento a consumo

Modelli ibridi comuni

Modello	Descrizione	Esempio	Supporto nativo
1. Abbonamento + utilizzo	Commissione base + addebiti in base al consumo	$49/mese + $0.01/chiamata API dopo 10.000 gratuite	✅ Completo
2. Abbonamento + posti	Commissione della piattaforma + addebiti per utente	$99/mese + $15/posto	✅ Completo
3. Abbonamento + componenti aggiuntivi	Piano principale + upgrade opzionali	$29/mese + $19/mese per analisi + $9/mese per accesso API	✅ Completo
4. Posti + utilizzo	Commissione per utente + eccedenza di consumo	$10/utente/mese + $0.05/GB dopo 5 GB/utente	⚠️ Soluzione alternativa
5. Abbonamento + posti + utilizzo	Piattaforma + utenti + consumo (ibrido triplo)	$199/mese + $20/posto + eccedenza di utilizzo	⚠️ Soluzione alternativa
6. Base a livelli + eccedenza di utilizzo	Livelli diversi con quantità incluse diverse	Starter (5.000 chiamate) vs Pro (50.000 chiamate) + eccedenza	✅ Completo
7. Abbonamento + addebiti on-demand	Commissione ricorrente + addebiti manuali variabili	Retainer da $99/mese + fatturazione oraria per il lavoro	✅ Completo

Modello ibrido 1: abbonamento + utilizzo

Il modello ibrido più comune. I clienti pagano una commissione di abbonamento base più gli addebiti per il consumo che supera le quantità incluse.

Come funziona

Piano Pro: $49/mese

Incluso: 10.000 chiamate API/mese
Eccedenza: $0.005 per chiamata dopo 10.000

Calcolo di esempio (il cliente utilizza 25.000 chiamate questo mese):

Abbonamento base: $49.00
Eccedenza: (25.000 - 10.000) × $0.005 =$ 75.00
Totale: $124.00

Casi d’uso

Piattaforme API: accesso base + addebiti per richiesta
Servizi AI/ML: abbonamento + utilizzo di token/generazioni
Servizi di archiviazione: piano base + eccedenza per GB
Piattaforme di comunicazione: base + addebiti per messaggio/minuto

Implementazione

Create Usage Meter

Configura un meter per monitorare la dimensione di utilizzo fatturabile.

Dashboard: Meters → Create Meter
Event Name: "api.call"
Aggregation: Count
This tracks API calls per customer

Create Subscription Product with Usage Pricing

Crea un prodotto in abbonamento e collega il meter di utilizzo con i prezzi.

Dashboard: Create Product → Subscription
Name: "Pro Plan"
Base Price: $49/month

Then attach usage pricing:
- Meter: api.call
- Price per unit: $0.005
- Free threshold: 10,000 (included in subscription)

Il meter di utilizzo viene collegato direttamente al prodotto in abbonamento. Gli addebiti per l’utilizzo vengono calcolati e aggiunti automaticamente alla fattura dell’abbonamento.

Create Checkout Session

Crea una sessione di checkout con il tuo prodotto in abbonamento.

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

Send Usage Events

Monitora l’utilizzo durante il periodo di fatturazione.

await fetch('https://test.dodopayments.com/events/ingest', {
  method: 'POST',
  headers: {
    'Authorization': `Bearer ${apiKey}`,
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    events: [{
      event_id: `call_${Date.now()}`,
      customer_id: 'cus_123',
      event_name: 'api.call',
      timestamp: new Date().toISOString(),
      metadata: { endpoint: '/v1/generate' }
    }]
  })
});

Varianti di prezzo

Included Allowance
Zero Base + Pure Usage
Tiered Allowances

La soglia gratuita copre l’utilizzo incluso nell’abbonamento base.Piano Pro: $49/mese

Include: 10.000 chiamate API
Eccedenza: $0.005/chiamata dopo 10.000
Il cliente utilizza 8.000 → paga $49 (nessuna eccedenza)

Modello ibrido 2: abbonamento + posti

Commissione della piattaforma più addebiti per utente. Ideale per strumenti di collaborazione tra team e SaaS B2B.

Come funziona

Piano Team: $99/mese +$ 15/posto

Commissione base della piattaforma: $99/mese (include 3 posti)
Posti aggiuntivi: $15/posto/mese

Calcolo di esempio (team di 12 utenti):

Commissione della piattaforma: $99.00
Posti aggiuntivi: (12 - 3) × $15 =$ 135.00
Totale: $234.00/mese

Casi d’uso

Strumenti di collaborazione: commissione del workspace + quota per membro
Sistemi CRM: licenza della piattaforma + quota per commerciale
Gestione dei progetti: piano team + quota per collaboratore
Strumenti per sviluppatori: commissione dell’organizzazione + quota per sviluppatore

Implementazione

Create Seat Add-on

Crea un componente aggiuntivo per i posti aggiuntivi.

Dashboard: Products → Add-ons → Create Add-on
Name: "Additional Seat"
Price: $15/month
Description: "Add another team member"

Create Base Subscription

Crea il prodotto in abbonamento con la commissione della piattaforma e collega il componente aggiuntivo.

Dashboard: Create Product → Subscription
Name: "Team Plan"
Price: $99/month
Description: "Includes 3 team members"

Then in Add-ons section:
- Attach: "Additional Seat" add-on

Create Checkout with Seats

Specifica la quantità di posti durante il checkout.

const session = await client.checkoutSessions.create({
  product_cart: [{
    product_id: 'prod_team_plan',
    quantity: 1,
    addons: [{
      addon_id: 'addon_seat',
      quantity: 9  // 9 extra seats (12 total with 3 included)
    }]
  }],
  customer: { email: 'admin@company.com' },
  return_url: 'https://yourapp.com/success'
});

Adjust Seats as Needed

Aggiungi o rimuovi posti dagli abbonamenti esistenti.

// Add 5 more seats
await client.subscriptions.changePlan('sub_123', {
  product_id: 'prod_team_plan',
  quantity: 1,
  proration_billing_mode: 'prorated_immediately',
  addons: [{
    addon_id: 'addon_seat',
    quantity: 14  // New total: 14 extra seats
  }]
});

Varianti di prezzo

Included Seats
Pure Per-Seat
Tiered Per-Seat

Il piano base include alcuni posti; gli extra vengono addebitati.Piano Team: $99/mese

Include: 5 posti
Posti aggiuntivi: $15/posto/mese
20 utenti = $99 + (15 × $15) = $324/mese

Modello ibrido 3: abbonamento + componenti aggiuntivi per funzionalità

Abbonamento principale con upgrade opzionali che i clienti possono aggiungere.

Come funziona

Piano principale: $29/mese Componenti aggiuntivi opzionali:

Analisi avanzate: +$19/mese
Accesso API: +$9/mese
Supporto prioritario: +$29/mese
White-label: +$49/mese

Calcolo di esempio (il cliente sceglie Piano principale + Analisi + Accesso API):

Piano principale: $29.00
Analisi: $19.00
Accesso API: $9.00
Totale: $57.00/mese

Casi d’uso

Piattaforme SaaS: funzionalità principali + moduli premium
Strumenti di marketing: strumento base + integrazioni
Prodotti di analisi: dashboard + report avanzati
Software di sicurezza: protezione di base + funzionalità avanzate

Implementazione

Create Feature Add-ons

Crea un componente aggiuntivo per ogni funzionalità opzionale.

# Add-on 1: Advanced Analytics
Dashboard: Products → Add-ons → Create Add-on
Name: "Advanced Analytics"
Price: $19/month

# Add-on 2: API Access
Name: "API Access"
Price: $9/month

# Add-on 3: Priority Support
Name: "Priority Support"
Price: $29/month

# Add-on 4: White-label
Name: "White-label"
Price: $49/month

Create Core Subscription

Definisci l’abbonamento base e collega tutti i componenti aggiuntivi per le funzionalità.

Dashboard: Create Product → Subscription
Name: "Core Plan"
Price: $29/month

Then in Add-ons section:
- Attach all feature add-ons

Let Customers Choose

Esegui il checkout con le funzionalità selezionate.

const session = await client.checkoutSessions.create({
  product_cart: [{
    product_id: 'prod_core_plan',
    quantity: 1,
    addons: [
      { addon_id: 'addon_analytics', quantity: 1 },
      { addon_id: 'addon_api_access', quantity: 1 }
      // Customer didn't select support or white-label
    ]
  }],
  return_url: 'https://yourapp.com/success'
});

Add Features Later

I clienti possono aggiungere funzionalità agli abbonamenti esistenti.

// Customer wants to add Priority Support
await client.subscriptions.changePlan('sub_123', {
  product_id: 'prod_core_plan',
  quantity: 1,
  proration_billing_mode: 'prorated_immediately',
  addons: [
    { addon_id: 'addon_analytics', quantity: 1 },
    { addon_id: 'addon_api_access', quantity: 1 },
    { addon_id: 'addon_priority_support', quantity: 1 }  // New!
  ]
});

Modello ibrido 4: posti + utilizzo

Commissione per utente combinata con addebiti basati sul consumo. Ogni utente riceve una quantità inclusa.

Limitazione: Dodo Payments attualmente non supporta il collegamento di meter di utilizzo e componenti aggiuntivi allo stesso prodotto in abbonamento. Questo modello richiede una soluzione alternativa che utilizzi la logica a livello di applicazione.

Come funziona

Analytics del team: 20 $/utente/mese Ogni utente include:

5 GB di elaborazione dati/mese
Eccedenza: 2 $/GB dopo la quota inclusa

Esempio di calcolo (team di 10 utenti che utilizza 80 GB in totale):

Costi delle licenze: 10 × 20 $= 200,00$
Dati inclusi: 10 × 5 GB = 50 GB
Eccedenza: (80 - 50) × 2 $= 60,00$
Totale: 260,00 $/mese

Casi d’uso

Piattaforme di analytics: per analista + elaborazione dati
Strumenti di progettazione: per designer + archiviazione/esportazioni
Ambienti di sviluppo: per sviluppatore + ore di calcolo
Strumenti di comunicazione: per utente + volume di messaggi/chiamate

Opzioni di implementazione

Poiché non puoi associare sia i contatori di utilizzo sia gli add-on alla stessa subscription, scegli uno dei seguenti approcci:

Option A: Usage Product + App-Managed Seats
Option B: Seat Add-on + On-Demand Usage Charges

Usa una subscription basata sull’utilizzo e gestisci la fatturazione delle licenze nella tua applicazione.

Create Usage Meter

Dashboard: Meters → Create Meter
Event Name: "data.processed"
Aggregation: Sum
Property: "bytes"

Create Usage-Based Subscription

Dashboard: Create Product → Subscription
Name: "Team Analytics"
Base Price: $0/month

Attach usage pricing:
- Meter: data.processed
- Price per unit: $2/GB
- Free threshold: 0 (managed by your app)

Manage Seats in Your Application

Tieni traccia del numero di licenze e calcola separatamente i relativi costi.

// Your application tracks seats and calculates total cost
async function calculateMonthlyBill(customerId: string) {
  const seatCount = await getSeatCount(customerId);
  const seatFee = seatCount * 20; // $20/seat

  // Usage is billed by Dodo automatically
  // You invoice/charge seat fees separately or include in base price

  // Alternatively, adjust base subscription price when seats change
  const totalBasePrice = seatCount * 2000; // $20/seat in cents
  await client.subscriptions.update('sub_123', {
    // Update subscription to reflect seat-based pricing
  });
}

Calculate Dynamic Free Threshold

Modifica l’utilizzo incluso in base al numero di licenze.

// When checking usage, apply per-seat allowance
async function checkUsageOverage(customerId: string) {
  const seatCount = await getSeatCount(customerId);
  const includedGB = seatCount * 5; // 5 GB per user

  const currentUsage = await getUsageFromDodo(customerId);
  const overage = Math.max(0, currentUsage - includedGB);

  // Overage is billed by Dodo at $2/GB
  return { included: includedGB, used: currentUsage, overage };
}

Usa gli add-on per le licenze e addebita manualmente l’utilizzo tramite on-demand charges.

Create Seat Add-on

Dashboard: Products → Add-ons → Create Add-on
Name: "Team Member"
Price: $20/month

Create Subscription with Add-on

Dashboard: Create Product → Subscription
Name: "Team Analytics"
Base Price: $0/month

Attach add-on:
- "Team Member" add-on

Enable on-demand charging

Track Usage in Your Application

// Track usage events in your system
async function trackDataProcessed(customerId: string, bytes: number) {
  await saveUsageEvent({
    customer_id: customerId,
    event_type: 'data.processed',
    bytes: bytes,
    timestamp: new Date()
  });
}

Charge Usage at End of Cycle

Calcola e addebita manualmente le eccedenze di utilizzo.

async function billUsageOverage(subscriptionId: string) {
  const subscription = await getSubscription(subscriptionId);
  const seatCount = subscription.addons.find(a => a.id === 'addon_seat')?.quantity || 0;

  const includedGB = seatCount * 5;
  const usedGB = await calculatePeriodUsage(subscription.customer_id);
  const overageGB = Math.max(0, usedGB - includedGB);

  if (overageGB > 0) {
    const overageCharge = overageGB * 200; // $2/GB in cents
    await client.subscriptions.charge(subscriptionId, {
      product_price: overageCharge,
      product_description: `Data overage: ${overageGB} GB × $2/GB`
    });
  }
}

Raccomandazione: l’opzione B (add-on per licenze + utilizzo on-demand) è spesso più semplice da implementare perché Dodo gestisce automaticamente la fatturazione delle licenze. Devi solo tenere traccia delle eccedenze di utilizzo e addebitarle.

Modello ibrido 5: Subscription + licenze + utilizzo (ibrido triplo)

Il modello più completo: tariffa della piattaforma + costo per utente + consumo.

Limitazione: Dodo Payments attualmente non supporta l’associazione sia dei contatori di utilizzo sia degli add-on allo stesso prodotto subscription. Questo modello richiede un approccio alternativo.

Come funziona

Piattaforma Enterprise

Tariffa della piattaforma: 199 $/mese
Per licenza: 25 $/utente/mese
Utilizzo: 0,10 $/1.000 chiamate API (50.000 incluse)

Esempio di calcolo (azienda con 20 utenti e 150.000 chiamate API):

Piattaforma: 199,00 $
Licenze: 20 × 25 $= 500,00$
Utilizzo: (150K - 50K) × $0.10/1K = $10.00
Totale: 709,00 $/mese

Casi d’uso

SaaS Enterprise: piattaforma + team + consumo
Piattaforme dati: workspace + analisti + query
Piattaforme di integrazione: hub + connettori + transazioni
Piattaforme AI: workspace + sviluppatori + inferenza

Opzioni di implementazione

Scegli uno dei seguenti approcci per implementare la fatturazione ibrida tripla:

Option A: Base + Seats (Add-on) + On-Demand Usage
Option B: Base + Usage (Meter) + App-Managed Seats

Usa una subscription con add-on per licenze e addebita manualmente l’utilizzo tramite on-demand charges.Questo è l’approccio consigliato perché Dodo gestisce automaticamente la tariffa della piattaforma e la fatturazione delle licenze.

Create Seat Add-on

Dashboard: Products → Add-ons → Create Add-on
Name: "User Seat"
Price: $25/month

Create Subscription Product

Dashboard: Create Product → Subscription
Name: "Enterprise Platform"
Base Price: $199/month

Attach add-on:
- "User Seat" add-on

Enable on-demand charging

Create Checkout with Seats

const session = await client.checkoutSessions.create({
  product_cart: [{
    product_id: 'prod_enterprise_platform',
    quantity: 1,
    addons: [{
      addon_id: 'addon_user_seat',
      quantity: 20  // 20 users
    }]
  }],
  customer: { email: 'enterprise@company.com' },
  return_url: 'https://yourapp.com/success'
});

Track Usage in Your Application

Memorizza gli eventi di utilizzo nel tuo sistema.

// Track API calls in your system
async function trackApiCall(customerId: string, endpoint: string) {
  await saveUsageEvent({
    customer_id: customerId,
    event_type: 'api.call',
    endpoint: endpoint,
    timestamp: new Date()
  });
}

Charge Usage at End of Cycle

Calcola e addebita le eccedenze di utilizzo tramite on-demand charge.

async function billUsageOverage(subscriptionId: string) {
  const usage = await calculatePeriodUsage(subscriptionId);
  const includedCalls = 50000;
  const overageCalls = Math.max(0, usage.totalCalls - includedCalls);

  if (overageCalls > 0) {
    // $0.10 per 1000 calls = $0.0001 per call
    const overageCharge = Math.ceil(overageCalls / 1000) * 10; // cents
    await client.subscriptions.charge(subscriptionId, {
      product_price: overageCharge,
      product_description: `API usage: ${overageCalls.toLocaleString()} calls over 50K included`
    });
  }
}

Usa una subscription con un contatore di utilizzo e gestisci la fatturazione delle licenze nella tua applicazione.

Create Usage Meter

Dashboard: Meters → Create Meter
Event Name: "api.call"
Aggregation: Count

Create Subscription Product with Usage

Dashboard: Create Product → Subscription
Name: "Enterprise Platform"
Base Price: $199/month

Attach usage pricing:
- Meter: api.call
- Price: $0.10 per 1000 calls
- Free threshold: 50,000

Manage Seats in Your Application

Tieni traccia del numero di licenze e modifica di conseguenza il prezzo della subscription di base.

// When seats change, update subscription price
async function updateSeatCount(subscriptionId: string, newSeatCount: number) {
  const basePlatformFee = 19900; // $199 in cents
  const perSeatFee = 2500; // $25 in cents
  const totalPrice = basePlatformFee + (newSeatCount * perSeatFee);

  // Store seat count in your system
  await updateSeatsInDatabase(subscriptionId, newSeatCount);

  // Note: You may need to handle this via plan changes or
  // create multiple tier products for common seat counts
}

Send Usage Events to Dodo

await fetch('https://test.dodopayments.com/events/ingest', {
  method: 'POST',
  headers: {
    'Authorization': `Bearer ${apiKey}`,
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    events: [{
      event_id: `api_${Date.now()}`,
      customer_id: 'cus_enterprise',
      event_name: 'api.call',
      timestamp: new Date().toISOString()
    }]
  })
});

Raccomandazione: l’opzione A (base + licenze + utilizzo on-demand) è generalmente più semplice perché Dodo gestisce automaticamente la fatturazione della piattaforma e delle licenze. Devi solo tenere traccia dell’utilizzo e inviare gli addebiti al termine di ogni ciclo di fatturazione.

Modello ibrido 6: base a livelli + eccedenza di utilizzo

Diversi livelli di subscription con quote incluse e tariffe per le eccedenze differenti.

Come funziona

Livello	Prezzo	Chiamate incluse	Tariffa eccedenza
Starter	19 $/mese	1.000	0,02 $/chiamata
Pro	79 $/mese	25.000	0,01 $/chiamata
Business	199 $/mese	100.000	0,005 $/chiamata
Enterprise	499 $/mese	500.000	0,002 $/chiamata

Implementazione

Crea prodotti subscription separati per ogni livello, ciascuno con la propria configurazione di utilizzo:

# For each tier, create a subscription product:

# Starter Tier
Dashboard: Create Product → Subscription
Name: "Starter"
Base Price: $19/month
Usage Pricing:
- Meter: api.call
- Price: $0.02/call
- Free threshold: 1,000

# Pro Tier
Name: "Pro"
Base Price: $79/month
Usage Pricing:
- Meter: api.call
- Price: $0.01/call
- Free threshold: 25,000

# ... and so on for Business and Enterprise

Percorso di upgrade

Quando i clienti passano a un livello superiore, ottengono:

Una quota inclusa maggiore
Tariffe per le eccedenze inferiori
Più valore per ogni euro

// Customer upgrades from Starter to Pro
await client.subscriptions.changePlan('sub_123', {
  product_id: 'prod_pro',
  quantity: 1,
  proration_billing_mode: 'prorated_immediately'
});

Modello ibrido 7: Subscription + on-demand charges

Subscription ricorrente più addebiti manuali variabili per servizi o eccedenze.

Come funziona

Piano a forfait: 199 $/mese Include:

Accesso alla piattaforma
5 ore di consulenza/mese
Supporto via email

Addebiti on-demand (secondo necessità):

Consulenza aggiuntiva: 150 $/ora
Sviluppo personalizzato: 200 $/ora
Supporto di emergenza: 100 $/incidente

Esempio di calcolo (questo mese):

Forfait: 199,00 $
3 ore di consulenza aggiuntiva: 450,00 $
1 intervento di supporto di emergenza: 100,00 $
Totale: 749,00 $

Casi d’uso

Servizi di consulenza: forfait + fatturazione oraria
Servizi gestiti: tariffa base + addebiti per incidente
Servizi di agenzia: tariffa mensile + addebiti per progetto
Piani di supporto: tariffa SLA + costo per ticket o per ora

Implementazione

Create On-Demand Subscription

Configura una subscription con gli addebiti on-demand abilitati.

const subscription = await client.subscriptions.create({
  billing: {
    city: 'San Francisco',
    country: 'US',
    state: 'CA',
    street: '123 Main St',
    zipcode: '94105'
  },
  customer: { customer_id: 'cus_123' },
  product_id: 'prod_retainer',
  quantity: 1,
  payment_link: true,
  return_url: 'https://yourapp.com/success',
  on_demand: {
    mandate_only: false,
    product_price: 19900  // $199 initial charge
  }
});

Charge for Services

Crea gli addebiti quando i servizi vengono erogati.

// Charge for 3 hours of consulting
await client.subscriptions.charge('sub_123', {
  product_price: 45000,  // $450.00 (3 × $150)
  product_description: 'Consulting - 3 hours (March 15)'
});

// Charge for emergency support incident
await client.subscriptions.charge('sub_123', {
  product_price: 10000,  // $100.00
  product_description: 'Emergency support - Server outage (March 18)'
});

Track and Invoice

Tutti gli addebiti vengono visualizzati nella fattura del cliente.

// Retrieve subscription charges
const payments = await client.payments.list({
  subscription_id: 'sub_123'
});

// Show itemized breakdown to customer
payments.items.forEach(payment => {
  console.log(`${payment.payment_id}: $${payment.total_amount / 100}`);
});

Esempi reali

Questi esempi mostrano strutture di prezzo ideali. A causa della limitazione per cui i contatori di utilizzo e gli add-on non possono essere associati allo stesso prodotto, alcune combinazioni richiedono soluzioni alternative (utilizzando addebiti on-demand per l’utilizzo o gestendo le licenze nell’applicazione).

Esempio 1: piattaforma SaaS AI

Struttura dei prezzi:

Subscription di base: 99 $/mese (accesso alla piattaforma, 5 licenze incluse)
Add-on per licenze: 20 $/licenza/mese
Add-on per funzionalità: modelli personalizzati ($49/mese), accesso API ($29/mese), coda prioritaria ($19/mese)
Eccedenza di utilizzo: 0,02 $ per 1.000 token dopo 100K (addebitata tramite on-demand)

Implementazione: usa una subscription con add-on per licenze e funzionalità. Tieni traccia dell’utilizzo dei token nella tua applicazione e addebita le eccedenze tramite addebiti on-demand al termine del ciclo di fatturazione. Esempio di cliente (12 utenti, 500K token, modelli personalizzati + accesso API):

Componente	Calcolo	Importo
Base	Tariffa della piattaforma	99 $
Licenze aggiuntive	7 × 20 $	140 $
Modelli personalizzati	Add-on	49 $
Accesso API	Add-on	29 $
Eccedenza token	400K × $0.02/1K (on-demand)	$8
Totale		325 $/mese

Esempio 2: piattaforma di strumenti per sviluppatori

Opzioni di livello:

	Free	Pro	Enterprise
Prezzo	0 $/mese	29 $/mese	199 $/mese
Utenti	1	5 inclusi	Illimitati
Build	100	1.000	10.000
Archiviazione	1 GB	10 GB	100 GB

Opzioni di implementazione: Opzione A (incentrata sull’utilizzo): crea prodotti con contatori di utilizzo per build/archiviazione. Gestisci gli utenti nella tua applicazione. Opzione B (incentrata sulle licenze): crea prodotti con add-on per licenze. Tieni traccia dell’utilizzo di build/archiviazione e addebita le eccedenze tramite on-demand. Add-on (se utilizzi l’opzione B):

Utenti aggiuntivi: 10 $/utente/mese
Build prioritarie: 19 $/mese
Domini personalizzati: 9 $/dominio/mese

Esempio 3: automazione del marketing

Struttura dei prezzi:

Base: 79 $/mese (funzionalità principali di automazione, 3 licenze incluse)
Livelli di contatti (add-on): 1K inclusi, 5K (+$30), 25K (+$80), 100K (+$200)
Add-on per funzionalità: marketing SMS ($29/mese), landing page ($19/mese), test A/B ($29/mese)
Licenze del team: add-on da 15 $/utente/mese
Volume email: monitorato nell’applicazione, con eccedenza addebitata tramite on-demand (1 $/1.000 email oltre il limite)

Implementazione: usa una subscription con add-on per livelli di contatti, funzionalità e licenze. Tieni traccia delle email inviate nella tua applicazione e addebita le eccedenze tramite addebiti on-demand.

Best practice di implementazione

Chiarezza della pagina dei prezzi

Rendi i prezzi ibridi facili da comprendere. Mostra in modo evidente nella pagina dei prezzi i costi di base, cosa è incluso e come funzionano le eccedenze.

Corretto: “$49/mese include 10.000 chiamate API. Chiamate aggiuntive: $0.005 ciascuna” Errato: “$49/mese + costi di utilizzo”

Prevedibilità dei costi

Aiuta i clienti a stimare i propri costi:

// Provide a cost calculator
function estimateMonthlyCost({
  plan,
  seats,
  expectedUsage,
  addons
}: EstimateParams): number {
  let total = plan.basePrice;

  // Add seat costs
  const extraSeats = Math.max(0, seats - plan.includedSeats);
  total += extraSeats * plan.seatPrice;

  // Add usage overage
  const overage = Math.max(0, expectedUsage - plan.includedUsage);
  total += overage * plan.overageRate;

  // Add feature add-ons
  total += addons.reduce((sum, addon) => sum + addon.price, 0);

  return total;
}

Visibilità sull’utilizzo

Mostra ai clienti il loro utilizzo in tempo reale:

// Display usage dashboard
async function getUsageSummary(subscriptionId: string) {
  const usage = await client.subscriptions.retrieveUsageHistory(subscriptionId);

  // Each item is a billing period; each meter reports its usage for that period.
  const latestPeriod = usage.items[0];

  return latestPeriod.meters.map((meter) => {
    const consumed = Number(meter.consumed_units);
    const chargeable = Number(meter.chargeable_units);
    return {
      meter: meter.name,
      current: consumed,
      included: meter.free_threshold,
      remaining: Math.max(0, meter.free_threshold - consumed),
      overage: chargeable,
      cost: meter.total_price
    };
  });
}

Trasparenza della fatturazione

Fornisci fatture dettagliate che mostrino tutti i componenti:

Voce	Importo
Piano Pro (mensile)	49,00 $
Licenze aggiuntive (7 × 15,00 $)	105,00 $
Utilizzo API - Incluso (10.000 chiamate)	0,00 $
Utilizzo API - Eccedenza (15.420 chiamate × 0,005 $)	77,10 $
Add-on Analytics avanzati	19,00 $
Subtotale	250,10 $
Imposta (8,5%)	21,26 $
Totale dovuto	271,36 $

Risoluzione dei problemi della fatturazione ibrida

Usage not being tracked correctly

Sintomi: l’utilizzo mostra valori pari a 0 o non corretti.Soluzioni:

Verifica che l’acquisizione degli eventi funzioni (controlla le risposte API)
Conferma che customer_id corrisponda al cliente della subscription
Verifica che event_name corrisponda alla configurazione del contatore
Verifica che gli eventi abbiano timestamp corretti (non datati nel futuro)

Proration confusion with multiple components

Sintomi: al cliente vengono addebitati importi imprevisti quando cambia piano.Soluzioni:

Usa l’API previewChangePlan per mostrare gli addebiti esatti prima della conferma
Comunica che il pro rata si applica alla subscription E agli add-on
Valuta l’utilizzo di difference_immediately per semplificare la fatturazione degli upgrade

Free threshold not applying correctly

Sintomi: al cliente viene addebitato un utilizzo che dovrebbe essere gratuito.Soluzioni:

Verifica che la soglia gratuita sia configurata nel prodotto basato sull’utilizzo
Controlla che l’unità della soglia corrisponda all’aggregazione degli eventi (chiamate vs. richieste)
Conferma che il contatore di utilizzo sia associato correttamente al prodotto subscription

Add-ons not appearing in checkout

Sintomi: non è possibile aggiungere licenze o funzionalità durante il checkout.Soluzioni:

Verifica che gli add-on siano associati al prodotto subscription nella dashboard
Controlla che gli ID degli add-on siano corretti nelle chiamate API
Assicurati che la valuta dell’add-on corrisponda a quella del prodotto subscription

Documentazione correlata

Products

Panoramica di tutti i tipi di prodotto e delle guide.

Usage-Based Billing Guide

Implementazione completa della fatturazione basata sull’utilizzo.

Subscription Management

Gestione delle subscription ricorrenti.

Add-ons

Estensione delle subscription con add-on.

Ultima modifica il 6 agosto 2026

Usage-Based Billing

Subscriptions

Add-ons

Seat-Based Billing

​Che cos’è la fatturazione ibrida?

​Perché usare la fatturazione ibrida?

​Modelli ibridi comuni

​Modello ibrido 1: abbonamento + utilizzo

​Come funziona

​Casi d’uso

​Implementazione

​Varianti di prezzo

​Modello ibrido 2: abbonamento + posti

​Come funziona

​Casi d’uso

​Implementazione

​Varianti di prezzo

​Modello ibrido 3: abbonamento + componenti aggiuntivi per funzionalità

​Come funziona

​Casi d’uso

​Implementazione

​Modello ibrido 4: posti + utilizzo

​Come funziona

​Casi d’uso

​Opzioni di implementazione

​Modello ibrido 5: Subscription + licenze + utilizzo (ibrido triplo)

​Come funziona

​Casi d’uso

​Opzioni di implementazione

​Modello ibrido 6: base a livelli + eccedenza di utilizzo

​Come funziona

​Implementazione

​Percorso di upgrade

​Modello ibrido 7: Subscription + on-demand charges

​Come funziona

​Casi d’uso

​Implementazione

​Esempi reali

​Esempio 1: piattaforma SaaS AI

​Esempio 2: piattaforma di strumenti per sviluppatori

​Esempio 3: automazione del marketing

​Best practice di implementazione

​Chiarezza della pagina dei prezzi

​Prevedibilità dei costi

​Visibilità sull’utilizzo

​Trasparenza della fatturazione

​Risoluzione dei problemi della fatturazione ibrida

​Documentazione correlata

Products

Usage-Based Billing Guide

Subscription Management

Add-ons

Che cos’è la fatturazione ibrida?

Perché usare la fatturazione ibrida?

Modelli ibridi comuni

Modello ibrido 1: abbonamento + utilizzo

Come funziona

Casi d’uso

Implementazione

Varianti di prezzo

Modello ibrido 2: abbonamento + posti

Come funziona

Casi d’uso

Implementazione

Varianti di prezzo

Modello ibrido 3: abbonamento + componenti aggiuntivi per funzionalità

Come funziona

Casi d’uso

Implementazione

Modello ibrido 4: posti + utilizzo

Come funziona

Casi d’uso

Opzioni di implementazione

Modello ibrido 5: Subscription + licenze + utilizzo (ibrido triplo)

Come funziona

Casi d’uso

Opzioni di implementazione

Modello ibrido 6: base a livelli + eccedenza di utilizzo

Come funziona

Implementazione

Percorso di upgrade

Modello ibrido 7: Subscription + on-demand charges

Come funziona

Casi d’uso

Implementazione

Esempi reali

Esempio 1: piattaforma SaaS AI

Esempio 2: piattaforma di strumenti per sviluppatori

Esempio 3: automazione del marketing

Best practice di implementazione

Chiarezza della pagina dei prezzi

Prevedibilità dei costi

Visibilità sull’utilizzo

Trasparenza della fatturazione

Risoluzione dei problemi della fatturazione ibrida

Documentazione correlata