Modelli di Fatturazione Ibrida

​

Cos’è la Fatturazione Ibrida?

​

Perché Utilizzare la Fatturazione Ibrida?

​

Modelli Ibridi Comuni

​

Modello Ibrido 1: Abbonamento + Utilizzo

​

Come Funziona

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

• 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

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

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)

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

await fetch('https://api.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

​

Modello Ibrido 2: Abbonamento + Posti

​

Come Funziona

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

• 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

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

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

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: '[email protected]' },
  return_url: 'https://yourapp.com/success'
});

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

​

Modello Ibrido 3: Abbonamento + Componenti Aggiuntivi

​

Come Funziona

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

• 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

# 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

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

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

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

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

​

Come Funziona

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

• 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

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

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)

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

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

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

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

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

Enable on-demand charging

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

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

​

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

​

Come Funziona

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

• 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

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

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

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

Enable on-demand charging

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: '[email protected]' },
  return_url: 'https://yourapp.com/success'
});

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

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

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

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

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

await fetch('https://api.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()
    }]
  })
});

​

Modello Ibrido 6: Base a Tiers + Sovraccarico per Utilizzo

​

Come Funziona

​

Implementazione

# 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

• 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

​

Come Funziona

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

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

• 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

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

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

​

Esempio 1: Piattaforma SaaS AI

• 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)

​

Esempio 2: Piattaforma di Strumenti per Sviluppatori

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

​

Esempio 3: Automazione del Marketing

• 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)

​

Migliori Pratiche per l’Implementazione

​

Chiarezza della Pagina dei Prezzi

​

Prevedibilità dei 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

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

​

Risoluzione dei Problemi della Fatturazione Ibrida

​

Documentazione Correlata