Modèles de facturation hybride - Dodo Payments Documentation

La facturation hybride combine deux modèles de facturation ou plus au sein d’une seule stratégie tarifaire. Elle vous permet de capter la valeur de différentes dimensions — frais récurrents, utilisation, utilisateurs et fonctionnalités — tout en offrant aux clients flexibilité et prévisibilité.

Usage-Based Billing

Base pour une tarification basée sur la consommation.

Subscriptions

Base pour la facturation récurrente.

Add-ons

Étendez les abonnements avec des mises à niveau facultatives.

Seat-Based Billing

Modèles tarifaires par utilisateur.

Qu’est-ce que la facturation hybride ?

La facturation hybride combine plusieurs dimensions tarifaires au sein d’une seule offre. Au lieu de choisir entre des abonnements à tarif fixe OU une tarification basée sur l’utilisation, vous utilisez les deux simultanément.

Pourquoi utiliser la facturation hybride ?

Objectif commercial	Solution hybride
Revenus prévisibles + potentiel de croissance	Abonnement de base + dépassement lié à l’utilisation
Tarification d’équipe évolutive	Par utilisateur + modules complémentaires
Acquérir des clients, puis élargir l’offre	Frais de base réduits + frais de consommation
Flexibilité pour les entreprises	Dépenses engagées + frais à la demande
Tarification équitable pour une utilisation variable	Quota inclus + paiement à l’utilisation

Modèles hybrides courants

Modèle	Description	Exemple	Prise en charge native
1. Abonnement + utilisation	Frais de base + frais de consommation	$49/mois + $0.01/appel API après 10K appels gratuits	✅ Complète
2. Abonnement + utilisateurs	Frais de plateforme + frais par utilisateur	$99/mois + $15/utilisateur	✅ Complète
3. Abonnement + modules complémentaires	Offre principale + mises à niveau facultatives	$29/mois + $19/mois pour les analytics + $9/mois pour l’accès API	✅ Complète
4. Utilisateurs + utilisation	Frais par utilisateur + dépassement lié à la consommation	$10/utilisateur/mois + $0.05/GB après 5GB/utilisateur	⚠️ Contournement nécessaire
5. Abonnement + utilisateurs + utilisation	Plateforme + utilisateurs + consommation (triple hybride)	$199/mois + $20/utilisateur + dépassement d’utilisation	⚠️ Contournement nécessaire
6. Base par niveaux + dépassement d’utilisation	Différents niveaux avec différents quotas	Starter (5K appels) contre Pro (50K appels) + dépassement	✅ Complète
7. Abonnement + frais à la demande	Frais récurrents + frais manuels variables	Retainer de $99/mois + facturation horaire des prestations	✅ Complète

Modèle hybride 1 : abonnement + utilisation

Le modèle hybride le plus courant. Les clients paient des frais d’abonnement de base, auxquels s’ajoutent les frais de consommation dépassant les quotas inclus.

Fonctionnement

Offre Pro : $49/mois

Inclus : 10,000 appels API/mois
Dépassement : $0.005 par appel au-delà de 10,000

Exemple de calcul (le client utilise 25,000 appels ce mois-ci) :

Abonnement de base : $49.00
Dépassement : (25,000 - 10,000) × $0.005 =$ 75.00
Total : $124.00

Cas d’utilisation

Plateformes API : accès de base + frais par requête
Services AI/ML : abonnement + utilisation de tokens/générations
Services de stockage : offre de base + dépassement par GB
Plateformes de communication : base + frais par message/minute

Mise en œuvre

Create Usage Meter

Configurez un meter pour suivre la dimension d’utilisation facturable.

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

Create Subscription Product with Usage Pricing

Créez un subscription product et associez-lui le meter d’utilisation avec sa tarification.

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)

Le meter d’utilisation est directement associé au subscription product. Les frais d’utilisation sont calculés et ajoutés automatiquement à la facture de l’abonnement.

Create Checkout Session

Créez une checkout session avec votre subscription product.

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

Suivez l’utilisation pendant toute la période de facturation.

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

Variantes tarifaires

Included Allowance
Zero Base + Pure Usage
Tiered Allowances

Le seuil gratuit couvre l’utilisation incluse dans l’abonnement de base.Offre Pro : $49/mois

Inclut : 10,000 appels API
Dépassement : $0.005/appel après 10,000
Le client utilise 8,000 appels → paie $49 (aucun dépassement)

Modèle hybride 2 : abonnement + utilisateurs

Frais de plateforme auxquels s’ajoutent des frais par utilisateur. Idéal pour les outils de collaboration d’équipe et les solutions B2B SaaS.

Fonctionnement

Offre Team : $99/mois +$ 15/utilisateur

Frais de plateforme de base : $99/mois (inclut 3 utilisateurs)
Utilisateurs supplémentaires : $15/utilisateur/mois

Exemple de calcul (équipe de 12 utilisateurs) :

Frais de plateforme : $99.00
Utilisateurs supplémentaires : (12 - 3) × $15 =$ 135.00
Total : $234.00/mois

Cas d’utilisation

Outils de collaboration : frais d’espace de travail + frais par membre
Systèmes CRM : licence de plateforme + frais par commercial
Gestion de projets : offre d’équipe + frais par contributeur
Outils pour développeurs : frais d’organisation + frais par développeur

Mise en œuvre

Create Seat Add-on

Créez un add-on pour les utilisateurs supplémentaires.

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

Create Base Subscription

Créez le subscription product avec les frais de plateforme et associez l’add-on.

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

Indiquez la quantité d’utilisateurs lors du 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

Ajoutez ou supprimez des utilisateurs sur les abonnements existants.

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

Variantes tarifaires

Included Seats
Pure Per-Seat
Tiered Per-Seat

L’offre de base inclut certains utilisateurs ; les utilisateurs supplémentaires sont facturés.Offre Team : $99/mois

Inclut : 5 utilisateurs
Utilisateurs supplémentaires : $15/utilisateur/mois
20 utilisateurs = $99 + (15 × $15) = $324/mois

Modèle hybride 3 : abonnement + modules complémentaires de fonctionnalités

Abonnement principal auquel les clients peuvent ajouter des mises à niveau de fonctionnalités facultatives.

Fonctionnement

Offre principale : $29/mois Modules complémentaires facultatifs :

Analytics avancés : +$19/mois
Accès API : +$9/mois
Support prioritaire : +$29/mois
White-label : +$49/mois

Exemple de calcul (le client choisit l’offre principale + Analytics + accès API) :

Offre principale : $29.00
Analytics : $19.00
Accès API : $9.00
Total : $57.00/mois

Cas d’utilisation

Plateformes SaaS : fonctionnalités principales + modules premium
Outils marketing : outil de base + intégrations
Produits d’analytics : tableau de bord + rapports avancés
Logiciels de sécurité : protection de base + fonctionnalités avancées

Mise en œuvre

Create Feature Add-ons

Créez un add-on pour chaque fonctionnalité facultative.

# 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

Définissez votre abonnement de base et associez tous les add-ons de fonctionnalités.

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

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

Let Customers Choose

Effectuez le checkout avec les fonctionnalités sélectionnées.

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

Les clients peuvent ajouter des fonctionnalités aux abonnements existants.

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

Modèle hybride 4 : utilisateurs + utilisation

Frais par utilisateur combinés à des frais basés sur la consommation. Chaque utilisateur bénéficie d’un quota.

Limitation : Dodo Payments ne prend actuellement pas en charge l’association simultanée de meters d’utilisation et d’add-ons au même subscription product. Ce modèle nécessite un contournement à l’aide d’une logique au niveau de l’application.

Bientôt disponible : la prise en charge native de la facturation hybride Utilisateurs + Utilisation figure sur notre feuille de route. Elle vous permettra d’associer à un même subscription product des meters d’utilisation et des add-ons d’utilisateurs.

Fonctionnement

Analytics d’équipe : $20/utilisateur/mois Chaque utilisateur inclut :

5 GB de traitement de données/mois
Dépassement : $2/GB après le quota

Exemple de calcul (équipe de 10 utilisateurs utilisant 80 GB au total) :

Frais utilisateurs : 10 × $20 =$ 200.00
Données incluses : 10 × 5 GB = 50 GB
Dépassement : (80 - 50) × $2 =$ 60.00
Total : $260.00/mois

Cas d’utilisation

Plateformes d’analytics : par analyste + traitement des données
Outils de design : par designer + stockage/exports
Environnements de développement : par développeur + heures de calcul
Outils de communication : par utilisateur + volume de messages/appels

Options de mise en œuvre

Comme vous ne pouvez pas associer simultanément des meters d’utilisation et des add-ons au même abonnement, choisissez l’une des approches suivantes :

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

Utilisez un abonnement basé sur l’utilisation et gérez la facturation des utilisateurs dans votre application.

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

Suivez le nombre d’utilisateurs et calculez séparément les frais correspondants.

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

Ajustez l’utilisation incluse en fonction du nombre d’utilisateurs.

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

Utilisez des add-ons pour les utilisateurs et facturez manuellement l’utilisation au moyen de frais à la demande.

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

Calculez et facturez manuellement les dépassements d’utilisation.

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

Recommandation : l’option B (add-on d’utilisateurs + utilisation à la demande) est souvent plus facile à mettre en œuvre, car Dodo gère automatiquement la facturation des utilisateurs. Il vous suffit de suivre les dépassements d’utilisation et de les facturer.

Modèle hybride 5 : abonnement + utilisateurs + utilisation (triple hybride)

Le modèle le plus complet : frais de plateforme + frais par utilisateur + consommation.

Bientôt disponible : la prise en charge native de la facturation triple hybride (base + utilisateurs + utilisation) figure sur notre feuille de route. Elle permettra d’associer à un même subscription product des meters d’utilisation et des add-ons d’utilisateurs.

Fonctionnement

Plateforme Enterprise

Frais de plateforme : $199/mois
Par utilisateur : $25/utilisateur/mois
Utilisation : $0.10/1,000 appels API (50K inclus)

Exemple de calcul (entreprise de 20 utilisateurs effectuant 150,000 appels API) :

Plateforme : $199.00
Utilisateurs : 20 × $25 =$ 500.00
Utilisation : (150K - 50K) × $0.10/1K = $10.00
Total : $709.00/mois

Cas d’utilisation

SaaS Enterprise : plateforme + équipe + consommation
Plateformes de données : espace de travail + analystes + requêtes
Plateformes d’intégration : hub + connecteurs + transactions
Plateformes AI : espace de travail + développeurs + inférence

Options de mise en œuvre

Choisissez l’une des approches suivantes pour mettre en œuvre la facturation triple hybride :

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

Utilisez un abonnement avec des add-ons d’utilisateurs et facturez manuellement l’utilisation au moyen de frais à la demande.Il s’agit de l’approche recommandée, car Dodo gère automatiquement les frais de plateforme et la facturation des utilisateurs.

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

Stockez les événements d’utilisation dans votre système.

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

Calculez et facturez les dépassements d’utilisation au moyen de frais à la demande.

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

Utilisez un abonnement avec un meter d’utilisation et gérez la facturation des utilisateurs dans votre application.

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

Suivez le nombre d’utilisateurs et ajustez le prix de l’abonnement de base en conséquence.

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

Recommandation : l’option A (base + utilisateurs + utilisation à la demande) est généralement plus facile, car Dodo gère automatiquement la facturation de la plateforme et des utilisateurs. Il vous suffit de suivre l’utilisation et de soumettre les frais à la fin de chaque cycle de facturation.

Modèle hybride 6 : base par niveaux + dépassement d’utilisation

Différents niveaux d’abonnement avec différents quotas inclus et différents tarifs de dépassement.

Fonctionnement

Niveau	Prix	Appels inclus	Tarif de dépassement
Starter	$19/mois	1,000	$0.02/appel
Pro	$79/mois	25,000	$0.01/appel
Business	$199/mois	100,000	$0.005/appel
Enterprise	$499/mois	500,000	$0.002/appel

Mise en œuvre

Créez des subscription products distincts pour chaque niveau, chacun avec sa propre configuration d’utilisation :

# 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

Parcours de mise à niveau

Lorsque les clients changent de niveau, ils bénéficient de :

Un quota inclus plus élevé
Des tarifs de dépassement plus faibles
Une valeur supérieure pour chaque dollar dépensé

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

Modèle hybride 7 : abonnement + frais à la demande

Abonnement récurrent complété par des frais manuels variables pour des services ou des dépassements.

Fonctionnement

Offre Retainer : $199/mois Inclut :

Accès à la plateforme
5 heures de conseil/mois
Support par e-mail

Frais à la demande (selon les besoins) :

Conseil supplémentaire : $150/heure
Développement personnalisé : $200/heure
Support d’urgence : $100/incident

Exemple de calcul (ce mois-ci) :

Retainer : $199.00
3 heures de conseil supplémentaires : $450.00
1 intervention de support d’urgence : $100.00
Total : $749.00

Cas d’utilisation

Services de conseil : Retainer + facturation horaire
Services gérés : frais de base + frais par incident
Services d’agence : frais mensuels + frais de projet
Offres de support : frais SLA + frais par ticket ou par heure

Mise en œuvre

Create On-Demand Subscription

Configurez un abonnement avec la facturation à la demande activée.

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

Créez les frais lorsque les services sont fournis.

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

Tous les frais apparaissent sur la facture du client.

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

Exemples concrets

Ces exemples présentent des structures tarifaires idéales. En raison de la limitation qui empêche d’associer des meters d’utilisation et des add-ons au même produit, certaines combinaisons nécessitent des contournements (frais à la demande pour l’utilisation ou gestion des utilisateurs dans l’application).

Exemple 1 : plateforme SaaS AI

Structure tarifaire :

Abonnement de base : $99/mois (accès à la plateforme, 5 utilisateurs inclus)
Add-on d’utilisateurs : $20/utilisateur/mois
Modules complémentaires de fonctionnalités : modèles personnalisés ($49/mois), accès API ($29/mois), file d’attente prioritaire ($19/mois)
Dépassement d’utilisation : $0.02 par 1,000 tokens après 100K (facturé à la demande)

Mise en œuvre : utilisez un abonnement avec des add-ons d’utilisateurs et de fonctionnalités. Suivez l’utilisation des tokens dans votre application et facturez les dépassements au moyen de frais à la demande à la fin du cycle de facturation. Exemple de client (12 utilisateurs, 500K tokens, modèles personnalisés + accès API) :

Composant	Calcul	Montant
Base	Frais de plateforme	$99
Utilisateurs supplémentaires	7 × $20	$140
Modèles personnalisés	Add-on	$49
Accès API	Add-on	$29
Dépassement de tokens	400K × $0.02/1K (à la demande)	$8
Total		$325/mois

Exemple 2 : plateforme d’outils pour développeurs

Options de niveau :

	Gratuit	Pro	Enterprise
Prix	$0/mois	$29/mois	$199/mois
Utilisateurs	1	5 inclus	Illimités
Builds	100	1,000	10,000
Stockage	1 GB	10 GB	100 GB

Options de mise en œuvre : Option A (axée sur l’utilisation) : créez des produits avec des meters d’utilisation pour les builds et le stockage. Gérez les utilisateurs dans votre application. Option B (axée sur les utilisateurs) : créez des produits avec des add-ons d’utilisateurs. Suivez l’utilisation des builds et du stockage et facturez les dépassements à la demande. Add-ons (si vous utilisez l’option B) :

Utilisateurs supplémentaires : $10/utilisateur/mois
Builds prioritaires : $19/mois
Domaines personnalisés : $9/domaine/mois

Exemple 3 : automatisation marketing

Structure tarifaire :

Base : $79/mois (fonctionnalités principales d’automatisation, 3 utilisateurs inclus)
Niveaux de contacts (add-ons) : 1K inclus, 5K (+$30), 25K (+$80), 100K (+$200)
Modules complémentaires de fonctionnalités : marketing SMS ($29/mois), landing pages ($19/mois), tests A/B ($29/mois)
Utilisateurs de l’équipe : add-on à $15/utilisateur/mois
Volume d’e-mails : suivi dans l’application, dépassement facturé à la demande ($1/1,000 e-mails au-delà de la limite)

Mise en œuvre : utilisez un abonnement avec des add-ons de niveaux de contacts, de fonctionnalités et d’utilisateurs. Suivez les envois d’e-mails dans votre application et facturez les dépassements au moyen de frais à la demande.

Bonnes pratiques de mise en œuvre

Clarté de la page tarifaire

Rendez la tarification hybride facile à comprendre. Présentez clairement les coûts de base, ce qui est inclus et le fonctionnement des dépassements sur votre page tarifaire.

Bon : “$49/mois inclut 10,000 appels API. Appels supplémentaires : $0.005 chacun” Mauvais : “$49/mois + frais d’utilisation”

Prévisibilité des coûts

Aidez les clients à estimer leurs coûts :

// 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é de l’utilisation

Montrez aux clients leur utilisation en temps réel :

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

Transparence de la facturation

Fournissez des factures détaillées présentant tous les composants :

Poste	Montant
Offre Pro (mensuelle)	$49.00
Utilisateurs supplémentaires (7 × $15.00)	$105.00
Utilisation API - incluse (10,000 appels)	$0.00
Utilisation API - dépassement (15,420 appels × $0.005)	$77.10
Add-on Analytics avancés	$19.00
Sous-total	$250.10
Taxe (8.5%)	$21.26
Total dû	$271.36

Résolution des problèmes de facturation hybride

Usage not being tracked correctly

Symptômes : l’utilisation affiche 0 ou des valeurs incorrectes.Solutions :

Vérifiez que l’ingestion des événements fonctionne (contrôlez les réponses API)
Vérifiez que customer_id correspond au client de l’abonnement
Vérifiez que event_name correspond à la configuration du meter
Vérifiez que les événements possèdent des timestamps corrects (et ne sont pas datés dans le futur)

Proration confusion with multiple components

Symptômes : le client est facturé des montants inattendus lors d’un changement d’offre.Solutions :

Utilisez l’API previewChangePlan pour afficher les frais exacts avant confirmation
Indiquez que le prorata s’applique à l’abonnement ET aux add-ons
Envisagez d’utiliser difference_immediately pour simplifier la facturation des mises à niveau

Free threshold not applying correctly

Symptômes : le client est facturé pour une utilisation qui devrait être gratuite.Solutions :

Vérifiez que le seuil gratuit est configuré sur le produit basé sur l’utilisation
Vérifiez que l’unité du seuil correspond à l’agrégation des événements (appels contre requêtes)
Confirmez que le meter d’utilisation est correctement associé au subscription product

Add-ons not appearing in checkout

Symptômes : impossible d’ajouter des utilisateurs ou des fonctionnalités lors du checkout.Solutions :

Vérifiez que les add-ons sont associés au subscription product dans le dashboard
Vérifiez que les identifiants des add-ons sont corrects dans les appels API
Assurez-vous que la devise de l’add-on correspond à celle du subscription product

Documentation associée

Products

Vue d’ensemble de tous les types de produits et guides.

Usage-Based Billing Guide

Mise en œuvre complète de la facturation basée sur l’utilisation.

Subscription Management

Gestion des abonnements récurrents.

Add-ons

Extension des abonnements avec des add-ons.

Dernière modification le 31 juillet 2026

Usage-Based Billing

Subscriptions

Add-ons

Seat-Based Billing

​Qu’est-ce que la facturation hybride ?

​Pourquoi utiliser la facturation hybride ?

​Modèles hybrides courants

​Modèle hybride 1 : abonnement + utilisation

​Fonctionnement

​Cas d’utilisation

​Mise en œuvre

​Variantes tarifaires

​Modèle hybride 2 : abonnement + utilisateurs

​Fonctionnement

​Cas d’utilisation

​Mise en œuvre

​Variantes tarifaires

​Modèle hybride 3 : abonnement + modules complémentaires de fonctionnalités

​Fonctionnement

​Cas d’utilisation

​Mise en œuvre

​Modèle hybride 4 : utilisateurs + utilisation

​Fonctionnement

​Cas d’utilisation

​Options de mise en œuvre

​Modèle hybride 5 : abonnement + utilisateurs + utilisation (triple hybride)

​Fonctionnement

​Cas d’utilisation

​Options de mise en œuvre

​Modèle hybride 6 : base par niveaux + dépassement d’utilisation

​Fonctionnement

​Mise en œuvre

​Parcours de mise à niveau

​Modèle hybride 7 : abonnement + frais à la demande

​Fonctionnement

​Cas d’utilisation

​Mise en œuvre

​Exemples concrets

​Exemple 1 : plateforme SaaS AI

​Exemple 2 : plateforme d’outils pour développeurs

​Exemple 3 : automatisation marketing

​Bonnes pratiques de mise en œuvre

​Clarté de la page tarifaire

​Prévisibilité des coûts

​Visibilité de l’utilisation

​Transparence de la facturation

​Résolution des problèmes de facturation hybride

​Documentation associée

Products

Usage-Based Billing Guide

Subscription Management

Add-ons

Qu’est-ce que la facturation hybride ?

Pourquoi utiliser la facturation hybride ?

Modèles hybrides courants

Modèle hybride 1 : abonnement + utilisation

Fonctionnement

Cas d’utilisation

Mise en œuvre

Variantes tarifaires

Modèle hybride 2 : abonnement + utilisateurs

Fonctionnement

Cas d’utilisation

Mise en œuvre

Variantes tarifaires

Modèle hybride 3 : abonnement + modules complémentaires de fonctionnalités

Fonctionnement

Cas d’utilisation

Mise en œuvre

Modèle hybride 4 : utilisateurs + utilisation

Fonctionnement

Cas d’utilisation

Options de mise en œuvre

Modèle hybride 5 : abonnement + utilisateurs + utilisation (triple hybride)

Fonctionnement

Cas d’utilisation

Options de mise en œuvre

Modèle hybride 6 : base par niveaux + dépassement d’utilisation

Fonctionnement

Mise en œuvre

Parcours de mise à niveau

Modèle hybride 7 : abonnement + frais à la demande

Fonctionnement

Cas d’utilisation

Mise en œuvre

Exemples concrets

Exemple 1 : plateforme SaaS AI

Exemple 2 : plateforme d’outils pour développeurs

Exemple 3 : automatisation marketing

Bonnes pratiques de mise en œuvre

Clarté de la page tarifaire

Prévisibilité des coûts

Visibilité de l’utilisation

Transparence de la facturation

Résolution des problèmes de facturation hybride

Documentation associée