Enregistrer l'utilisation pour la facturation à l'aide de S3Version bêta publique
Transmettez les événements d'utilisation de votre groupe S3 en lots.
Vous pouvez envoyer à Stripe des événements de mesure de l’utilisation à partir de votre groupe de stockage S3. Stripe analyse, valide et transforme le contenu du fichier en événements de mesure. Une fois que les événements de votre fichier ont été chargés avec succès, Stripe les affiche sur votre facture d’abonnement.
Vous pouvez charger les événements de mesure de l’utilisation sous forme de fichiers CSV, JSON ou JSONLINE.
Ajoutez les champs suivants dans votre fichier et assurez-vous qu’ils respectent le schéma de l’événement de mesure
identifier
: l’identifiant unique de l’événement. S’il n’est pas fourni, Stripe en génère un. Nous recommandons d’utiliser un identifiant unique au niveau mondial.timestamp
: le moment de l’événement, mesuré en secondes depuis l’heure Unix.event_
: le nom de l’événement de mesure.name payload_
: les colonnes de charge utile contiennent des noms de clés faisant référence à des valeurs d’utilisation numériques et de clients.columns payload_
: cette colonne contient l’attribut stripe_customer_id pour lequel l’événement est créé.stripe_ customer_ id payload_
: cette colonne représente la valeur numérique d’utilisation de l’événement de mesure. Par défaut, le nom de la colonne estvalue payload_
. Cependant, vous pouvez le modifier pour qu’il corresponde au nom de champ utilisé à la création de l’événement de mesure (en le faisant précéder devalue payload_
).
Vous avez besoin d'aide pour un autre format de fichier ?
Contactez-nous si vous souhaitez charger des fichiers avec une structure différente ou dans un format personnalisé.
Importer des fichiers depuis votre groupe Amazon S3
Une fois vos fichiers préparés, vous pouvez configurer le connecteur S3. Celui-ci interroge et traite automatiquement ces fichiers. Lorsque vous configurez votre connecteur S3, veillez à sélectionner le modèle de données correct.
- Pour les fichiers au format JSON, sélectionnez le modèle de transaction d’événement de mesure pour la facturation - JSON.
- Pour les fichiers au format JSONLINE, sélectionnez le modèle de transaction d’événement de mesure pour la facturation - JSONLINE.
- Pour les fichiers au format CSV, sélectionnez le modèle de transaction d’événement de mesure pour la facturation - CSV.
Traiter les événements de mesure non valides
Stripe traite les événements de mesure de manière asynchrone et vous informe par un webhook en cas d’erreur constatée dans la consommation mesurée.
Stripe crée un événement de type billing.
, qui résume les erreurs de traitement des événements de mesure récentes. Vous pouvez voir ces événements dans le Dashboard Stripe en vous rendant sur la page Événements. Vous pouvez aussi automatiquement effectuer des actions sur ces événements en les écoutant à l’aide d’un endpoint de webhook.
Vous trouverez ci-dessous un exemple de l’événement.
{ type: "billing.meter.error_report.triggered", data: { object: { id: "err_123456" summary: "There are 2 invalid events", validation_start: 1724098690, validation_end: 1724098700, reason: { error_count: 2, error_types: [ { error_code: "METER_NOT_FOUND", error_count: 2, "sample_errors": [ { "error_message": "No meter was found matching event_name invalid_event_name.", "request": { "id": "req_123456", "idempotency_key": "idmpk_123456", } }, { "error_message": "No meter was found matching event_name invalid_event_name.", "request": { "id": "req_123457", "idempotency_key": "idmpk_123457" } } ] } ] } } } }
Examinez vos fichiers chargés en fonction des informations contenues dans sample_
, corrigez les événements non valides et chargez un nouveau fichier correctif afin qu’il soit traité.