Credit-Based Billing

​

Qu’est-ce que la facturation basée sur le crédit ?

• Plateformes AI et LLM : Accorder des jetons ou des crédits de génération par niveau de plan
• Services API : Allouer des crédits d’appel API avec des tarifs de dépassement
• Plateformes d’infrastructure : Émettre des heures de calcul ou des crédits de stockage
• Services de communication : Fournir des crédits de message ou de minute par abonnement
• SaaS avec niveaux de consommation : Regrouper l’utilisation incluse dans des pools de crédits

​

Concepts principaux

​

Types de crédits

​

Cycle de vie des crédits

​

Sources d’octroi

​

Création de crédits

1

Navigate to Credits

Accédez à Produits dans votre tableau de bord et sélectionnez l’onglet Crédits. Cliquez sur Créer un crédit pour commencer.

2

Configure Basic Information

Saisissez un Credit Name — il s’agit de votre identifiant interne pour le crédit.

3

Set General Settings

Configurez le type de crédit et les propriétés d’affichage :

​

Credit Type

string

requis

Choisissez Unité Personnalisée ou Crédits Fiat.

• Custom Unit : définissez votre propre métrique (tokens, appels API, heures de calcul). Nécessite un Unit Name (par exemple, “Platform tokens”) et un paramètre Precision.
• Fiat Credits : les crédits représentent une valeur monétaire réelle. Nécessite la sélection d’une Unit Currency (USD, EUR, GBP, INR, etc.).

​

Unit Name

string

Uniquement pour les crédits Custom Unit. Libellé affiché aux clients pour ce crédit (par exemple, “AI Tokens” ou “API Calls”). Affiché lors du checkout et dans le Customer Portal.

​

Precision

number

Uniquement pour les crédits d’unité personnalisée. Nombre de décimales autorisées, de 0 à 10 :

• 0 : nombres entiers (recommandé pour les éléments dénombrables comme les appels API)
• 1 : une décimale (0.0)
• 2 : deux décimales (0.00) — valeur par défaut
• 3 : trois décimales (0.000)
• Jusqu’à 10 : pour les unités de haute précision (par exemple, les tokens fractionnaires ou la micro-utilisation)

La précision ne peut pas être modifiée après la création du crédit.

​

Credit Expiry

string

Durée de validité des crédits après émission :

• 7 jours, 30 jours (par défaut), 60 jours, 90 jours, Personnalisé, ou Jamais

Sélectionnez Personnalisé pour spécifier un nombre de jours personnalisé (minimum 1).

4

Configure Subscription Settings (Optional)

Ces réglages contrôlent le comportement des crédits dans le cadre des abonnements récurrents :

​

Rollover

boolean

Permettre aux crédits inutilisés d’être reportés au prochain cycle de facturation. Lorsque activé, configurez :

• Max Rollover Percentage (0–100 %) : limite la quantité reportée
• Rollover Timeframe : durée de validité des crédits reportés (par exemple, 1 Month)
• Max Rollover Count : nombre maximal de reports consécutifs avant la perte des crédits

Lorsque les crédits s’épuisent ou que l’abonnement expire :

​

Allow Overage

boolean

Laissez les clients continuer à utiliser votre service après que leur solde de crédit atteigne zéro. Lorsque activé, configurez :

• Overage Limit : nombre maximal de crédits que les clients peuvent consommer au-delà de leur solde
• Price Per Unit : coût de chaque crédit supplémentaire lorsque le dépassement est activé (avec sélecteur de devise)

​

Overage Behavior

string

requis

Contrôle la façon dont le dépassement est géré à la fin du cycle de facturation :

• Forgive overage at reset (par défaut) : l’utilisation au-delà de la limite de crédits est suivie, mais non facturée. Le solde est réinitialisé à chaque cycle.
• Bill overage at billing : l’utilisation au-delà de la limite de crédits est facturée sur la prochaine facture, puis le solde est réinitialisé.
• Carry over deficit : l’utilisation au-delà de la limite de crédits est reportée sous forme de solde négatif au cycle suivant.
• Carry over deficit (auto-repay) : le déficit est reporté et automatiquement remboursé par les nouveaux crédits du cycle suivant.

5

Create Credit

Cliquez sur Créer un Crédit pour enregistrer. Le crédit est maintenant disponible pour être attaché à n’importe quel produit.

Votre droit de crédit est prêt. Attachez-le aux produits pour commencer à émettre des crédits aux clients.

​

Attacher des crédits aux produits

​

Produits d’abonnement

1

Create or Edit a Subscription Product

Accédez à Produits → Créer Produit ou modifiez un produit existant. Sélectionnez Abonnement comme type de tarification et configurez votre tarif récurrent.

2

Open Entitlements Section

Développez la section Droits et cliquez sur le bouton Attacher à côté de Crédits.

3

Select Credits to Attach

Un panneau Ajouter des Crédits s’ouvre. Vous pouvez sélectionner un crédit existant dans le menu déroulant ou cliquer sur Créer un nouveau crédit pour en définir un sur-le-champ.

Vous pouvez attacher jusqu’à 5 crédits par produit. Chaque crédit peut avoir sa propre configuration.

4

Configure Credit Settings

Pour chaque crédit attaché, configurez :

​

Credits issued per billing cycle

number

requis

Le nombre de crédits accordés au client chaque période de facturation.

​

Low Balance Threshold

number

Envoyez une notification lorsque le solde passe sous ce pourcentage (0–100). Utile pour alerter les clients avant qu’ils ne soient à court.

​

Credits During Free Trial

number

Définir un montant de crédit différent pour les périodes d’essai. Activer Expire les crédits d’essai après la fin de l’essai pour révoquer les crédits d’essai inutilisés lorsque l’essai se convertit en abonnement payant.

​

Allow Proration

boolean

Prorater les crédits restants lorsqu’un client met à niveau ou rétrograde son plan d’abonnement.

​

Import Default Credit Settings

boolean

Utilisez les paramètres par défaut de report, de dépassement et d’expiration du droit de crédit. Désactivez pour personnaliser les paramètres spécifiquement pour ce produit.

5

Review and Add

Passez en revue le crédit attaché affichant le nom, le montant et l’expiration. Cliquez sur Ajouter à l’abonnement pour confirmer.

​

Produits de paiement unique

1

Create a One-Time Product

Créez un produit avec un type de tarification Paiement Unique.

2

Attach Credits

Ouvrez la section Droits et attachez les crédits. Configurez le nombre de crédits émis (octroi total unique) à l’achat.

​

Produits de facturation basés sur l’utilisation

1

Create a Usage-Based Product

Sélectionnez Facturation Basée sur l’Utilisation comme type de tarification. Configurez le prix de base et la fréquence de facturation.

2

Add a Meter

Cliquez sur le bouton + dans la section Select meter pour ajouter un meter. Un abonnement peut comporter jusqu’à 50 meters.

3

Enable Credit Billing on the Meter

Activez Facturer l’utilisation en Crédits pour attacher un crédit au compteur. Sélectionnez le droit de crédit dans le menu déroulant.

​

Free Threshold

number

S’applique uniquement lorsque le meter facture en argent. Lorsque le meter facture en crédits, chaque unité est déduite du solde de crédits.

​

Bill usage in Credits

boolean

Lorsqu’il est activé, l’utilisation du compteur déduit du solde de crédit du client au lieu de facturer par unité.

​

Meter units per credit

number

requis

Le nombre d’unités d’utilisation requis pour déduire 1 crédit. Par exemple, si défini à 1000, alors 1 000 appels API consomment 1 crédit.

4

Configure Credit Issuance

Définissez le nombre de crédits émis et éventuellement personnaliser les paramètres de crédit pour ce produit.

5

Verify Attachment

Une fois configuré, le compteur montre le nom du crédit attaché, le prix unitaire et le seuil gratuit.

​

Paramètres des crédits

​

Report

​

Dépassement

​

Expiration

​

Facturation basée sur l’utilisation avec des crédits

​

Fonctionnement de la déduction de crédits basée sur les meters

1. Votre application envoie des événements d’utilisation : chaque événement comprend un identifiant client, un nom d’événement et des métadonnées
2. Les meters agrègent les événements : à l’aide des agrégations Count, Sum, Max ou Last
3. Les crédits sont déduits automatiquement : un worker en arrière-plan traite les événements toutes les minutes, convertit les unités des meters en crédits selon votre taux configuré et déduit les montants du solde du client selon l’ordre FIFO (grants expirant le plus tôt en premier)
4. Le dépassement est suivi : si le solde de crédits atteint zéro et que le dépassement est activé, le système suit l’utilisation en dépassement pour la facturation de fin de cycle

​

Panneau Meters

​

Expérience client

​

Checkout

​

Customer Portal

• Available Balance : solde actuel de crédits affiché bien en évidence
• Credit Tabs : permet de passer d’un type de crédit à l’autre (par exemple, “OpenAI Credits” ou “Usage Tokens”)
• Recent Transactions : historique complet avec date, identifiant de transaction, type, montant et solde cumulé

​

Détails de l’abonnement

• Credit allocation par cycle de facturation (par exemple, “1000 credits each cycle”)
• Remaining balance (par exemple, “7500 credits remaining”)
• Renewal date de la prochaine émission de crédits
• Onglet Usage History avec une ventilation par meter indiquant les unités consommées, les seuils, les prix unitaires et les coûts totaux

​

Détails de la transaction

​

Gestion des crédits

​

Vues du tableau de bord

​

Liste des droits à crédits

​

Détails des crédits d’un client

• Credit Selector - permet de passer d’un droit à crédits à l’autre
• Available Balance - solde actuel affiché en grand et bien en évidence
• Apply Credit/Debit - bouton permettant d’ajuster manuellement le solde du client
• Recent Transactions - ledger complet avec date, identifiant de transaction, type, montant et solde cumulé

​

Ajustements manuels

​

Ledger des crédits

​

Webhooks

​

Gestion de l’API

​

Exemple d’intégration

import DodoPayments from 'dodopayments';

const client = new DodoPayments({
  bearerToken: process.env['DODO_PAYMENTS_API_KEY'],
  environment: 'test_mode', // defaults to 'live_mode'
});

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

await client.usageEvents.ingest({
  events: [{
    event_id: `gen_${Date.now()}`,
    customer_id: 'cus_abc123',
    event_name: 'ai.generation',
    timestamp: new Date().toISOString(),
    metadata: { model: 'gpt-4', tokens: 1500 }
  }]
});

​

Exemples concrets

​

Bonnes pratiques

• Commencez simplement : débutez avec un seul type de crédit et sans rollover. Ajoutez de la complexité en fonction des retours clients et des habitudes d’utilisation.
• Définissez des attentes claires : affichez clairement les allocations de crédits, les soldes restants et les tarifs de dépassement sur vos pages produit et dans votre Customer Portal.
• Utilisez des unités pertinentes : nommez les crédits d’après ce qu’ils représentent (par exemple, “API Calls” ou “AI Tokens”) plutôt que d’utiliser des termes génériques. Cela aide les clients à comprendre leur valeur.
• Configurez l’expiration avec discernement : les périodes d’expiration courtes (7 jours) créent un sentiment d’urgence, mais peuvent frustrer les clients. Les périodes plus longues (30 à 90 jours) sont plus adaptées aux clients pour la plupart des produits SaaS.
• Surveillez les soldes faibles : définissez des seuils de solde faible pour avertir les clients avant qu’ils ne soient à court de crédits, réduisant ainsi les frais de dépassement inattendus.
• Testez en mode test : créez des crédits, associez-les à des produits de test et simulez tout le cycle achat → utilisation → déduction → expiration avant la mise en production.