> ## 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.
# Facturation Basée sur l'Usage
> Facturez les clients en fonction de ce qu'ils utilisent réellement avec une mesure flexible et une facturation automatisée.
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
Your application sends events when billable actions occur.
```javascript theme={null}
{
"event_id": "evt_123",
"customer_id": "cus_abc",
"event_name": "api.call",
"metadata": { "endpoint": "/v1/users" }
}
```
Les compteurs agrègent les événements en quantités facturables via les agrégations Count, Sum, Max ou Last.
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
### Produits avec Tarification Basée sur l'Usage
Définissez le prix par unité et les seuils gratuits optionnels :
**Exemple** : 2 500 appels - 1 000 gratuits = 1 500 × 0,02 $= 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](/features/credit-based-billing) d’un client. Les crédits se renouvellent à chaque cycle de facturation et s’appliquent avant tout dépassement.
## Démarrage Rapide
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
Associez le compteur à un produit avec tarification :
1. Sélectionnez **Usage-Based Billing**
2. Choisissez votre compteur
3. Définissez le prix par unité et le seuil gratuit
```javascript theme={null}
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" }
}]
})
});
```
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
Suivez les appels d'API, les heures de calcul, la bande passante, le stockage. Exemple : 0,001 \$ par appel après 10 000 gratuits.
Suivez les jetons, les générations, le temps de traitement. Exemple : 0,04 $ par image standard, 0,08 $ par HD.
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.
Comptez les messages, les minutes, les données transférées. Exemple : 0,01 \$ par SMS envoyé.
## Prochaines Étapes
Découvrez comment structurer et envoyer des événements d'utilisation depuis votre application.
Maîtrisez la configuration des compteurs, les types d'agrégation et le filtrage des événements.
Créez un générateur d'images IA complet avec facturation basée sur l'utilisation depuis zéro.
Guide complet pour implémenter la facturation basée sur l'utilisation dans votre application.