Modelli di Fatturazione Ibrida - Dodo Payments Documentation

La fatturazione ibrida combina due o più modelli di fatturazione in una singola strategia di prezzo. Questo ti consente di catturare valore da diverse dimensioni: commissioni ricorrenti, utilizzo, posti e funzionalità, offrendo al contempo ai clienti flessibilità e prevedibilità.

Fatturazione Basata sull'Utilizzo

Fondamento per la fatturazione basata sul consumo.

Abbonamenti

Fondamento per la fatturazione ricorrente.

Componenti Aggiuntivi

Estendi gli abbonamenti con aggiornamenti opzionali.

Fatturazione Basata sui Posti

Modelli di prezzo per utente.

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 fatturazione basata sull’utilizzo, utilizzi entrambi insieme.

Perché Utilizzare la Fatturazione Ibrida?

Obiettivo Aziendale	Soluzione Ibrida
Ricavi prevedibili + crescita	Abbonamento base + sovraccarico per utilizzo
Prezzi per team scalabili	Per posto + componenti aggiuntivi
Acquisire clienti, espandere dopo	Basso costo base + costi di consumo
Flessibilità per le imprese	Spesa impegnata + costi on-demand
Prezzi equi per utilizzo variabile	Indennità inclusa + pagamento per utilizzo

Modelli Ibridi Comuni

Modello	Descrizione	Esempio	Supporto Nativo
1. Abbonamento + Utilizzo	Costo base + costi di consumo	$49/mese + $0.01/chiamata API dopo 10K gratuiti	✅ Completo
2. Abbonamento + Posti	Costo della piattaforma + costi per utente	$99/mese + $15/posto	✅ Completo
3. Abbonamento + Componenti Aggiuntivi	Piano base + aggiornamenti opzionali	$29/mese + $19/mese analisi + $9/mese accesso API	✅ Completo
4. Posti + Utilizzo	Costo per utente + sovraccarico per consumo	$10/utente/mese + $0.05/GB dopo 5GB/utente	⚠️ Soluzione alternativa
5. Abbonamento + Posti + Utilizzo	Piattaforma + utenti + consumo (ibrido triplo)	$199/mese + $20/posto + sovraccarico per utilizzo	⚠️ Soluzione alternativa
6. Base a Tiers + Sovraccarico per Utilizzo	Diversi livelli con diverse indennità	Starter (5K chiamate) vs Pro (50K chiamate) + sovraccarico	✅ Completo
7. Abbonamento + Costi On-Demand	Costo ricorrente + costi variabili manuali	$99/mese di ritenuta + fatturazione oraria per lavoro	✅ Completo

Modello Ibrido 1: Abbonamento + Utilizzo

Il modello ibrido più comune. I clienti pagano una tariffa di abbonamento base più costi per il consumo che superano le indennità incluse.

Come Funziona

Piano Pro: $49/mese

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

Esempio di calcolo (il cliente utilizza 25.000 chiamate questo mese):

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

Casi d’Uso

Piattaforme API: Accesso base + costi per richiesta
Servizi AI/ML: Abbonamento + utilizzo di token/generazione
Servizi di archiviazione: Piano base + sovraccarico per GB
Piattaforme di comunicazione: Base + costi per messaggio/minuto

Implementazione

Crea Misuratore di Utilizzo

Imposta un misuratore per tracciare la dimensione di utilizzo fatturabile.

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

Crea Prodotto di Abbonamento con Prezzo per Utilizzo

Crea un prodotto di abbonamento e allega il misuratore di utilizzo con il prezzo.

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 misuratore di utilizzo è allegato direttamente al prodotto di abbonamento. I costi di utilizzo vengono calcolati e aggiunti automaticamente alla fattura dell’abbonamento.

Crea Sessione di Checkout

Crea una sessione di checkout con il tuo prodotto di 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'
});

Invia Eventi di Utilizzo

Traccia 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' }
    }]
  })
});

Variazioni di Prezzo

Indennità Inclusa
Zero Base + Utilizzo Puro
Indennità a Tiers

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

Include: 10.000 chiamate API
Sovraccarico: $0.005/chiamata dopo 10.000
Il cliente utilizza 8.000 → Paga $49 (nessun sovraccarico)

Modello Ibrido 2: Abbonamento + Posti

Costo della piattaforma più costi per utente. Ideale per strumenti di collaborazione di team e SaaS B2B.

Come Funziona

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

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

Esempio di calcolo (team di 12 utenti):

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

Casi d’Uso

Strumenti di collaborazione: Costo dello spazio di lavoro + per membro
Sistemi CRM: Licenza della piattaforma + per rappresentante di vendita
Gestione progetti: Piano team + per contributore
Strumenti per sviluppatori: Costo dell’organizzazione + per sviluppatore

Implementazione

Crea Componenti Aggiuntivi per Posti

Crea un componente aggiuntivo per posti aggiuntivi.

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

Crea Abbonamento Base

Crea il prodotto di abbonamento con costo della piattaforma e allega 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

Crea Checkout con Posti

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'
});

Regola i Posti secondo Necessità

Aggiungi o rimuovi posti su 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
  }]
});

Variazioni di Prezzo

Posti Inclusi
Solo Per Posto
Per Posto a Tiers

Il piano base include alcuni posti, addebita per gli extra.Piano Team: $99/mese

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

Modello Ibrido 3: Abbonamento + Componenti Aggiuntivi

Abbonamento core con aggiornamenti opzionali che i clienti possono aggiungere.

Come Funziona

Piano Core: $29/mese Componenti Aggiuntivi Opzionali:

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

Esempio di calcolo (il cliente sceglie Core + Analisi + Accesso API):

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

Casi d’Uso

Piattaforme SaaS: Funzionalità core + moduli premium
Strumenti di marketing: Strumento base + integrazioni
Prodotti di analisi: Dashboard + report avanzati
Software di sicurezza: Protezione di base + funzionalità avanzate

Implementazione

Crea Componenti Aggiuntivi

Crea un componente aggiuntivo per ciascuna 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

Crea Abbonamento Core

Definisci il tuo abbonamento base e allega tutti i componenti aggiuntivi delle funzionalità.

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

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

Lascia che i Clienti Scegliano

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'
});

Aggiungi Funzionalità in Seguito

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

Costo per utente combinato con costi basati sul consumo. Ogni utente riceve un’indennità.

Vincolo: Dodo Payments attualmente non supporta l’allegazione di entrambi i misuratori di utilizzo e i componenti aggiuntivi allo stesso prodotto di abbonamento. Questo modello richiede una soluzione alternativa utilizzando la logica a livello di applicazione.

In Arrivo: Il supporto nativo per la fatturazione ibrida Posti + Utilizzo è nella nostra roadmap. Questo ti permetterà di allegare sia i misuratori di utilizzo che i componenti aggiuntivi per i posti allo stesso prodotto di abbonamento.

Come Funziona

Analisi Team: $20/utente/mese Ogni utente include:

5 GB di elaborazione dati/mese
Sovraccarico: $2/GB dopo l’indennità

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

Costi per posti: 10 × $20 =$ 200.00
Dati inclusi: 10 × 5 GB = 50 GB
Sovraccarico: (80 - 50) × $2 =$ 60.00
Totale: $260.00/mese

Casi d’Uso

Piattaforme di analisi: Per analista + elaborazione dati
Strumenti di design: 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 allegare sia i misuratori di utilizzo che i componenti aggiuntivi allo stesso abbonamento, scegli uno di questi approcci:

Opzione A: Prodotto di Utilizzo + Posti Gestiti dall'App
Opzione B: Componente Aggiuntivo per Posti + Costi di Utilizzo On-Demand

Utilizza un abbonamento basato sull’utilizzo e gestisci la fatturazione dei posti nella tua applicazione.

Crea Misuratore di Utilizzo

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

Crea Abbonamento Basato sull'Utilizzo

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)

Gestisci i Posti nella Tua Applicazione

Traccia il numero di posti e calcola i costi per i posti separatamente.

// 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
  });
}

Calcola Soglia Gratuita Dinamica

Regola l’utilizzo incluso in base al numero di posti.

// 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 };
}

Utilizza componenti aggiuntivi per i posti e addebita l’utilizzo manualmente tramite costi on-demand.

Crea Componente Aggiuntivo per Posti

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

Crea Abbonamento con Componente Aggiuntivo

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

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

Enable on-demand charging

Traccia l'Utilizzo nella Tua Applicazione

// 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()
  });
}

Addebita l'Utilizzo alla Fine del Ciclo

Calcola e addebita i sovraccarichi per utilizzo manualmente.

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 (Componente Aggiuntivo per Posti + Utilizzo On-Demand) è spesso più facile da implementare perché Dodo gestisce automaticamente la fatturazione dei posti. Devi solo tracciare e addebitare i sovraccarichi per utilizzo.

Modello Ibrido 5: Abbonamento + Posti + Utilizzo (Ibrido Triplo)

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

In Arrivo: Il supporto nativo per la fatturazione ibrida tripla (Base + Posti + Utilizzo) è nella nostra roadmap. Questo ti permetterà di allegare sia i misuratori di utilizzo che i componenti aggiuntivi per i posti allo stesso prodotto di abbonamento.

Come Funziona

Piattaforma Enterprise

Costo della Piattaforma: $199/mese
Per Posto: $25/utente/mese
Utilizzo: $0.10/1000 chiamate API (50K incluse)

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

Piattaforma: $199.00
Posti: 20 × $25 =$ 500.00
Utilizzo: (150K - 50K) × $0.10/1K = $10.00
Totale: $709.00/mese

Casi d’Uso

SaaS per Imprese: Piattaforma + team + consumo
Piattaforme di Dati: Spazio di lavoro + analisti + query
Piattaforme di Integrazione: Hub + connettori + transazioni
Piattaforme AI: Spazio di lavoro + sviluppatori + inferenza

Opzioni di Implementazione

Scegli uno di questi approcci per implementare la fatturazione ibrida tripla:

Opzione A: Base + Posti (Componente Aggiuntivo) + Utilizzo On-Demand
Opzione B: Base + Utilizzo (Misuratore) + Posti Gestiti dall'App

Utilizza un abbonamento con componenti aggiuntivi per i posti, addebita l’utilizzo manualmente tramite costi on-demand.Questo è l’approccio raccomandato perché Dodo gestisce automaticamente il costo della piattaforma e la fatturazione dei posti.

Crea Componente Aggiuntivo per Posti

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

Crea Prodotto di Abbonamento

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

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

Enable on-demand charging

Crea Checkout con Posti

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'
});

Traccia l'Utilizzo nella Tua Applicazione

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()
  });
}

Addebita l'Utilizzo alla Fine del Ciclo

Calcola e addebita i sovraccarichi per utilizzo tramite addebito on-demand.

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`
    });
  }
}

Utilizza un abbonamento con misuratore di utilizzo, gestisci la fatturazione dei posti nella tua applicazione.

Crea Misuratore di Utilizzo

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

Crea Prodotto di Abbonamento con Utilizzo

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

Gestisci i Posti nella Tua Applicazione

Traccia il numero di posti e regola di conseguenza il prezzo dell’abbonamento 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
}

Invia Eventi di Utilizzo a 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 + Posti + Utilizzo On-Demand) è generalmente più facile perché Dodo gestisce automaticamente la fatturazione della piattaforma e dei posti. Devi solo tracciare l’utilizzo e inviare addebiti alla fine di ogni ciclo di fatturazione.

Modello Ibrido 6: Base a Tiers + Sovraccarico per Utilizzo

Diversi livelli di abbonamento con diverse indennità incluse e tassi di sovraccarico.

Come Funziona

Livello	Prezzo	Chiamate Incluse	Tasso di Sovraccarico
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 di abbonamento separati per ciascun livello, ognuno 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 Aggiornamento

Quando i clienti aggiornano i livelli, ottengono:

Maggiore indennità inclusa
Tassi di sovraccarico più bassi
Maggiore valore per dollaro

// 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: Abbonamento + Costi On-Demand

Abbonamento ricorrente più costi variabili manuali per servizi o sovraccarichi.

Come Funziona

Piano di Ritenuta: $199/mese Include:

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

Costi On-Demand (se necessario):

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

Esempio di calcolo (questo mese):

Ritenuta: $199.00
3 ore di consulenza extra: $450.00
1 supporto di emergenza: $100.00
Totale: $749.00

Casi d’Uso

Servizi di consulenza: Ritenuta + fatturazione oraria
Servizi gestiti: Costo base + costi per incidente
Servizi di agenzia: Tariffa mensile + costi per progetto
Piani di supporto: Tariffa SLA + per ticket o per ora

Implementazione

Crea Abbonamento On-Demand

Imposta un abbonamento con addebito on-demand abilitato.

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
  }
});

Addebita per Servizi

Crea addebiti quando i servizi vengono forniti.

// 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)'
});

Traccia e Fattura

Tutti gli addebiti appaiono sulla 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.description}: $${payment.amount / 100}`);
});

Esempi del Mondo Reale

Questi esempi mostrano strutture di prezzo ideali. A causa del vincolo che i misuratori di utilizzo e i componenti aggiuntivi non possono essere allegati allo stesso prodotto, alcune combinazioni richiedono soluzioni alternative (utilizzando costi on-demand per l’utilizzo o posti gestiti dall’app).

Esempio 1: Piattaforma SaaS AI

Struttura dei Prezzi:

Abbonamento Base: $99/mese (accesso alla piattaforma, 5 posti inclusi)
Componente Aggiuntivo per Posti: $20/posto/mese
Componenti Aggiuntivi per Funzionalità: Modelli Personalizzati ($49/mese), Accesso API ($29/mese), Coda Prioritaria ($19/mese)
Sovraccarico per Utilizzo: $0.02 per 1.000 token dopo 100K (addebito tramite on-demand)

Implementazione: Utilizza un abbonamento con componenti aggiuntivi per posti e funzionalità. Traccia l’utilizzo dei token nella tua applicazione e addebita i sovraccarichi tramite costi on-demand alla fine del ciclo di fatturazione. Cliente Esempio (12 utenti, 500K token, Modelli Personalizzati + Accesso API):

Componente	Calcolo	Importo
Base	Costo della piattaforma	$99
Posti extra	7 × $20	$140
Modelli Personalizzati	Componente Aggiuntivo	$49
Accesso API	Componente Aggiuntivo	$29
Sovraccarico per token	400K × $0.02/1K (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
Builds	100	1.000	10.000
Archiviazione	1 GB	10 GB	100 GB

Opzioni di Implementazione: Opzione A (Focalizzata sull’Utilizzo): Crea prodotti con misuratori di utilizzo per builds/archiviazione. Gestisci gli utenti nella tua applicazione. Opzione B (Focalizzata sui Posti): Crea prodotti con componenti aggiuntivi per i posti. Traccia l’utilizzo di builds/archiviazione e addebita i sovraccarichi tramite on-demand. Componenti Aggiuntivi (se utilizzi l’Opzione B):

Utenti extra: $10/utente/mese
Builds prioritarie: $19/mese
Domini personalizzati: $9/dominio/mese

Esempio 3: Automazione del Marketing

Struttura dei Prezzi:

Base: $79/mese (funzionalità core di automazione, 3 posti inclusi)
Livelli di Contatto (componenti aggiuntivi): 1K inclusi, 5K (+$30), 25K (+$80), 100K (+$200)
Componenti Aggiuntivi per Funzionalità: Marketing SMS ($29/mese), Pagine di Destinazione ($19/mese), Test A/B ($29/mese)
Posti per Team: $15/utente/mese come componente aggiuntivo
Volume Email: Traccia nella tua applicazione, addebita sovraccarico tramite on-demand ($1/1.000 email oltre il limite)

Implementazione: Utilizza un abbonamento con componenti aggiuntivi per livelli di contatto, componenti aggiuntivi per funzionalità e componenti aggiuntivi per posti. Traccia l’invio di email nella tua applicazione e addebita sovraccarichi tramite costi on-demand.

Migliori Pratiche per l’Implementazione

Chiarezza della Pagina dei Prezzi

Rendi la fatturazione ibrida facile da capire. Mostra i costi base, cosa è incluso e come funzionano i sovraccarichi in modo prominente sulla tua pagina dei prezzi.

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

Prevedibilità dei Costi

Aiuta i clienti a stimare i loro 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à dell’Utilizzo

Mostra ai clienti il loro utilizzo in tempo reale:

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

  return {
    current: usage.current_period_usage,
    included: usage.free_threshold,
    remaining: Math.max(0, usage.free_threshold - usage.current_period_usage),
    overage: Math.max(0, usage.current_period_usage - usage.free_threshold),
    projectedCost: calculateProjectedOverage(usage)
  };
}

Trasparenza della Fatturazione

Fornisci fatture dettagliate che mostrano tutti i componenti:

Voce	Importo
Piano Pro (Mensile)	$49.00
Posti Aggiuntivi (7 × $15.00)	$105.00
Utilizzo API - Incluso (10.000 chiamate)	$0.00
Utilizzo API - Sovraccarico (15.420 chiamate × $0.005)	$77.10
Componente Aggiuntivo per Analisi Avanzate	$19.00
Subtotale	$250.10
Tassa (8.5%)	$21.26
Totale Dovuto	$271.36

Risoluzione dei Problemi della Fatturazione Ibrida

Utilizzo non tracciato correttamente

Sintomi: L’utilizzo mostra 0 o valori errati.Soluzioni:

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

Confusione sulla Prorata con più componenti

Sintomi: Il cliente addebitato di importi imprevisti quando cambia piano.Soluzioni:

Usa l’API previewChangePlan per mostrare le spese esatte prima di confermare
Comunica che la ripartizione si applica all’abbonamento E agli add-on
Considera di utilizzare difference_immediately per una fatturazione più semplice degli aggiornamenti

Soglia gratuita non applicata correttamente

Sintomi: Il cliente addebitato per utilizzo che dovrebbe essere gratuito.Soluzioni:

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

Componenti aggiuntivi non appaiono nel checkout

Sintomi: Non è possibile aggiungere posti o funzionalità durante il checkout.Soluzioni:

Verifica che i componenti aggiuntivi siano allegati al prodotto di abbonamento nel dashboard
Controlla che gli ID dei componenti aggiuntivi siano corretti nelle chiamate API
Assicurati che la valuta del componente aggiuntivo corrisponda alla valuta del prodotto di abbonamento

Documentazione Correlata

Prodotti

Panoramica di tutti i tipi di prodotto e guide.

Guida alla Fatturazione Basata sull'Utilizzo

Implementazione completa della fatturazione per utilizzo.

Gestione degli Abbonamenti

Gestire abbonamenti ricorrenti.

Componenti Aggiuntivi

Estendere gli abbonamenti con componenti aggiuntivi.

Getting Started

Features

Integrate

Merchant of Record

Miscellaneous

Fatturazione Basata sull'Utilizzo

Abbonamenti

Componenti Aggiuntivi

Fatturazione Basata sui Posti

​Cos’è la Fatturazione Ibrida?

​Perché Utilizzare la Fatturazione Ibrida?

​Modelli Ibridi Comuni

​Modello Ibrido 1: Abbonamento + Utilizzo

​Come Funziona

​Casi d’Uso

​Implementazione

​Variazioni di Prezzo

​Modello Ibrido 2: Abbonamento + Posti

​Come Funziona

​Casi d’Uso

​Implementazione

​Variazioni di Prezzo

​Modello Ibrido 3: Abbonamento + Componenti Aggiuntivi

​Come Funziona

​Casi d’Uso

​Implementazione

​Modello Ibrido 4: Posti + Utilizzo

​Come Funziona

​Casi d’Uso

​Opzioni di Implementazione

​Modello Ibrido 5: Abbonamento + Posti + Utilizzo (Ibrido Triplo)

​Come Funziona

​Casi d’Uso

​Opzioni di Implementazione

​Modello Ibrido 6: Base a Tiers + Sovraccarico per Utilizzo

​Come Funziona

​Implementazione

​Percorso di Aggiornamento

​Modello Ibrido 7: Abbonamento + Costi On-Demand

​Come Funziona

​Casi d’Uso

​Implementazione

​Esempi del Mondo Reale

​Esempio 1: Piattaforma SaaS AI

​Esempio 2: Piattaforma di Strumenti per Sviluppatori

​Esempio 3: Automazione del Marketing

​Migliori Pratiche per l’Implementazione

​Chiarezza della Pagina dei Prezzi

​Prevedibilità dei Costi

​Visibilità dell’Utilizzo

​Trasparenza della Fatturazione

​Risoluzione dei Problemi della Fatturazione Ibrida

​Documentazione Correlata

Prodotti

Guida alla Fatturazione Basata sull'Utilizzo

Gestione degli Abbonamenti

Componenti Aggiuntivi

Cos’è la Fatturazione Ibrida?

Perché Utilizzare la Fatturazione Ibrida?

Modelli Ibridi Comuni

Modello Ibrido 1: Abbonamento + Utilizzo

Come Funziona

Casi d’Uso

Implementazione

Variazioni di Prezzo

Modello Ibrido 2: Abbonamento + Posti

Come Funziona

Casi d’Uso

Implementazione

Variazioni di Prezzo

Modello Ibrido 3: Abbonamento + Componenti Aggiuntivi

Come Funziona

Casi d’Uso

Implementazione

Modello Ibrido 4: Posti + Utilizzo

Come Funziona

Casi d’Uso

Opzioni di Implementazione

Modello Ibrido 5: Abbonamento + Posti + Utilizzo (Ibrido Triplo)

Come Funziona

Casi d’Uso

Opzioni di Implementazione

Modello Ibrido 6: Base a Tiers + Sovraccarico per Utilizzo

Come Funziona

Implementazione

Percorso di Aggiornamento

Modello Ibrido 7: Abbonamento + Costi On-Demand

Come Funziona

Casi d’Uso

Implementazione

Esempi del Mondo Reale

Esempio 1: Piattaforma SaaS AI

Esempio 2: Piattaforma di Strumenti per Sviluppatori

Esempio 3: Automazione del Marketing

Migliori Pratiche per l’Implementazione

Chiarezza della Pagina dei Prezzi

Prevedibilità dei Costi

Visibilità dell’Utilizzo

Trasparenza della Fatturazione

Risoluzione dei Problemi della Fatturazione Ibrida

Documentazione Correlata