Passer au contenu principal
La facturation basée sur l’usage vous permet de facturer les clients pour ce qu’ils utilisent réellement : appels API, stockage, jetons AI ou toute métrique que vous définissez. Les clients paient pour la consommation, pas pour des frais fixes.
Parfait pour : APIs, services d’IA, plateformes d’infrastructure et tout produit dont la valeur augmente avec l’utilisation.

​
Comment ça fonctionne

1

Send Usage Events

Your application sends events when billable actions occur.
{
  "event_id": "evt_123",
  "customer_id": "cus_abc",
  "event_name": "api.call",
  "metadata": { "endpoint": "/v1/users" }
}
2

Meters Aggregate Usage

Les compteurs agrègent les événements en quantités facturables via les agrégations Count, Sum, Max ou Last.
3

Automatic Billing

Définissez le prix par unité et les seuils gratuits. Les clients sont facturés automatiquement à chaque cycle.

​
Concepts Clés

​
Événements

Events represent usage actions in your application. Each event includes:
  • Event Name : Type d’utilisation (ex. api.call)
  • Customer ID : Qui l’a utilisé
  • Metadata : Propriétés supplémentaires pour l’agrégation

​
Compteurs

Les compteurs agrègent les événements en quantités facturables :
  • Compte : Total des événements (appels API)
  • Somme : Ajouter des valeurs (total des octets)
  • Max : Valeur la plus élevée (utilisateurs de pointe)
  • Dernier : Valeur la plus récente
Interface de création de compteur

​
Produits avec Tarification Basée sur l’Usage

Définissez le prix par unité et les seuils gratuits optionnels :
Configuration des prix
Exemple : 2 500 appels - 1 000 gratuits = 1 500 × 0,02 =30,00= 30,00

​
Déduction basée sur les crédits

Au lieu de facturer un prix unitaire en dollars, vous pouvez configurer les compteurs pour déduire du solde de crédits d’un client. Les crédits se renouvellent à chaque cycle de facturation et s’appliquent avant tout dépassement.

​
Démarrage Rapide

1

Create a Meter

Dans votre tableau de bord : Meters → Create Meter
  1. Définissez le nom de l’événement (ex. api.call)
  2. Choisissez l’agrégation (Count, Sum, Max, Last)
  3. Ajoutez des filtres optionnels
2

Add to Product

Associez le compteur à un produit avec tarification :
Ajout d'un compteur au produit
  1. Sélectionnez Usage-Based Billing
  2. Choisissez votre compteur
  3. Définissez le prix par unité et le seuil gratuit
3

Send Events

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: "unique_event_id",
      customer_id: "cus_abc123",
      event_name: "api.call",
      metadata: { endpoint: "/v1/users" }
    }]
  })
});
4

Monitor Usage

Tableau de bord du compteur
Consultez le tableau de bord de votre compteur pour voir les événements et l’agrégation des utilisations. Les clients sont facturés automatiquement à chaque cycle.

​
Cas d’Utilisation

APIs & Infrastructure

Suivez les appels d’API, les heures de calcul, la bande passante, le stockage. Exemple : 0,001 $ par appel après 10 000 gratuits.

AI Usage Tracking

Suivez les jetons, les générations, le temps de traitement. Exemple : 0,04 parimagestandard,0,08  par image standard, 0,08  par HD.

Data & Analytics

Facturez selon les données traitées, les requêtes exécutées, les enregistrements analysés. Exemple : 5 $ par Go après 10 Go gratuits.

Communication

Comptez les messages, les minutes, les données transférées. Exemple : 0,01 $ par SMS envoyé.

​
Prochaines Étapes

Event Ingestion

Découvrez comment structurer et envoyer des événements d’utilisation depuis votre application.

Meters Guide

Maîtrisez la configuration des compteurs, les types d’agrégation et le filtrage des événements.

Complete Tutorial

Créez un générateur d’images IA complet avec facturation basée sur l’utilisation depuis zéro.

Integration Guide

Guide complet pour implémenter la facturation basée sur l’utilisation dans votre application.