> ## Documentation Index
> Fetch the complete documentation index at: https://docs.dodopayments.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Credit-Based Billing
> Issue, manage, and track credit entitlements across subscriptions, one-time products, and usage-based billing with rollover, overage, and expiration controls.
La facturation basée sur le crédit vous permet d'accorder aux clients un solde de crédits - appels API, jetons, unités de calcul ou toute métrique personnalisée - et de déduire de ce solde à mesure qu'ils consomment votre service. Les crédits fonctionnent pour tous les types de produits : abonnements, achats uniques et facturation basée sur l'utilisation.
## Qu'est-ce que la facturation basée sur le crédit ?
La facturation basée sur le crédit vous offre un système flexible pour émettre des droits de crédit aux clients dans le cadre de vos produits. Au lieu de facturer par utilisation ou de limiter l'accès via des drapeaux de fonctionnalité, vous attribuez un pool de crédits dont les clients se servent en utilisant votre service.
Les crédits sont idéaux pour :
* **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
Lors de la création d'un crédit, vous choisissez entre deux types :
Définissez les crédits dans votre propre unité - jetons, appels API, heures de calcul ou toute métrique significative pour votre produit. Les unités personnalisées utilisent la précision que vous avez définie (0 à 3 décimales).
**Idéal pour** : appels API, jetons AI, heures de calcul, unités de stockage, messages
Les crédits représentent une valeur monétaire réelle (par exemple, USD, EUR). Les clients reçoivent un solde de crédit monétaire qui diminue à mesure qu'ils utilisent votre service au tarif que vous avez défini.
**Idéal pour** : soldes prépayés, crédits promotionnels, compensation de service
### Cycle de vie des crédits
Les crédits suivent un cycle de vie clair de leur émission à leur consommation :
Les crédits sont accordés lorsqu'un client achète un produit (abonnement ou achat unique) avec des droits de crédit attachés. Pour les abonnements, les crédits sont réémis à chaque cycle de facturation.
À mesure que les clients utilisent votre service, les crédits sont déduits. Pour les produits basés sur l'utilisation, des compteurs déduisent automatiquement les crédits en fonction des événements en temps réel. Vous pouvez également déduire les crédits manuellement via le tableau de bord ou l'API.
À la fin du cycle de facturation (ou après la période d'expiration configurée), les crédits inutilisés expirent ou sont reportés à la période suivante en fonction de vos paramètres.
Si les crédits s'épuisent en milieu de cycle, vous pouvez autoriser un dépassement (utilisation continue au-delà du solde) et choisir comment il est traité - le pardonner, le facturer ou reporter le déficit.
### Sources d'octroi
Les crédits peuvent être accordés à partir de plusieurs sources :
| Source | Description |
| ---------------- | ----------------------------------------------------------------------------- |
| **Abonnement** | Crédits émis avec l'achat d'un abonnement, réémis chaque cycle de facturation |
| **Achat unique** | Crédits émis avec un produit de paiement unique |
| **API** | Crédits accordés manuellement via API ou tableau de bord |
| **Report** | Crédits reportés d'un cycle de facturation précédent |
***
## Création de crédits
Créez des droits de crédit dans la section **Produits → Crédits** de votre tableau de bord. Chaque crédit définit l'unité, la précision, les règles d'expiration et le comportement de cycle de vie.
Accédez à **Produits** dans votre tableau de bord et sélectionnez l'onglet **Crédits**. Cliquez sur **Créer un crédit** pour commencer.
Entrez un **Nom de Crédit** - il s'agit de votre identifiant interne pour le crédit.
Configurez le type de crédit et les propriétés d'affichage :
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.).
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.
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.
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).
Ces réglages contrôlent le comportement des crédits dans le cadre des abonnements récurrents :
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 :**
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)
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.
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.
Commencez avec des paramètres simples - pas de report, pas de dépassement - et ajoutez de la complexité à mesure que vous apprenez comment les clients utilisent les crédits. La plupart des paramètres peuvent être mis à jour à tout moment sans affecter les droits existants. Notez que **la précision ne peut pas être modifiée** après la création d'un crédit.
***
## Attacher des crédits aux produits
Les crédits sont attachés aux produits en tant que **droits** dans le flux de création ou de modification de produit. Vous pouvez attacher jusqu'à **5 crédits par produit**. Les crédits fonctionnent avec les trois types de tarification.
### Produits d'abonnement
Pour les abonnements, les crédits sont émis **par cycle de facturation** et peuvent être configurés avec proration, crédits d'essai et paramètres spécifiques au cycle.
Accédez à **Produits → Créer Produit** ou modifiez un produit existant. Sélectionnez **Abonnement** comme type de tarification et configurez votre tarif récurrent.
Développez la section **Droits** et cliquez sur le bouton **Attacher** à côté de **Crédits**.
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.
Pour chaque crédit attaché, configurez :
Le nombre de crédits accordés au client chaque période de facturation.
Notifier lorsque les crédits tombent en dessous de ce montant. Utile pour alerter les clients avant qu'ils ne soient à court.
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.
Prorater les crédits restants lorsqu'un client met à niveau ou rétrograde son plan d'abonnement.
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.
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
Pour les paiements uniques, les crédits sont émis **une seule fois** au moment de l'achat.
Créez un produit avec un type de tarification **Paiement Unique**.
Ouvrez la section **Droits** et attachez les crédits. Configurez le **nombre de crédits émis** (octroi total unique) à l'achat.
Les produits de crédit unique sont idéaux pour les packs de rechargement de crédits, les lots promotionnels, ou les achats de crédits prépayés.
### Produits de facturation basés sur l'utilisation
Pour les produits basés sur l'utilisation, les crédits sont **liés aux compteurs** et automatiquement déduits en fonction des événements de consommation en temps réel.
Sélectionnez **Facturation Basée sur l'Utilisation** comme type de tarification. Configurez le prix de base et la fréquence de facturation.
Cliquez sur le bouton **+** dans la section **Sélectionner le compteur** pour ajouter un compteur. Un abonnement peut avoir jusqu'à **3 compteurs**.
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.
Le nombre d'unités qui sont gratuites avant que la déduction de crédit ne commence.
Lorsqu'il est activé, l'utilisation du compteur déduit du solde de crédit du client au lieu de facturer par unité.
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.
Définissez le nombre de crédits émis et éventuellement personnaliser les paramètres de crédit pour ce produit.
Une fois configuré, le compteur montre le nom du crédit attaché, le prix unitaire et le seuil gratuit.
Lorsque les crédits sont liés aux compteurs, le système déduit automatiquement les crédits en fonction des événements d'utilisation ingérés. Un travailleur en arrière-plan traite les événements chaque minute, les agrège selon la configuration du compteur, et applique une déduction FIFO (premier entré, premier sorti) à partir des subventions non expirées les plus anciennes du client.
***
## Paramètres des crédits
### Report
Le report permet aux crédits inutilisés de se reporter au cycle de facturation suivant au lieu d'expirer.
| Réglage | Description |
| ------------------------------- | --------------------------------------------------------------------------------------------------------------------------------- |
| **Report Activé** | Basculer pour autoriser les crédits inutilisés à être reportés |
| **Pourcentage de Report Max** | Limitez combien est reporté (0 à 100%). À 50%, seulement la moitié des crédits inutilisés est reportée |
| **Durée de Validité du Report** | Durée de validité des crédits reportés (jour, semaine, mois, an) |
| **Nombre Max de Reports** | Nombre maximum de fois où les crédits peuvent être reportés consécutivement. Après cette limite, les crédits restants sont perdus |
**Exemple** : Un client a 200 crédits inutilisés à la fin du cycle. Avec 75% de report, 150 crédits sont reportés et 50 sont perdus.
### Dépassement
Le dépassement contrôle ce qui se passe lorsque le solde de crédit d'un client atteint zéro en milieu de cycle.
| Réglage | Description |
| ------------------------------- | ------------------------------------------------------------------------------------------------- |
| **Autoriser le Dépassement** | Basculer pour laisser les clients continuer à utiliser le service au-delà de leur solde de crédit |
| **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 consommé en tant que dépassement (avec devise) |
| **Comportement du Dépassement** | Contrôle ce qui arrive au dépassement à la fin du cycle de facturation (voir ci-dessous) |
**Options de Comportement du Dépassement :**
| Comportement | Description |
| --------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------- |
| **Pardonner le dépassement à la réinitialisation** | 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** | Le dépassement est reporté 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 |
Lorsque le dépassement est désactivé, les clients ne peuvent plus utiliser le service une fois que leur solde de crédit atteint zéro. Choisissez un comportement de dépassement qui correspond à votre modèle de facturation - **Pardonner à la réinitialisation** est l'option par défaut et la plus simple.
### Expiration
| Réglage | Description |
| ------------------------------------------------ | -------------------------------------------------------------------------------------------------- |
| **Expiration des Crédits** | Durée après émission avant que les crédits expirent (7, 30, 60, 90, jours personnalisés ou jamais) |
| **Expiration des Crédits d'Essai Après l'Essai** | Si les crédits spécifiques à l'essai expirent lorsque la période d'essai se termine |
Les crédits expirés créent une entrée de registre `CreditExpired`. Si le report est activé, le pourcentage de report est appliqué avant l'expiration, et seul le reste expire.
***
## Facturation à l'utilisation avec des crédits
Lorsque les crédits sont liés aux compteurs d'utilisation, le système crée un modèle de facturation basé sur la consommation puissant. Les clients reçoivent une allocation de crédits, et les événements d'utilisation déduisent automatiquement de leur solde.
### 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
Le tableau de bord de facturation à l'utilisation inclut un panneau **Compteurs** listant tous les compteurs définis avec leur type d'agrégation :
| Agrégation | Description | Exemple |
| ---------- | --------------------------------- | ----------------------------------------- |
| **Count** | Nombre total d'événements | Appels API |
| **Sum** | Somme d'un champ de valeur | Total des octets transférés |
| **Max** | Valeur la plus élevée enregistrée | Nombre maximal d'utilisateurs concurrents |
| **Last** | Valeur la plus récente | Stockage actuel utilisé |
***
## Expérience client
### Caisse
Lorsqu'un client achète un produit avec des crédits attachés, la page de caisse affiche les crédits inclus comme partie de l'offre du produit.
Les crédits apparaissent dans une section **Inclus** sous la description du produit, montrant le montant et le type de crédit (par exemple, "1000 \$ d'appels API").
### Portail client
Les clients peuvent voir et gérer leurs soldes de crédits dans le Portail Client sous la section **Crédits**.
Le portail affiche :
* **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
Les types de transaction montrés aux clients incluent :
| Type | Description | Montant |
| --------------------------- | -------------------------------------------------------------- | --------- |
| **Crédits avec Abonnement** | Crédits émis avec l'achat/renouvellement d'abonnement | Vert (+) |
| **Crédits Uniques** | Crédits provenant d'achats uniques ou de subventions manuelles | Vert (+) |
| **Déduction d'Utilisation** | Crédits consommés via l'utilisation du service | Rouge (-) |
| **Dépassement** | Utilisation au-delà du solde de crédit | Rouge (-) |
### Détails de l'abonnement
La page des détails de l'abonnement montre les droits de crédit à côté d'autres informations du plan.
Informations clés affichées :
* **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
Les pages des transactions de paiement incluent une section **Droits** montrant tous les droits délivrés avec le paiement, y compris les crédits.
***
## Gestion des crédits
### Vues du tableau de bord
#### Liste des droits de crédit
Voir tous vos droits de crédit dans **Produits → Crédits**. Le tableau montre le nom du crédit, les paramètres d'expiration et fournit des actions rapides pour éditer ou archiver.
#### Détails des crédits du client
Consultez les soldes de crédits et l'historique des transactions d'un client spécifique depuis **Clients → \[Nom du client] → Crédits**.
La vue des crédits du client inclut :
* **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
Vous pouvez créditer ou débiter manuellement le solde d'un client directement depuis le tableau de bord :
Allez dans **Clients** et sélectionnez le client.
Cliquez sur l'onglet **Crédits** et sélectionnez le droit de crédit approprié dans le sélecteur de portefeuille.
Cliquez sur **Appliquer Crédit/Débit** pour ouvrir l'interface d'ajustement.
Sélectionnez **Crédit** pour ajouter des crédits ou **Débit** pour retirer des crédits du solde du client.
Le nombre de crédits à ajouter ou retirer.
Explication optionnelle pour l'ajustement (par exemple, "Compensation de service", "Bonus promotionnel").
Passez en revue et appliquez l'ajustement. Le changement est immédiatement reflété dans le solde du client et enregistré dans le registre des crédits.
Les ajustements manuels créent une entrée de registre `ManualAdjustment` avec piste de vérification complète.
### Registre des Crédits
Chaque opération de crédit est enregistrée dans le registre des crédits, fournissant une piste d'audit complète :
| Type de Transaction | Description |
| ------------------------ | ------------------------------------------------------------------- |
| **Crédit Ajouté** | Crédits accordés (abonnement, paiement unique ou API) |
| **Crédit Déduit** | Crédits consommés par utilisation ou débit manuel |
| **Crédit Expiré** | Crédits expirés sans report |
| **Crédit Reporté** | Crédits reportés à la période suivante |
| **Report Perdu** | Crédits reportés perdus après la limite maximale de report atteinte |
| **Dépassement Facturé** | Utilisation au-delà du solde de crédit avec dépassement activé |
| **Recharge Automatique** | Renouvellement automatique du crédit à bas solde |
| **Ajustement Manuel** | Crédit ou débit appliqué manuellement par le marchand |
| **Remboursement** | Crédits remboursés |
Chaque entrée de registre enregistre le solde avant et après la transaction, le dépassement avant et après, une description et une référence à la source (paiement, abonnement, etc.).
***
## Webhooks
La facturation basée sur le crédit déclenche des événements webhook pour chaque changement de cycle de vie de crédit. Utilisez-les pour synchroniser votre application avec les soldes de crédits, déclencher des notifications, ou construire des workflows de facturation personnalisés.
| Événement | Description |
| --------------------------- | ------------------------------------------------- |
| `credit.added` | Crédits accordés à un client |
| `credit.deducted` | Crédits consommés par utilisation ou débit manuel |
| `credit.expired` | Crédits inutilisés expirés |
| `credit.rolled_over` | Crédits reportés à une nouvelle subvention |
| `credit.rollover_forfeited` | Crédits perdus à la limite maximale de report |
| `credit.overage_charged` | Charges de dépassement appliquées |
| `credit.manual_adjustment` | Ajustement manuel de crédit/débit réalisée |
| `credit.balance_low` | Solde tombé en dessous du seuil configuré |
Tous les événements du grand livre (`credit.added` à `credit.manual_adjustment`) comprennent la charge utile complète `CreditLedgerEntry` avec le solde avant/après, le surplus avant/après, la référence de la source, et le `metadata` de la souscription ou du paiement source de la subvention (vide pour les subventions créées directement via l'API). L'événement `credit.balance_low` inclut la configuration du seuil et le solde actuel.
Voir les schémas de charge utile complets, les descriptions de champ, et des exemples d'intégration pour tous les événements webhook de crédit.
***
## Gestion API
Utilisez l'API pour créer des droits de crédit de manière programmatique avec un contrôle total sur les paramètres de report, de dépassement, et d'expiration.
Créez un nouveau droit de crédit avec configuration de report, de dépassement, et d'expiration.
Récupérez tous les droits de crédit pour votre entreprise.
Récupérez, mettez à jour, ou supprimez des droits de crédits. Les droits supprimés peuvent être restaurés.
Récupérez un droit de crédit spécifique par ID.
Mettez à jour le report, le dépassement, l'expiration, ou d'autres paramètres.
Supprimez un droit de crédit en douceur.
Restaurez un droit de crédit supprimé précédemment.
Accordez des crédits directement au solde d'un client sans nécessiter un achat, ou créez des entrées de débit manual pour des ajustements de facturation.
Créditez ou débitez le solde d'un client avec une piste d'audit complète et un support d'idempotence.
Récupérez le solde de crédit actuel d'un client, l'historique des subventions, et le registre complet des transactions pour tout droit de crédit.
Listez tous les soldes de clients pour un droit de crédit.
Obtenez le solde d'un client spécifique.
Voir toutes les subventions de crédit pour un client.
Historique complet des transactions pour un client.
### Exemple d'intégration
Initialisez le client Dodo Payments :
```typescript theme={null}
import DodoPayments from 'dodopayments';
const client = new DodoPayments({
bearerToken: process.env['DODO_PAYMENTS_API_KEY'],
environment: 'test_mode', // defaults to 'live_mode'
});
```
Attachez des crédits à un produit d'abonnement pendant la caisse :
```typescript theme={null}
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'
});
```
Envoyez des événements d'utilisation qui déduisent automatiquement des crédits :
```typescript theme={null}
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
**Structure tarifaire :**
| Plan | Prix | Crédits/Mois | Dépassement |
| ---------- | ----------- | ---------------- | -------------- |
| Démarrage | 29 \$/mois | 10 000 jetons | 0,003 \$/jeton |
| Pro | 99 \$/mois | 100 000 jetons | 0,002 \$/jeton |
| Entreprise | 499 \$/mois | 1 000 000 jetons | 0,001 \$/jeton |
**Configuration :**
* Type de Crédit : Unité Personnalisée ("Jetons AI")
* Précision : 0 (jetons entiers)
* Report : 25% max, durée de 1 mois
* Dépassement : Activé, facturer le dépassement à la facturation
* Compteur : `ai.generation` avec agrégation de somme sur le champ `tokens`
**Structure tarifaire :**
| Plan | Prix | Crédits/Mois | Dépassement |
| ----------- | ---------- | -------------- | --------------- |
| Gratuit | 0 \$/mois | 1 000 appels | Bloqué |
| Développeur | 19 \$/mois | 50 000 appels | 0,001 \$/appel |
| Business | 99 \$/mois | 500 000 appels | 0,0005 \$/appel |
**Configuration :**
* Type de Crédit : Unité Personnalisée ("Appels API")
* Précision : 0 (appels entiers)
* Report : Désactivé
* Dépassement : Plans Développeur+ permettent le dépassement (pardon à la réinitialisation), plan Gratuit désactive le dépassement
* Compteur : `api.request` avec agrégation de nombre
**Structure tarifaire :**
| Plan | Prix | Crédits/Mois | Dépassement |
| --------- | ---------- | --------------- | ---------------- |
| Personnel | 9 \$/mois | 100 heures-GB | 0,05 \$/heure-GB |
| Équipe | 49 \$/mois | 1 000 heures-GB | 0,03 \$/heure-GB |
**Configuration :**
* Type de Crédit : Unité Personnalisée ("heures-GB")
* Précision : 2 (deux décimales)
* Report : 50% max, reporte une fois
* Dépassement : Activé avec limite de 200%
* Compteur : `storage.usage` avec agrégation de somme
***
## 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.
La facturation basée sur le crédit fonctionne de manière transparente avec toutes les autres fonctionnalités de Dodo Payments - abonnements avec essais, changements de plan avec proration, et le portail client. Commencez avec une configuration de base et développez à mesure que votre modèle de tarification évolue.
## Concepts principaux
### Types de crédits
Lors de la création d'un crédit, vous choisissez entre deux types :
### 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
Le tableau de bord de facturation à l'utilisation inclut un panneau **Compteurs** listant tous les compteurs définis avec leur type d'agrégation :
| Agrégation | Description | Exemple |
| ---------- | --------------------------------- | ----------------------------------------- |
| **Count** | Nombre total d'événements | Appels API |
| **Sum** | Somme d'un champ de valeur | Total des octets transférés |
| **Max** | Valeur la plus élevée enregistrée | Nombre maximal d'utilisateurs concurrents |
| **Last** | Valeur la plus récente | Stockage actuel utilisé |
***
## Expérience client
### Caisse
Lorsqu'un client achète un produit avec des crédits attachés, la page de caisse affiche les crédits inclus comme partie de l'offre du produit.
Le portail affiche :
* **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
Les types de transaction montrés aux clients incluent :
| Type | Description | Montant |
| --------------------------- | -------------------------------------------------------------- | --------- |
| **Crédits avec Abonnement** | Crédits émis avec l'achat/renouvellement d'abonnement | Vert (+) |
| **Crédits Uniques** | Crédits provenant d'achats uniques ou de subventions manuelles | Vert (+) |
| **Déduction d'Utilisation** | Crédits consommés via l'utilisation du service | Rouge (-) |
| **Dépassement** | Utilisation au-delà du solde de crédit | Rouge (-) |
### Détails de l'abonnement
La page des détails de l'abonnement montre les droits de crédit à côté d'autres informations du plan.
Informations clés affichées :
* **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
Les pages des transactions de paiement incluent une section **Droits** montrant tous les droits délivrés avec le paiement, y compris les crédits.
***
## Gestion des crédits
### Vues du tableau de bord
#### Liste des droits de crédit
Voir tous vos droits de crédit dans **Produits → Crédits**. Le tableau montre le nom du crédit, les paramètres d'expiration et fournit des actions rapides pour éditer ou archiver.
La vue des crédits du client inclut :
* **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
Vous pouvez créditer ou débiter manuellement le solde d'un client directement depuis le tableau de bord :