Configurer les dispositifs de mesure

Configurez les dispositifs de mesure pour la facturation à l’usage.

Avant de pouvoir enregistrer l’utilisation des clients, vous devez créer un dispositif de mesure, puis le configurer. Une fois la configuration effectuée, vous ne pouvez pas apporter de modifications autres que le nom d’affichage.

Attributs de configuration du dispositif de mesure

Attribut de mesure	Description
Nom de l’événement	Nom de l’événement de mesure pour lequel vous souhaitez enregistrer l’utilisation avec ce dispositif. Lorsque vous envoyez l’utilisation à Stripe, indiquez ce nom d’événement dans le champ `event_name` pour l’événement de mesure. Le dispositif de mesure adéquat peut ainsi enregistrer et cumuler l’utilisation. Vous ne pouvez utiliser un nom d’événement qu’avec un seul dispositif.
Ingestion des données sur l’événement	Indiquez comment envoyer des événements à Stripe : Brut : traitement de tous les événements de mesure comme des événements autonomes. Plusieurs événements envoyés pour le même horodatage ne se remplacent pas les uns les autres. L’agrégation inclut les événements multiples. Il s’agit de l’option par défaut si vous n’indiquez rien. Pré-compilé : si vous envoyez des événements pour un intervalle de temps spécifique (horaire ou quotidien), Stripe utilise uniquement l’événement de mesure le plus récent reçu dans cet intervalle de temps. Un nouvel événement envoyé dans la même période horaire ou quotidienne remplacera le précédent. Les limites de l’heure et du jour sont fonction de l’horodatage UTC associé à l’événement de mesure.
Formule d’agrégation	Indiquez comment agréger l’utilisation sur la période de facturation : Somme : facturation des clients basée sur la somme de toutes les valeurs d’utilisation pour la période de facturation. Nombre : facturation des clients basée sur le nombre d’utilisations au cours de la période de facturation. Dernier : Facturez vos clients en fonction de la valeur de l’événement d’utilisation le plus récent pour la période de facturation.
Remplacements de la clé de charge utile	Indiquez les clés de la charge utile de l’événement correspondant aux valeurs client et d’utilisation numérique : value_settings : ce paramètre permet de définir la clé de la charge utile de l’événement qui fait référence à la valeur d’utilisation numérique. La clé par défaut est `value`, mais vous pouvez en indiquer une autre, par exemple des tokens. customer_mapping : ce paramètre permet de définir la clé dans la charge utile de l’événement associée à l’ID du client. La clé par défaut est `stripe_customer_id`, mais vous pouvez en indiquer une autre, par exemple `customer_id`.

Corriger les données d’utilisation erronées

Si vous identifiez des événements mal enregistrés dans la période de facturation actuelle, vous pouvez créer un réajustement des événements de mesure pour annuler ces événements. Vous devez indiquer l’identifiant pour l’événement de mesure.

Vous pouvez uniquement annuler les événements qui ont été envoyés à Stripe au cours des dernières 24 heures. Si vous annulez l’utilisation figurant sur une facture finalisée, nous n’actualiserons pas la facture à jour ni n’émettrons de facture corrigée pour l’utilisation annulée. Nous ne prenons pas en charge les réajustements de facturation en cas d’utilisation annulée sur une facture finalisée envoyée à un client.

Vous pouvez également corriger les 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.