Accéder directement au contenu
Créez un compte
ou
connecter-vous
Logo de la documentation Stripe
/
Demander à l'assistant IA
Créez un compte
Connectez-vous
Démarrer
Paiements
Revenus
Plateformes et places de marché
Gestion de fonds
Ressources pour les développeurs
Aperçu
Billing
PrésentationÀ propos des API Billing
Abonnements
Invoicing
Facturation à la consommation
    Présentation
    Fonctionnement de la facturation à l'usage
    Cas d'usage
      Paiement à l'utilisation
      Frais de dépassement et frais forfaitaires
      Modèle de tarification basé sur le crédit
    Enregistrer la consommation en vue de la facturation
    Proposer des crédits de facturation
    Surveiller l'utilisation
    Gérer votre configuration de facturation à l'usage
    Facturation à l'utilisation avancée
    Facturation des tokens LLM
Devis
Gestion des clients
Facturation avec d'autres produits
Recouvrement de revenus
Automatisations
Tester votre intégration
Tax
Présentation
Utiliser Stripe Tax
Gérer la conformité
Rapports
Présentation
Sélectionner un rapport
Configurer des rapports
API de rapport
Rapports sur plusieurs comptes
Comptabilisation des revenus
Données
Présentation
Différents cas d'usage des données métier et produit
SchémaActualisation des données
Sigma
Data Pipeline
Importer des données externes
AccueilRevenusUsage-based billingUse cases

Configurez un modèle de tarification à l’utilisation

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

Intégration dans VS Code

Latarification à l’utilisation est un modèle flexible et évolutif qui vous permet de facturer les clients à terme échu pour l’utilisation qu’ils accumulent. Les entreprises d’IA, les plateformes SaaS et les services cloud utilisent souvent ce modèle économique.

Ce que vous allez créer

Ce guide explique comment mettre en place une tarification à l’usage sur Stripe pour une entreprise fictive appelée Llama.ai. Llama.ai facture ses clients selon les tarifs suivants pour ses modèles LLM :

UtilisationFrais
Token0.04 USD pour 100 tokens

Pour implémenter ce modèle de tarification, vous créez un compteur, configurez la tarification et la facturation et envoyez des événements de mesure pour enregistrer la consommation du client à l’aide de Products et Prices.

Créer un compteur

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 Stripe ou l’API pour configurer un compteur. Pour utiliser l’API avec la Stripe CLI pour créer un compteur, démarrer avec la Stripe CLI.

  1. Sur la page Dispositifs de mesure, cliquez sur Créer un dispositif de mesure.
  2. 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 dans le menu déroulant :
      • 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.
    • (Facultatif) Dans les Paramètres avancés, indiquez les Dimensions que vous souhaitez utiliser pour marquer vos données d’utilisation. Cela vous permet de générer des alertes spécifiques par segment, ou de définir un tarif précis en fonction d’une combinaison d’attributs. Pour l’analyse et le reporting, soumettez vos données d’utilisation avec des dimensions prédéfinies. Exemples de dimensions : modèle LLM, type de token, région ou type d’événement.

Créer un modèle tarifaire

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

Dans l’exemple d’Alpaca AI, vous créez un produit avec un prix mesuré de 0,04 USD par centaine d’unités, facturé mensuellement. Vous utilisez le compteur que vous avez configuré à l’étape précédente.

  1. Sur la page Catalogue de produits, cliquez sur Créer un produit.
  2. Sur la page Ajouter un produit, procédez comme suit :
    • Pour Nom, entrez le nom de votre produit. Pour l’exemple d’Alpaca AI, entrez Alpaca AI.
    • (Facultatif) Pour Description, ajoutez une description qui apparaîtra dans Checkout, dans leportail client et dans devis.
    • Sélectionnez Récurrent.
    • Sous Période de facturation, sélectionnez Autres options tarifaires.
  3. Sur la page Ajouter un tarif, procédez comme suit :
    • Sous Choisissez votre modèle de tarification, sélectionnez À l’usage.
    • Choisissez votre structure de prix :
      • Pour l’exemple d’Alpaca AI, sélectionnez Par lot. Sous Prix, fixez le Montant à 0,04 USD par 100 unités.
      • Sélectionnez Par unité pour fixer le prix en fonction du nombre d’utilisateurs, d’unités ou de sièges.
      • Sélectionnez Par niveau pour activer la tarification échelonnée puis modifiez le coût unitaire en fonction de la quantité ou de l’utilisation.
    • Sous Compteur, sélectionnez le compteur que vous avez créé à l’étape 1. Pour l’exemple d’Alpaca AI, sélectionnez Alpaca AI tokens dans le menu déroulant.
    • Sélectionnez la Période de facturation appropriée. Pour l’exemple d’Alpaca AI, sélectionnez Mensuel.
    • Cliquez sur Suivant.
  4. Sur la page Ajouter un produit, cliquez sur Ajouter un produit.

Créer un objet Customer

Ensuite, créez un client.

  1. Sur la page Clients, cliquez sur Ajouter un client.
  2. 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.
    • (Optional) Ajoutez une adresse e-mail et une description pour votre client.
    • Cliquez sur Ajouter un client.

Créer un abonnement

Subscriptions vous permet de débiter des montants récurrents en associant un client à un prix spécifique.

Utilisez le Dashboard Stripe ou l’API pour créer un abonnement qui comprend votre client, votre produit et un prix basé sur l’usage.

Pour l’exemple d’Alpaca AI, vous créez un abonnement pour le produit Alpaca AI, avec un prix mesuré de 0,04 USD pour 100 unités, facturé mensuellement à John Doe.

Remarque

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

Lorsque vous créez un abonnement billing_mode=flexible, Stripe exclut les postes compteurs de la première facture, car il n’existe pas d’utilisation antérieure à facturer. Si l’abonnement est initialisé avec une utilisation déjà accumulée ou si des éléments de facture en attente existent, Stripe les facture. Lorsque vous créez un abonnement billing_mode=classic, Stripe génère une ligne d’élément de facture à valeur monétaire nulle pour chaque élément d’abonnement mesuré.

  1. Sur la page Abonnements, cliquez sur Créer un abonnement test.
  2. Sur la page Créer un abonnement test, procédez comme suit :
    • Sous Client, sélectionnez le nom de votre client. Pour l’exemple d’Alpace AI, sélectionnez Jean Dupont.
    • 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 test de compteur

Utilisez Meter Events pour enregistrer l’utilisation du client de votre compteur. À 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 compteur sur la page Compteurs du Dashboard.

  1. Sur la page Compteurs, sélectionnez le nom du compteur. Pour l’exemple d’Alpaca AI, sélectionnez Alpaca AI tokens.
  2. Sur la page du compteur, cliquez sur Ajouter une utilisation > Saisie manuelle des données d’utilisation.
  3. Dans la page Ajouter des données de consommation, procédez comme suit :
    • Dans le menu déroulant Client, sélectionnez votre client.
    • For Value, saisissez une valeur d’exemple. Pour l’exemple d’Alpaca AI, saisissez 3000.
    • Cliquez sur Envoyer.

Créer une version bêta de la facture

Créez un aperçu de la facture pour afficher une version bêta de la facture d’un client qui comprend des détails tels que le prix du compteur et la quantité d’utilisation.

  1. Sur la page Abonnements, sélectionnez un abonnement. Pour l’exemple d’Alpaca AI, sélectionnez l’abonnement de John Doe.

  2. 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.

  3. 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 risquent de ne pas afficher immédiatement les derniers événements de mesure.

FacultatifRécupérer l'utilisation sur une période personnalisée

Utilisez Meter Event Summary pour récupérer l’utilisation totale d’un client sur une période personnalisée. Le récapitulatif des événements de mesure renvoie la consommation agrégée du client pour une période, selon la formule d’agrégation définie par le compteur.

Dans l’exemple d’Alpaca AI, le récapitulatif des événements de mesure indique la somme des tokens pour un client, un dispositif et une période spécifiques.

Étant donné que Stripe traite les événements de mesure de manière asynchrone, les récapitulatifs des événements de mesure risquent de ne pas afficher immédiatement les derniers événements de mesure.

Command Line
cURL
Stripe CLI
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
curl -G https://api.stripe.com/v1/billing/meters/{{METER_ID}}/event_summaries \ -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:"
\ -d customer={{CUSTOMER_ID}} \ -d start_time=1717249380 \ -d end_time=1717249440

Étapes suivantes

  • Accepter des paiements avec Stripe Checkout
  • Définir des alertes et des seuils
  • Établir des crédits de facturation
Cette page vous a-t-elle été utile ?
OuiNon
  • Besoin d'aide ? Contactez le service Support.
  • Rejoignez notre programme d'accès anticipé.
  • Consultez notre log des modifications.
  • Des questions ? Contactez l'équipe commerciale.
  • LLM ? Lire llms.txt.
  • Propulsé par Markdoc