Transformez les événements d’utilisation bruts en quantités facturables grâce à l’agrégation et au filtrage.
Les compteurs convertissent les événements bruts en quantités facturables. Ils filtrent les événements et appliquent des fonctions d’agrégation (Count, Sum, Max, Last) pour calculer l’utilisation par client.
Le libellé de l’unité pour les factures et les rapports. Exemples : calls, tokens, GB, hours.
3
Filtering (Optional)
Ajoutez des conditions pour filtrer les événements comptés :
Logique ET : Toutes les conditions doivent correspondre
Logique OU : Toute condition peut correspondre
Comparateurs disponibles : égal à, différent de, supérieur à, supérieur ou égal à, inférieur à, inférieur ou égal à, contient, ne contient pas.Activez le filtrage, choisissez votre logique, puis ajoutez des conditions avec une clé de propriété, un comparateur et une valeur.
4
Create
Vérifiez votre configuration et cliquez sur Create Meter.
Par défaut, les compteurs facturent les clients à l’unité en dollars (ou dans la devise configurée). Vous pouvez également configurer un compteur pour déduire l’utilisation du solde de crédits d’un client, afin que l’utilisation consomme des crédits au lieu de générer des frais monétaires.
La déduction basée sur les crédits nécessite un Credit Entitlement associé au même produit. Créez d’abord le credit entitlement, puis associez-le au compteur.
Commencez par créer un credit entitlement dans Products → Credits. Définissez l’unité (par ex. « API Calls », « Tokens »), la précision et les paramètres du cycle de vie (expiration, report, dépassement).Consultez le guide de facturation basée sur les crédits pour des instructions détaillées.
2
Create or Edit a Usage-Based Product
Accédez à votre produit basé sur l’utilisation et ouvrez la section de configuration du compteur.
3
Add a Meter
Cliquez sur le bouton + pour joindre un compteur. Configurez comme d’habitude le nom de l’événement, le type d’agrégation et l’unité de mesure.
4
Enable 'Bill Usage in Credits'
Activez Bill usage in Credits dans la configuration du compteur pour afficher les paramètres des crédits :
Toggle 'Bill usage in Credits' to switch from currency-based to credit-based deduction.
Le nombre d’unités d’utilisation requis pour déduire 1 crédit. Par exemple :
1 = chaque événement de compteur déduit 1 crédit
100 = 100 événements de compteur déduisent 1 crédit
1000 = 1 000 appels API consomment 1 crédit
5
Free Threshold and Credits
Le Free Threshold s’applique aux compteurs facturés en argent, et non aux compteurs facturés en crédits. Lorsqu’un compteur facture en crédits, chaque unité est comptabilisée pour la déduction de crédits.Exemple : avec un ratio de 1 unité de compteur par crédit, un client qui effectue 2 500 appels API voit 2 500 crédits déduits.
Une fois configuré, le flux de déduction s’exécute automatiquement :
Les événements arrivent — Votre application envoie les événements d’utilisation via l’Event Ingestion API.
Le compteur agrège — Les événements sont agrégés selon la configuration de votre compteur (Count, Sum, Max, Last).
Le worker en arrière-plan traite — Chaque minute, un worker récupère les nouveaux événements depuis le dernier point de contrôle.
Les crédits sont déduits — L’utilisation agrégée est convertie en crédits selon le taux meter_units_per_credit et déduite selon l’ordre FIFO (les attributions dont l’expiration est la plus proche sont consommées en premier).
Le dépassement est suivi — Si le solde atteint zéro, l’utilisation supplémentaire est enregistrée comme un dépassement et traitée selon le comportement configuré (abandonnée lors de la réinitialisation, facturée sur la facture suivante ou reportée comme déficit). Dodo Payments ne bloque pas l’utilisation lorsque le solde est épuisé. Pour arrêter l’accès lorsque le solde atteint zéro, vérifiez le solde dans votre application.
La déduction des crédits s’exécute de manière asynchrone (environ toutes les minutes). Un bref délai peut s’écouler entre l’ingestion de l’événement et la déduction du solde. Concevez votre application pour gérer ce délai et ne vous fiez pas aux vérifications du solde en temps réel pour contrôler l’accès lors de requêtes individuelles.
Vous pouvez associer plusieurs compteurs d’un même produit au même credit entitlement. Tous les compteurs déduisent les crédits d’un solde partagé.Exemple : une plateforme d’IA avec deux compteurs :
text.generation — 1 crédit pour 1 000 jetons
image.generation — 10 crédits par image
Les deux déduisent de la même réserve « Crédits IA ». Le client voit un solde unifié dans son portail.
Utilisez des taux meter_units_per_credit différents selon les compteurs pour exprimer des coûts relatifs. Les opérations coûteuses (génération d’images) consomment moins d’unités de compteur par crédit que les opérations bon marché (complétion de texte).
List Customer Ledger
Affichez l’historique complet de déduction de crédits d’un client.
Get Customer Balance
Vérifiez le solde de crédits actuel d’un client via l’API.
