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 AI, plateformes d’infrastructure et tout produit dont la valeur évolue avec l’usage.

​
Comment ça fonctionne

1

Envoyer des Événements d'Usage

Votre application envoie des événements lorsque des actions facturables se produisent.
{
  "event_id": "evt_123",
  "customer_id": "cus_abc",
  "event_name": "api.call",
  "metadata": { "endpoint": "/v1/users" }
}
2

Les Compteurs Agrègent l'Usage

Les compteurs agrègent les événements en quantités facturables en utilisant les agrégations Compte, Somme, Max ou Dernier.
3

Facturation Automatique

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

​
Concepts Clés

​
Événements

Les événements représentent des actions d’usage dans votre application. Chaque événement comprend :
  • Nom de l’Événement : Type d’usage (par exemple, api.call)
  • ID Client : Qui l’a utilisé
  • Métadonnées : 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

​
Crédits Clients

Offrez aux clients des crédits d’usage inclus qui se renouvellent à chaque cycle de facturation. Les crédits s’appliquent avant l’usage payant.

​
Démarrage Rapide

1

Créer un Compteur

Dans votre tableau de bord : Compteurs → Créer un Compteur
  1. Définissez le nom de l’événement (par exemple, api.call)
  2. Choisissez l’agrégation (Compte, Somme, Max, Dernier)
  3. Ajoutez des filtres optionnels
2

Ajouter au Produit

Liez le compteur à un produit avec tarification :
Ajout d'un compteur au produit
  1. Sélectionnez Facturation Basée sur l’Usage
  2. Choisissez votre compteur
  3. Définissez le prix par unité et le seuil gratuit
3

Envoyer des Événements

await fetch('https://test.dodopayments.com/events/ingest', {
  method: 'POST',
  headers: {
    'Authorization': `Bearer ${process.env.DODO_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

Surveiller l'Usage

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

​
Cas d’Utilisation

APIs & Infrastructure

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

Suivi de l'Usage AI

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

Données & Analytique

Facturez par données traitées, requêtes exécutées, 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

Ingestion d'Événements

Apprenez à structurer et à envoyer des événements d’usage depuis votre application.

Guide des Compteurs

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

Tutoriel Complet

Construisez un générateur d’images AI complet avec facturation basée sur l’usage depuis zéro.

Guide d'Intégration

Guide complet pour mettre en œuvre la facturation basée sur l’usage dans votre application.