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 même offre produit. Au lieu de choisir entre des abonnements à tarif fixe ou une tarification basée sur l’usage, 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 + Usage	Frais de base + frais de consommation	$49/mois + $0.01/appel API après 10K gratuits	✅ Complète
2. Abonnement + Sièges	Frais de plateforme + frais par utilisateur	$99/mois + $15/siège	✅ Complète
3. Abonnement + Modules complémentaires	Offre principale + mises à niveau facultatives	$29/mois + $19/mois pour l’analytique + $9/mois pour l’accès API	✅ Complète
4. Sièges + Usage	Frais par utilisateur + dépassement de consommation	$10/utilisateur/mois + $0.05/Go après 5 Go/utilisateur	⚠️ Contournement
5. Abonnement + Sièges + Usage	Plateforme + utilisateurs + consommation	$199/mois + $20/siège + dépassement lié à l’usage	⚠️ Contournement
6. Base par paliers + Dépassement lié à l’usage	Différents paliers avec différentes allocations	Starter (5K appels) contre Pro (50K appels) + dépassement	✅ Complète
7. Abonnement + Frais à la demande	Frais récurrents + frais manuels variables	Forfait de $99/mois + facturation horaire du travail	✅ 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 après 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: 'pdt_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 ${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' }
    }]
  })
});

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

Comprend : 10 000 appels API
Dépassement : $0.005/appel après 10 000
Le client utilise 8 000 → 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/siège

Frais de plateforme de base : $99/mois (3 sièges inclus)
Sièges supplémentaires : $15/siège/mois

Exemple de calcul (équipe de 12 utilisateurs) :

Frais de plateforme : $99.00
Sièges 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: '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

Ajoutez ou supprimez des utilisateurs sur les abonnements existants.

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

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

Comprend : 5 sièges
Sièges supplémentaires : $15/siège/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 :

Analytique avancée : +$19/mois
Accès API : +$9/mois
Support prioritaire : +$29/mois
Marque blanche : +$49/mois

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

Offre principale : $29.00
Analytique : $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: '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

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

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

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.

Fonctionnement

Analytique d’équipe : $20/utilisateur/mois Chaque utilisateur comprend :

5 Go de traitement des données/mois
Dépassement : $2/Go après l’allocation

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

Frais de sièges : 10 × $20 = $200.00
Données incluses : 10 × 5 Go = 50 Go
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/exportations
Environnements de développement : par développeur + heures de calcul
Outils de communication : par utilisateur + volume de messages/appels

Options d’implémentation

Comme vous ne pouvez pas associer des usage meters 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 sièges 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 de sièges et calculez séparément les frais de sièges.

// 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 de sièges.

// 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 sièges 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.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`
    });
  }
}

Recommandation : l’option B (add-on de sièges + utilisation à la demande) est souvent plus facile à implémenter, car Dodo gère automatiquement la facturation des sièges. Vous devez uniquement suivre et facturer les dépassements d’utilisation.

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

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

Contrainte : Dodo Payments ne prend actuellement pas en charge l’association de usage meters et d’add-ons au même produit d’abonnement. Ce modèle nécessite une solution de contournement.

Fonctionnement

Plateforme Enterprise

Frais de plateforme : $199/mois
Par siège : $25/utilisateur/mois
Usage : $0.10/1 000 appels API (50K inclus)

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

Plateforme : $199.00
Sièges : 20 × $25 = $500.00
Usage : (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 d’IA : espace de travail + développeurs + inférence

Options d’implémentation

Choisissez l’une des approches suivantes pour implémenter une 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 de sièges 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 sièges.

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

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 via un 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 usage meter et gérez la facturation des sièges 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 de sièges et ajustez le prix de base de l’abonnement 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 ${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()
    }]
  })
});

Recommandation : l’option A (base + sièges + utilisation à la demande) est généralement plus facile, car Dodo gère automatiquement la facturation de la plateforme et des sièges. Vous devez uniquement suivre l’utilisation et envoyer les frais à la fin de chaque cycle de facturation.

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

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

Fonctionnement

Palier	Prix	Appels inclus	Taux 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

Implémentation

Créez des produits d’abonnement 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

Lorsqu’ils changent de niveau, les clients 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: 'pdt_pro',
  quantity: 1,
  proration_billing_mode: 'prorated_immediately'
});

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

Abonnement récurrent accompagné de frais variables manuels pour les services ou les dépassements.

Fonctionnement

Forfait : $199/mois Comprend :

Accès à la plateforme
5 heures de conseil/mois
Assistance 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) :

Forfait : $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 : rétention + facturation horaire
Services gérés : frais de base + frais par incident
Services d’agence : frais mensuels + frais par projet
Plans d’assistance : frais SLA + frais par ticket ou par heure

Implémentation

Create On-Demand Subscription

Configurez l’abonnement avec la facturation à la demande activée.

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

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.payment_id}: $${payment.total_amount / 100}`);
});

Exemples concrets

Ces exemples présentent des structures tarifaires idéales. En raison de la contrainte selon laquelle les usage meters et les add-ons ne peuvent pas être associés au même produit, certaines combinaisons nécessitent des solutions de contournement (frais à la demande pour l’utilisation ou sièges gérés par l’application).

Exemple 1 : plateforme SaaS d’IA

Structure tarifaire :

Abonnement de base : $99/mois (accès à la plateforme, 5 sièges inclus)
Module complémentaire de sièges : $20/siège/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 lié à l’usage : $0.02 par tranche de 1 000 tokens après 100K (facturé via la demande)

Implémentation : utilisez un abonnement avec des modules complémentaires de sièges et de fonctionnalités. Suivez l’usage des tokens dans votre application et facturez les dépassements via des 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
Sièges supplémentaires	7 × $20	$140
Modèles personnalisés	Module complémentaire	$49
Accès API	Module complémentaire	$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é
Builds	100	1 000	10 000
Stockage	1 Go	10 Go	100 Go

Options d’implémentation : Option A (axée sur l’utilisation) : créez des produits avec des usage meters pour les builds/le stockage. Gérez les utilisateurs dans votre application. Option B (axée sur les sièges) : créez des produits avec des add-ons de sièges. Suivez l’utilisation des builds/du stockage et facturez les dépassements à la demande. Modules complémentaires (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 sièges inclus)
Paliers de contacts (modules complémentaires) : 1K inclus, 5K (+$30), 25K (+$80), 100K (+$200)
Modules complémentaires de fonctionnalités : Marketing par SMS ($29/mois), Pages d’atterrissage ($19/mois), Tests A/B ($29/mois)
Sièges d’équipe : module complémentaire à $15/utilisateur/mois
Volume d’e-mails : suivez-le dans l’application et facturez le dépassement à la demande ($1/1 000 e-mails au-delà de la limite)

Implémentation : utilisez un abonnement avec des modules complémentaires de paliers de contacts, de fonctionnalités et de sièges. Suivez les envois d’e-mails dans votre application et facturez les dépassements via des frais à la demande à la fin du cycle de facturation.

Bonnes pratiques d’implémentation

Clarté de la page tarifaire

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

Clair : « $49/mois inclut 10 000 appels API. Appels supplémentaires : $0.005 chacun » Pas clair : « $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
Sièges supplémentaires (7 × $15.00)	$105.00
Usage API - Inclus (10 000 appels)	$0.00
Usage API - Dépassement (15 420 appels × $0.005)	$77.10
Module complémentaire d’analytique avancée	$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 (vérifiez les réponses de l’API)
Confirmez 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 horodatages corrects (et ne sont pas datés dans le futur)

Proration confusion with multiple components

Symptômes : le client se voit facturer des montants inattendus lors d’un changement de plan.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 lors 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 ou requêtes)
Confirmez que le usage meter est correctement associé au produit d’abonnement

Add-ons not appearing in checkout

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

Vérifiez que les add-ons sont associés au produit d’abonnement 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 produit d’abonnement

Documentation associée

Products

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

Usage-Based Billing Guide

Implémentation 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 26 septembre 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 d’implémentation

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

​Fonctionnement

​Cas d’utilisation

​Options d’implémentation

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

​Fonctionnement

​Implémentation

​Parcours de mise à niveau

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

​Fonctionnement

​Cas d’utilisation

​Implémentation

​Exemples concrets

​Exemple 1 : plateforme SaaS d’IA

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

​Exemple 3 : automatisation marketing

​Bonnes pratiques d’implémentation

​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 d’implémentation

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

Fonctionnement

Cas d’utilisation

Options d’implémentation

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

Fonctionnement

Implémentation

Parcours de mise à niveau

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

Fonctionnement

Cas d’utilisation

Implémentation

Exemples concrets

Exemple 1 : plateforme SaaS d’IA

Exemple 2 : plateforme d’outils pour développeurs

Exemple 3 : automatisation marketing

Bonnes pratiques d’implémentation

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