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, usi entrambe le modalità 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	Tariffa base + addebiti in base al consumo	$49/mese + $0.01/chiamata API dopo 10.000 incluse	✅ Completo
2. Abbonamento + postazioni	Tariffa della piattaforma + addebiti per utente	$99/mese + $15/postazione	✅ Completo
3. Abbonamento + funzionalità aggiuntive	Piano base + upgrade opzionali	$29/mese + $19/mese per analytics + $9/mese per accesso API	✅ Completo
4. Postazioni + utilizzo	Tariffa per utente + eccedenza sul consumo	$10/utente/mese + $0.05/GB dopo 5 GB/utente	⚠️ Soluzione alternativa
5. Abbonamento + postazioni + utilizzo	Piattaforma + utenti + consumo	$199/mese + $20/postazione + eccedenza sul consumo	⚠️ Soluzione alternativa
6. Base a livelli + eccedenza sull’utilizzo	Livelli diversi con soglie incluse differenti	Starter (5.000 chiamate) contro Pro (50.000 chiamate) + eccedenza	✅ Completo
7. Abbonamento + addebiti on-demand	Tariffa 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

Esempio di calcolo (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: 'pdt_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 ${process.env.DODO_PAYMENTS_API_KEY}`,
    '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/postazione

Tariffa base della piattaforma: $99/mese (include 3 postazioni)
Postazioni aggiuntive: $15/postazione/mese

Esempio di calcolo (team di 12 utenti):

Tariffa della piattaforma: $99.00
Postazioni aggiuntive: (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: 'pdt_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: 'pdt_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 postazioni
Postazioni aggiuntive: $15/postazione/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 base: $29/mese Add-on opzionali:

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

Esempio di calcolo (il cliente sceglie Piano base + Analytics + Accesso API):

Piano base: $29.00
Analytics: $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: 'pdt_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: 'pdt_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 per team: $20/utente/mese Ogni utente include:

5 GB di elaborazione dati/mese
Eccedenza: $2/GB oltre la soglia inclusa

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

Costi delle postazioni: 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.addon_id === 'addon_seat')?.quantity || 0;

  const includedGB = seatCount * 5;
  const usedGB = await calculatePeriodUsage(subscription.customer.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 postazione: $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
Postazioni: 20 × $25 = $500.00
Utilizzo: (150.000 - 50.000) × $0.10/1.000 = $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: 'pdt_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 ${process.env.DODO_PAYMENTS_API_KEY}`,
    '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 di 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: 'pdt_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 Retainer: $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/intervento

Esempio di calcolo (questo mese):

Retainer: $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.

// Note: POST /subscriptions is deprecated — prefer checkout sessions for new integrations
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: 'pdt_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:

Abbonamento base: $99/mese (accesso alla piattaforma, 5 postazioni incluse)
Add-on per postazione: $20/postazione/mese
Add-on per funzionalità: Modelli personalizzati ($49/mese), Accesso API ($29/mese), Coda prioritaria ($19/mese)
Eccedenza sull’utilizzo: $0.02 per 1.000 token dopo 100.000 (addebitata tramite on-demand)

Implementazione: utilizza un abbonamento con add-on per postazioni e funzionalità. Tieni traccia dell’utilizzo dei token nella tua applicazione e addebita le eccedenze tramite addebiti on-demand alla fine del ciclo di fatturazione. Esempio di cliente (12 utenti, 500.000 token, Modelli personalizzati + Accesso API):

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

Esempio 2: piattaforma di strumenti per sviluppatori

Opzioni di livello:

	Gratuito	Pro	Enterprise
Prezzo	$0/mese	$29/mese	$199/mese
Utenti	1	5 inclusi	Illimitati
Build	100	1.000	10.000
Spazio di 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 prioritari: $19/mese
Domini personalizzati: $9/dominio/mese

Esempio 3: automazione del marketing

Struttura dei prezzi:

Base: $79/mese (funzionalità di automazione principali, 3 postazioni incluse)
Livelli di contatti (add-on): 1.000 inclusi, 5.000 (+$30), 25.000 (+$80), 100.000 (+$200)
Add-on per funzionalità: SMS Marketing ($29/mese), Landing Page ($19/mese), Test A/B ($29/mese)
Postazioni del team: add-on da $15/utente/mese
Volume email: monitora nell’applicazione, addebita l’eccedenza tramite on-demand ($1/1.000 email oltre il limite)

Implementazione: utilizza un abbonamento con add-on per i livelli di contatti, le funzionalità e le postazioni. Monitora gli invii di email nella tua applicazione e addebita le eccedenze tramite addebiti on-demand alla fine del ciclo di fatturazione.

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.

Chiaro: “$49/mese include 10.000 chiamate API. Chiamate aggiuntive: $0.005 ciascuna” Poco chiaro: “$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
Postazioni 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.

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