Établir un modèle de tarification par crédit

Débiter les clients pour les crédits de préachat.

Les crédits vous permettent d’offrir un montant fixe en monnaie pour l’utilisation de vos produits facturés à l’usage. Ce modèle fonctionne bien lorsque vous souhaitez donner aux clients une prévisibilité initiale tout en alignant les revenus directement sur l’utilisation. Par exemple, si vous vendez une API qui traite des images et du stockage dans le cloud, un client peut acheter de crédits au début du mois. Il peut dépenser n’importe quelle combinaison d’utilisation de l’API et de stockage dans le cloud jusqu’à concurrence de ce montant, et payer des frais supplémentaires pour l’un ou l’autre service à la fin du mois s’il dépasse d’utilisation.

Les crédits s’appliquent indifféremment à tous les compteurs. Pour fixer des limites spécifiques à vos différents produits facturés à l’usage (par exemple 100 requêtes API et 3 Go de stockage), utilisez le modèle de frais forfaitaires et de dépassement.

Ce que vous allez créer

Dans ce guide, créez l’abonnement suivant pour une entreprise fictive appelée Hypernian, qui fournit des LLM. Elle facture ses clients aux taux suivants :

Crédits	Frais
Par utilisateur	10 USD

Utilisation	Frais
Input token	0.03 USD par token
Output token	0.05 USD par token

Créer un compteur

Les compteurs spécifient comment agréger les événements du compteur sur 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, des requêtes API). Les compteurs sont associés à des prix et constituent la base de la facturation.

Pour l’exemple d’Hypernian, les événements de mesure correspondent au nombre de tokens d’entrée et de sortie qu’un client utilise dans une requête. Le compteur correspond à la somme des tokens sur un mois. Dans cet exemple, vous créez un compteur pour chaque type de token.

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émarrez avec la Stripe CLI.

Sur la page Compteurs, cliquez sur Créer un compteur.
Sur la page Créer un compteur, procédez comme suit :
- Pour Nom du compteur, entrez le nom du compteur à des fins d’affichage et d’organisation. Pour l’exemple d’Hypernian, entrez « Hypernian Input tokens ».
- Pour Nom de l’événement, entrez le nom à afficher dans les événements de mesure lors du rapport d’utilisation à Stripe. Pour l’exemple d’Hypernian, entrez « hypernian_input_tokens ».
- Définissez la Méthode d’agrégation dans le menu déroulant :
  - Pour l’exemple d’Hypernian, sélectionnezSum. Cette option additionnera les valeurs indiquées (dans cet exemple, le nombre de tokens utilisés par un client) afin de déterminer l’utilisation à facturer.
  - Choisissez Compte pour que la facturation soit établie en fonction du nombre d’événements signalés.
  - Choisissez Dernier pour établir la facture sur la base de la dernière valeur déclarée.
  - Utilisez le volet de version bêta pour définir des exemples d’événements d’utilisation et vérifier la méthode d’agrégation.
- Cliquez sur Créer un compteur.
- Pour créer un compteur pour les Output Tokens, répétez les étapes précédentes et définissez le nom du compteur sur Hypernian Output Tokens et le nom de l’événement sur « hypernian_output_tokens. »
- (Facultatif) Sous 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 basé sur l’utilisation 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.

Pour l’exemple d’Hypernian, vous créez deux produits, chacun avec un compteur facturé à une fréquence mensuelle. Utilisez le compteur 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 :
- Pour Nom, entrez le nom de votre produit. Pour l’exemple d’Hypernian, entrez Utilisation d'Hypernian.
- (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.
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’Hypernian, sélectionnez Par unité. Sous Prix, réglez le Montant sur 0,03 USD.
  - Sous Compteur, sélectionnez le compteur que vous avez créé et choisissez Hypernian Input tokens dans la liste déroulante.
  - Pour Période de facturation, sélectionnez Mensuel.
- Sous Compteur, sélectionnez le compteur que vous avez créé. Pour l’exemple d’Hypernian, sélectionnez Hypernian Input tokens dans le menu déroulant.
- Sélectionnez la Période de facturation appropriée. Pour l’exemple d’Hypernian, sélectionnez Mensuel.
- Cliquez sur Suivant.
Repeat the previous steps and create a product named “Hypernian output usage” with a price of 0.05 USD. Attach it to the Aplaca AI output token meter with the same monthly billing period.

Créer un objet Customer

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, entrez le nom de votre client. Pour l’exemple d’Hypernian, entrez Florence Martin.
- (Optional) Ajoutez une adresse e-mail et une description pour votre client.
- Cliquez sur Ajouter un client.

Octroi de crédits de facturation à votre client

Utilisez le Dashboard Stripe ou l’API pour créer un octroi de crédit pour votre client.

Les crédits sont épuisés à la fin de la période de facturation.

Avec cette version de la facturation à l’usage, les crédits sont épuisés lorsque la facture est créée à la fin de la période de facturation. La facturation avancée à l’usage, actuellement en version bêta privée, vous permet de configurer des crédits qui s’épuisent en temps réel. Inscrivez-vous à la version bêta privée pour y accéder et en savoir plus.

Les crédits de facturation ne s’appliquent qu’aux postes de l’abonnement qui ont un lien avec un prix de compteur. L’API Usage Records n’est pas prise en charge.

Sur la page Clients, sélectionnez le nom du client.
Sur la page client, sous Octrois de crédit, cliquez sur le symbole plus (+).
Sur la page Nouvel octroi de crédit, procédez comme suit :

Dans le champ Nom, saisissez le nom de votre octroi de crédit.
Dans le champ Montant, indiquez le montant de l’octroi de crédit. Pour l’exemple d’Hypernian, entrez 10.
(Facultatif) Sous Date d’entrée en vigueur, indiquez la date à laquelle le crédit sera accordé.
(Facultatif) Sous Date d’expiration, indiquez la date d’expiration des crédits, le cas échéant.
(Facultatif) Sous la rubrique Priorité, indiquez la priorité pour cet octroi de crédit.
(Facultatif) Sous Eligibilité, indiquez une liste de prix basés sur l’usage auxquels cet octroi de crédit s’applique.
Cliquez sur Créer un octroi.

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.

Dans l’exemple d’Hypernian, vous créez un abonnement regroupant les produits Hypernian Input Token et Hypernian Output Token, facturé chaque mois à Jenny Rosen.

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

Sur la page Abonnements, cliquez sur Créer un abonnement test.
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’Hypernian, sélectionnez Jean Dupont.
- Sous Produit, sélectionnez vos prix. Pour l’exemple d’Hypernian, sélectionnez le prix sous Utilisation d’Hypernian en entrée et Utilisation d’Hypernian en sortie.
- (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.

Sur la page Compteurs, sélectionnez le nom du compteur. Pour l’exemple d’Hypernian, sélectionnez Hypernian Input tokens.
Sur la page du compteur, cliquez sur Ajouter une utilisation > Saisie manuelle des données d’utilisation.
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, entrez une valeur d’exemple. Pour l’exemple d’Hypernian, entrez 3 000.
- 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.

Sur la page Abonnements, sélectionnez un abonnement. Pour l’exemple d’Hypernian, sélectionnez l’abonnement de Jenny Rosen.
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 risquent de ne pas afficher immédiatement les derniers événements de mesure.

Appliquer des crédits de facturation aux factures

Une fois la facture finalisée, Stripe applique automatiquement tous les crédits de facturation applicables. Le solde disponible de l’octroi de crédit est mis à jour en fonction du montant des crédits de facturation appliqués à la facture.

Vous pouvez consulter le montant des crédits de facturation appliqués à une facture dans le Dashboard Stripe.

Sur la page Clients, sélectionnez le nom du client.
Sur la page client, sous Factures, sélectionnez une facture.
Sur la page de la facture, sous Sous-total, repérez la ligne Octroi de crédit appliqué.

Récupérer le solde disponible du crédit de facturation

Utilisez le Dashboard ou l’API Stripe pour consulter le solde disponible du crédit de facturation d’un client. Lorsque vous utilisez l’API, récupérez l’endpoint du Credit-Balance-Summary.

Sur la page Clients, sélectionnez le nom du client.
Sur la page client, sous Octroi de crédit, vous trouverez la liste des octrois de crédit pouvant s’appliquer aux factures. Vous pouvez consulter le available_balance de l’octroi de crédit dans la colonne Disponible.

Liste des transactions pour un octroi de crédit

Utilisez le Dashboard Stripe ou l’API pour consulter les transactions d’un octroi de crédit ou d’un client spécifique. Lorsque vous utilisez l’API, appelez l’endpoint du Credit Balance Transaction.

Sur la page Clients, sélectionnez le nom du client.
Sur la page client, sous la rubrique Octrois de crédit, sélectionnez un octroi de crédit.
Affichez le détail des opérations sur solde créditeur.

FacultatifFinancer l'octroi de crédit

Utilisez le Dashboard Stripe ou l’API pour créer une facture unique afin de collecter le paiement d’un client. Lorsque vous utilisez l’API, écoutez le webhook invoice.paid et accordez des crédits de facturation à vos clients.

Sur la page Clients, sélectionnez le nom du client.
Sur la page client, cliquez sur Créer une facture.
Suivez les instructions pour créer une facture

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’Hypernian, 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.