Configurer une facturation à l’usage avec des produits et des tarifs

Facturez les clients en fonction de leur utilisation de votre produit ou service.

La facturation à l’usage vous permet de facturer vos clients en fonction de l’usage qu’ils font de votre produit ou service.

Ce guide vous explique la manière de créer un dispositif de mesure, de configurer la tarification et la facturation, et d’envoyer des événements de mesure pour enregistrer l’utilisation des clients à l’aide des produits et des tarifs. Le recours à une entreprise GenAI fictive appelée Alpaca AI vous permettra d’apprendre les concepts de base d’un modèle de facturation à l’usage. Alpaca AI facture à ses clients 0,04 USD par centaine de tokens, et les débite à la fin du mois à terme échu.

Voici un exemple d’un cycle de vie d’une intégration typique de facturation à l’usage utilisant les produits et les tarifs :

Créer un dispositif de mesure de la consommation

Les compteurs indiquent comment regrouper les événements des compteurs au cours d’une période de facturation. Les événements de mesure représentent toutes les actions effectuées par les clients dans votre système (par exemple, les requêtes d’API). Les compteurs sont associés aux prix et constituent la base de ce qui est facturé.

Pour l’exemple d’Alpaca AI, les événements de mesure correspondent au nombre de tokens qu’un client utilise lors d’une requête. Le dispositif de mesure suit la somme des tokens utilisés sur un mois.

Vous pouvez utiliser le Dashboard ou l’API Stripe pour configurer un dispositif de mesure. Pour utiliser l’API avec l’interface de ligne de commande Stripe afin de créer un dispositif de mesure, démarrez avec l’interface de ligne de commande Stripe.

Sur la page Dispositifs de mesure, cliquez sur Créer un dispositif de mesure.
Sur la page Créer un dispositif de mesure, procédez comme suit :
- Pour Nom du dispositif de mesure, saisissez le nom du compteur à des fins d’affichage et d’organisation. Pour l’exemple d’Alpaca AI, saisissez « Alpaca AI tokens ».
- Pour Nom de l’événement, saisissez le nom à afficher dans les événements de mesure lors du rapport d’utilisation à Stripe. Pour l’exemple d’Alpaca AI, saisissez « alpaca_ai_tokens ».
- Définissez la Méthode d’agrégation appropriée dans la liste déroulante :
  - Dans l’exemple d’Alpaca AI, sélectionnez Somme. Cela établit la somme des valeurs indiquées (dans cet exemple, le nombre de tokens utilisés par un client) pour déterminer l’usage à facturer.
  - Choisissez le nombre à facturer en fonction du nombre d’événements indiqués.
  - Choisissez Dernier pour facturer en fonction de la dernière valeur indiquée.
  - Utilisez le volet d’aperçu pour définir des exemples d’événements d’utilisation et vérifier la méthode d’agrégation.
- Cliquez sur Créer un dispositif de mesure de la consommation.

Créer un modèle tarifaire

Utilisez le Dashboard ou l’API Stripe pour créer un modèle tarifaire qui inclut vos produits et leurs options tarifaires. Les tarifs définissent le coût unitaire, la devise et le cycle de facturation.

Pour l’exemple d’Alpaca AI, créez un produit dont le tarif mesuré est de 0,04 USD par centaine d’unités, facturé mensuellement. Utilisez le dispositif que vous avez créé à l’étape précédente.

Sur la page Catalogue de produits, cliquez sur Créer un produit.
Sur la page Ajouter un produit, procédez comme suit :
- Dans la zone Nom, saisissez le nom de votre produit. Pour l’exemple d’Alpaca AI, saisissez Alpaca AI.
- (Facultatif) Pour Description, ajoutez la description à afficher dans Checkout, sur le portail client et dans les devis.
- Sélectionnez Récurrent.
- Sous Période de facturation, sélectionnez Autres options tarifaires.
Sur la page Ajouter un tarif, procédez comme suit :
- Sous Choisissez votre modèle de tarification, sélectionnez À l’usage.
- Choisissez votre structure tarifaire :
  - Dans l’exemple d’Alpaca AI, sélectionnez Par lot. Sous Tarif, définissez le montant sur 0.04 USD pour 100 unités.
  - Sélectionnez À l’unité pour fixer le tarif en fonction du nombre d’utilisateurs, d’unités ou de places.
  - Sélectionnez Par niveau pour activer la tarification échelonnée et modifier le coût unitaire en fonction de la quantité ou de l’utilisation.
- Sous Dispositif de mesure, sélectionnez celui que vous avez créé à l’étape 1. Dans l’exemple d’Alpaca AI, sélectionnez Alpaca AI tokens dans le menu déroulant.
- Sélectionnez la période de facturation appropriée. Dans l’exemple d’Alpaca AI, sélectionnez Mensuel.
- Cliquez sur Suivant.
Sur la page Ajouter un produit, cliquez sur Ajouter un produit.

Créer un client

Ensuite, créez un client.

Sur la page Clients, cliquez sur Ajouter un client.
Sur la page Créer un client, procédez comme suit :
- Pour Nom, saisissez le nom de votre client. Pour l’exemple d’Alpaca AI, saisissez John Doe.
- (Facultatif) Ajoutez une adresse e-mail et une description pour votre client.
- Cliquez sur Ajouter un client.

Créer un abonnement

Subscriptions vous permet de facturer des montants récurrents en associant un client à un tarif spécifique.

Utilisez le Dashboard Stripe ou l’API pour créer un abonnement qui inclut votre client, votre produit et un tarif à l’usage.

Dans l’exemple d’Alpaca AI, vous créez un abonnement pour le produit Alpaca AI, avec un tarif mesuré de 0,04 USD par 100 unités, facturé chaque mois à John Doe.

Remarque

Vous pouvez associer un tarif unique mesuré à un ou plusieurs abonnements.

Sur la page Abonnements, cliquez sur Créer un abonnement de test.
Sur la page Créer un abonnement de test, procédez comme suit :
- Sous Client, sélectionnez le nom de votre client. Pour l’exemple d’Alpaca AI, sélectionnez John Doe.
- Sous Produit, sélectionnez votre tarif. Pour l’exemple d’Alpaca AI, sélectionnez le tarif sous Alpaca AI.
- (Facultatif) Modifiez les informations et les paramètres de l’abonnement, si nécessaire.
- Cliquez sur Créer un abonnement test.

Envoyer un événement de mesure test

Utilisez les événements de mesure pour enregistrer l’utilisation des clients pour votre dispositif de mesure. À la fin de la période de facturation, Stripe facture l’utilisation déclarée.

Vous pouvez tester votre facturation à l’usage en envoyant un événement de mesure via le Dashboard Stripe ou l’API. Lorsque vous utilisez l’API, spécifiez l’ID du client et la valeur de payload.

Après avoir envoyé des événements de mesure, vous pouvez consulter les détails de l’utilisation de votre dispositif sur la page Dispositifs de mesure du Dashboard.

Sur la page Dispositifs de mesure, sélectionnez le nom du dispositif. Pour l’exemple d’Alpaca AI, sélectionnez les tokens d’Alpaca AI.
Sur la page du dispositif, cliquez sur Ajouter une utilisation > Saisie manuelle de l’utilisation.
Dans la page Ajouter une utilisation, procédez comme suit :
- Sélectionnez votre client dans la liste déroulante Client.
- Pour Valeur, saisissez une valeur d’exemple. Pour l’exemple de l’IA Alpaga, saisissez 3000.
- Cliquez sur Envoyer.

Créer un aperçu de la facture

Créez un aperçu de la facture pour afficher un aperçu de la facture d’un client qui comprend des informations telles que le tarif à l’usage et la quantité utilisée.

Sur la page Abonnements, sélectionnez un abonnement. Pour l’exemple d’Alpaca AI, sélectionnez l’abonnement de John Doe.
Sur la page d’information de l’abonnement, descendez jusqu’à la section Facture à venir. La facture à venir indique le montant de l’abonnement à facturer au client à la date spécifiée.
En cliquant sur Afficher la facture complète, vous obtiendrez toutes les informations de la facture à venir, dont :
- Client
- Méthode de facturation
- Date de création
- Abonnement connecté
- Informations de l’abonnement (quantité d’utilisation et tarif du dispositif)
- Montant dû
Étant donné que Stripe traite les événements de mesure de manière asynchrone, les factures à venir peuvent ne pas refléter immédiatement les derniers événements de mesure.