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

Entrez un Nom de Crédit - 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.

• Unité Personnalisée - Définissez votre propre métrique (jetons, appels API, heures de calcul). Nécessite un Nom d’Unité (par exemple, “Jetons plateforme”) et un réglage de Précision.
• Crédits Fiat - Les crédits représentent une valeur monétaire réelle. Nécessite une sélection de Devise Unitaire (USD, EUR, GBP, INR, etc.).

​

Unit Name

string

Uniquement pour les crédits d’Unité Personnalisée. L’étiquette que les clients voient pour ce crédit (par exemple, “Jetons AI”, “Appels API”). Affiché à la caisse et dans le portail client.

​

Precision

number

Uniquement pour les crédits d’Unité Personnalisée. Nombre de décimales autorisées :

• 0 - Nombres entiers (idéal pour les éléments comptables comme les appels API)
• 1 - Une décimale (0,0)
• 2 - Deux décimales (0,00) - par défaut
• 3 - Trois décimales (0,000)

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 :

• Pourcentage de Report Max (0 à 100%) - Limitez combien est reporté
• Durée de Validité du Report - Durée de validité des crédits reportés (par exemple, 1 Mois)
• Nombre Max de Reports - Nombre maximum de reports consécutifs avant que les crédits ne soient perdus

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 :

• Limite de Dépassement - Crédits maximum que les clients peuvent consommer au-delà de leur solde
• Prix par Unité - Coût par crédit supplémentaire lorsque le dépassement est activé (avec sélection de devise)

​

Overage Behavior

string

requis

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

• Pardonner le dépassement à la réinitialisation (par défaut) - L’utilisation au-delà de la limite de crédit est suivie mais non facturée. Le solde se réinitialise chaque cycle.
• Facturer le dépassement à la facturation - L’utilisation au-delà de la limite de crédit est facturée à la prochaine facture, puis le solde se réinitialise.
• Reporter le déficit - L’utilisation au-delà de la limite de crédit est reportée comme solde négatif dans le cycle suivant.
• Reporter le déficit (remboursement automatique) - Le déficit est reporté et remboursé automatiquement à partir de nouveaux crédits dans le 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

Notifier lorsque les crédits tombent en dessous de ce montant. 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 Sélectionner le compteur pour ajouter un compteur. Un abonnement peut avoir jusqu’à 3 compteurs.

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

requis

Le nombre d’unités qui sont gratuites avant que la déduction de crédit ne commence.

​

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 à l’utilisation avec des crédits

​

Comment fonctionne la déduction des crédits basée sur les compteurs

1. Votre application envoie des événements d’utilisation - Chaque événement comprend un ID client, un nom d’événement et des métadonnées
2. Les compteurs agrègent les événements - En utilisant l’agrégation Count, Sum, Max ou Last
3. Les crédits sont déduits automatiquement - Un travailleur en arrière-plan traite les événements chaque minute, convertit les unités de compteur en crédits en utilisant votre taux configuré, et déduit du solde du client en utilisant l’ordre FIFO (les plus anciens d’abord)
4. Le dépassement est suivi - Si le solde des crédits atteint zéro et que le dépassement est activé, le système suit l’utilisation du dépassement pour la facturation en fin de cycle

​

Panneau des compteurs

​

Expérience client

​

Caisse

​

Portail client

• Solde Disponible - Solde de crédit actuel affiché en évidence
• Onglets de Crédit - Basculer entre différents types de crédits (par exemple, “Crédits OpenAI”, “Jetons d’utilisation”)
• Transactions Récentes - Historique complet avec date, ID de transaction, type, montant et solde courant

​

Détails de l’abonnement

• Allocation de crédit par cycle de facturation (par exemple, “1000 crédits chaque cycle”)
• Solde restant (par exemple, “7500 crédits restants”)
• Date de renouvellement pour la prochaine émission de crédits
• Historique d’Utilisation avec récapitulatif par compteur montrant les unités consommées, les seuils, les prix unitaires et les coûts totaux

​

Détails des transactions

​

Gestion des crédits

​

Vues du tableau de bord

​

Liste des droits de crédit

​

Détails des crédits du client

• Sélecteur de Crédit - Basculer entre différents droits de crédit
• Solde Disponible - Solde actuel en grand affichage
• Appliquer Crédit/Débit - Bouton pour ajuster manuellement le solde du client
• Transactions Récentes - Registre complet avec date, ID de transaction, type, montant et solde courant

​

Ajustements manuels

​

Registre des Crédits

​

Webhooks

​

Gestion 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: 'prod_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 réels

​

Meilleures pratiques

• Commencez simple : Commencez avec un seul type de crédit et sans report. Ajoutez de la complexité en fonction des retours des clients et des modèles d’utilisation.
• Fixez des attentes claires : Affichez les allocations de crédits, les soldes restants, et la tarification de dépassement de manière visible sur vos pages de produit et votre portail client.
• Utilisez des unités significatives : Nommez les crédits d’après ce qu’ils représentent (par exemple, “Appels API”, “Jetons AI”) plutôt que des termes génériques. Cela aide les clients à comprendre la valeur.
• Configurez l’expiration de manière réfléchie : Les fenêtres d’expiration courtes (7 jours) incitent à l’urgence mais peuvent frustrer les clients. Les fenêtres plus longues (30 à 90 jours) sont plus conviviales pour la plupart des produits SaaS.
• Surveillez les faibles soldes : Définissez des seuils de solde faible pour alerter les clients avant qu’ils ne soient à court, réduisant ainsi les frais de dépassement surprise.
• Testez en mode test : Créez des crédits, attachez-les à des produits de test, et simulez le cycle complet d’achat → utilisation → déduction → expiration avant de passer en production.