Créez et configurez un compteur pour la facturation à l'usage
Avant de pouvoir enregistrer l’utilisation des clients, vous devez créer un compteur, puis le configurer. Une fois le compteur configuré, vous ne pouvez plus le modifier, à l’exception du nom d’affichage.
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’Hypernian, les événements de mesure correspondent au nombre de tokens qu’un client utilise lors d’une requête. Le compteur correspond à la somme des tokens 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.
Sur la page Compteurs, cliquez sur Créer un compteur.
Dans l’éditeur de compteurs :
Pour Nom du compteur, entrez le nom du compteur à des fins d’affichage et d’organisation. Pour l’exemple d’Hypernian, entrez « Hypernian 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_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.
(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.
Attributs de configuration du compteur
Attribut de compteur
Description
Nom de l’événement
Le nom de l’événement de mesure pour lequel vous souhaitez enregistrer l’utilisation avec le compteur. Lorsque vous envoyez l’utilisation à Stripe, spécifiez ce nom d’événement dans le champ event_name pour l’événement de compteur. Cela permet au bon compteur d’enregistrer et d’agréger l’utilisation. Vous ne pouvez utiliser un nom d’événement qu’avec un seul compteur.
Ingestion des données sur l’événement
Indiquez comment envoyer des événements à Stripe :
Raw : traitez tous les événements de mesure comme des événements indépendants. Lorsque plusieurs événements sont envoyés avec le même horodatage, ils ne s’écrasent pas les uns les autres et sont inclus dans la compilation. Si rien n’est indiqué, c’est l’option par défaut.
Pre-aggregated : si vous envoyez des événements pour un intervalle de temps spécifique (horaire ou quotidien), Stripe n’utilise que l’événement de mesure reçu le plus récemment dans cet intervalle. Tout nouvel événement envoyé dans la même fenêtre horaire ou quotidienne remplace le précédent. L’horodatage de l’événement de mesure en UTC détermine les limites d’heure et de jour.
Formule d’agrégation
Indiquez comment agréger l’utilisation sur la période de facturation :
Sum : facturation des clients basée sur la somme de toutes les valeurs d’utilisation pour la période de facturation.
Count : facturation des clients basée sur le nombre d’utilisations au cours de la période de facturation.
Last : Facturez les clients sur la base de la valeur de l’événement d’utilisation le plus récent pour la période de facturation.
Dérogations des clés de charge utile
Indiquez les clés de la charge utile de l’événement correspondant aux valeurs d’utilisation du client et aux valeurs numériques :
value_settings : utilisez ce paramètre pour définir la clé dans la charge utile de l’événement associée à la valeur d’utilisation numérique. La clé par défaut est : value, mais vous pouvez indiquer une clé différente, par exemple des tokens.
customer_mapping : utilisez ce paramètre pour définir la clé dans la charge utile de l’événement qui fait référence à l’identifiant du client. La clé par défaut est stripe_customer_id, mais vous pouvez spécifier une clé différente, telle que customer_id.
Corriger les données d’utilisation erronées
Si vous identifiez des événements enregistrés de manière incorrecte dans la période de facturation en cours, vous pouvez créer un Meter Event Adjustment pour annuler ces événements. Vous devez spécifier l’identifiant pour l’événement de mesure.
Vous pouvez uniquement annuler les événements envoyés à Stripe au cours des dernières 24 heures. Si vous annulez une utilisation incluse dans une facture finalisée, nous ne mettrons pas cette facture à jour et n’émettrons pas de facture corrigée pour l’utilisation annulée. Les ajustements de facturation ne sont pas pris en charge pour une utilisation annulée figurant sur une facture finalisée envoyée à un client.
Vous pouvez également corriger des données d’utilisation mal enregistrées en enregistrant des quantités négatives. Si la consommation globale au cours du cycle est négative, Stripe indique que la quantité d’utilisation du poste de facture est égale à 0.