Configurer une facturation à la consommation
Note
Nous avons mis à jour notre processus de facturation à la consommation. Pour en savoir plus sur les anciennes instructions, consultez notre ancienne documentation sur la facturation à la consommation.
Ce guide présente les principaux concepts d’un modèle de facturation à la consommation du point de vue d’une entreprise fictive d’IA générative appelée Alpaca AI. Alpaca AI facture à ses utilisateurs 0,04 USD tous les 1 000 tokens consommés, à la fin du mois à terme échu.
- Événements de mesure de la consommation : vous envoyez à Stripe des informations spécifiques au client, représentées par des événements de mesure de la consommation. Ces événements représentent l’action brute qu’un client a effectuée dans votre système et qui sert à établir le montant de sa facture. Dans notre exemple, il s’agit du nombre de tokens utilisés par un client dans une requête.
- Dispositif de mesure de la consommation : les dispositifs de mesure de la consommation, qui font office d’objets Configuration pour les événements de mesure de la consommation, fournissent des indications sur la manière dont vous souhaitez que les événements de mesure de la consommation soient agrégés sur la période de facturation. Ici, c’est la somme des tokens sur un mois. Les dispositifs de mesure de la consommation sont associés à des tarifs, ce qui permet de mettre en correspondance la consommation du client avec ses abonnements.
- Récapitulatif des événements de mesure de la consommation : le récapitulatif des événements pour un client. Un dispositif de mesure de la consommation renvoie l’utilisation agrégée pour une période donnée (le dispositif de mesure définit la formule d’agrégation). Dans notre exemple, le récapitulatif des événements de mesure de la consommation renvoie la somme() des tokens pour un client, un dispositif de mesure et une période donnés. Les événements de mesure de la consommation ne sont pas disponibles sur le chemin de lecture et sont agrégés de manière asynchrone dans les résultats du récapitulatif des événements de mesure de la consommation.
- Tarifs : les tarifs déterminent le prix unitaire, la devise et le cycle de facturation. Dans notre exemple, vous définissez un tarif forfaitaire de 0,04 USD pour 1 000 tokens, facturés sur une base mensuelle. En savoir plus sur les tarifs).
- Abonnement : un abonnement vous permet de facturer l’utilisateur de façon récurrente en l’associant à un tarif spécifique. En savoir plus sur les abonnements.
Ce diagramme illustre les concepts de base :
Ce que vous allez créer
Ce guide vous explique comment :
- Modéliser votre offre en créant un dispositif de mesure à des fins de facturation et un catalogue de produits
- Ajouter une session d’encaissement des paiements à votre site
- Suivre les événements d’abonnement
Configurer Stripe
Installez le client Stripe de votre choix :
Installez ensuite l’interface de ligne de commande Stripe. Cette dernière vous permet d’exécuter les tests webhook dont vous avez besoin, et d’exécuter des appels à l’API vers Stripe. Ce guide vous explique dans une section ultérieure comment utiliser l’interface de ligne de commande pour définir un modèle tarifaire.
Pour davantage d’options d’installation, consultez la page consacrée à la CLI Stripe.
Créer un dispositif de mesure de la consommation
Créez le dispositif de mesure de la consommation dans le Dashboard ou via l’API. Vous pouvez procéder à sa création à partir de la page des produits et des tarifs à l’étape suivante.
Découvrez comment configurer des dispositifs de mesure.
Créer un modèle tarifaire
Créez vos produits et leurs options tarifaires dans le Dashboard ou via l’API Stripe.
Créer un client
Vous devez créer un objet Customer pour chaque abonnement. Sur le front-end de votre application, collectez toutes les informations nécessaires sur vos utilisateurs et transmettez-les à votre back-end.
Sur le serveur, créez l’objet Customer Stripe.
Abonner un client au tarif à la consommation
Dans le back-end, le client est abonné au tarif à la consommation.
Cela renvoie un objet d’abonnement avec le SetupIntent requis pour collecter les informations de paiement.
Collecter les informations de paiement
Découvrez comment collecter les informations de paiement avec le clé secrète du client trouvée dans la réponse suite à la création de l’abonnement.
Enregistrer l'utilisation
Vous pouvez commencer à enregistrer la consommation du client calculée par le dispositif de mesure à l’aide d’événements de mesure. Indiquez la référence client et la valeur dans la charge utile. Stripe facture au client l’utilisation réelle à la fin de la période de facturation.
En savoir plus sur l’enregistrement de l’utilisation.