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
API et SDKAide
Aperçu
Gestion des versions
Journal des modifications
    Présentation
    Clover
    Basil
    Acacia
    Versions précédentes
Mettre à niveau votre version de l'API
Actualiser votre version du SDK
Essentials
SDK
API
Tests
CLI Stripe
Exemples de projets
Outils
Dashboard Stripe
Workbench
Dashboard des développeurs
Shell Stripe
Stripe pour Visual Studio Code
Fonctionnalités
Workflows
Destinations d'événements
Alertes d'intégrité de StripeChargements de fichiers
Solutions d'IA
Boîte à outils des agents
Modèle de protocole contextuelCréer des flux de facturation SaaS avec l’IA agentique
Sécurité et confidentialité
Sécurité
Robot d'exploration Web Stripebot
Confidentialité
Extensions Stripe
Créer des applications Stripe
Utiliser les applications de Stripe
Partenaires
Partner ecosystem
Certification des partenaires
États-Unis
Français (France)
AccueilRessources pour les développeursChangelogClover2025-09-30.preview

Ajout de la pagination et mise à jour des champs pour les données d'utilisation de la facturation effective.Modifications majeures

Nouveautés

Ajoute la pagination aux données agrégées d’utilisation des compteurs Billing et met à jour les noms de champs pour assurer la cohérence avec les autres API Stripe.

Pourquoi s’agit-il d’une modification majeure ?

Nous avons renommé certains paramètres de requête et champs de réponse.

Les modifications apportées à la requête sont les suivantes :

  • start_time est désormais starts_at
  • end_time est désormais ends_at
  • meters.meter_id est désormais meters.meter

Les modifications apportées aux réponses sont les suivantes :

  • data_refreshed_at est désormais refreshed_at

L’objet data est désormais imbriqué à l’intérieur de rows, ce qui inclut les détails de la pagination. Dans le champ data, les changements de réponse sont les suivants :

  • bucket_start_time est désormais starts_at
  • bucket_end_time est désormais ends_at
  • Compartiment_value est désormais value
  • meter_id est désormais meter

Impact

Lorsque vous passez à cette version de l’API, vous pouvez utiliser les fonctionnalités de pagination pour accéder à davantage de données sur l’utilisation de votre compteur.

Modifications

paramètresModifierRessources ou endpoints
ends_atstarts_atAjouté
Billing.Analytics.MeterUsage#retrieveBilling.Analytics.MeterUsageRow
meterAjouté
Billing.Analytics.MeterUsage#retrieve.meters[]Billing.Analytics.MeterUsageRow
valueAjouté
Billing.Analytics.MeterUsageRow
bucket_end_timebucket_start_timebucket_valueSupprimé
Billing.Analytics.MeterUsageRow
meter_idSupprimé
Billing.Analytics.MeterUsage#retrieve.meters[]Billing.Analytics.MeterUsageRow
end_timestart_timeSupprimé
Billing.Analytics.MeterUsage#retrieve
refreshed_atrowsAjouté
Billing.Analytics.MeterUsage
datadata_refreshed_atSupprimé
Billing.Analytics.MeterUsage

Mise à niveau

  1. Consultez la version actuelle de votre API dans Workbench.
  2. Si vous utilisez un SDK, passez à une version correspondant à celle de l’API.
    • Si vous n’utilisez pas de SDK, mettez à jour vos requêtes API pour inclure la version Stripe : 2025-09-30.preview
  3. Mettez à niveau la version de l’API utilisée pour les endpoints de webhook.
  4. Testez votre intégration avec la nouvelle version.
  5. Si vous utilisez Connect, testez votre intégration Connect.
  6. Effectuez la mise à niveau dans Workbench. Vous pourrez revenir à la version précédente pendant 72 heures.

En savoir plus sur les mises à niveau de l’API Stripe.

Modifications connexes

  • Ajoute la possibilité de mettre à jour la taxe automatique, la création de factures et les paramètres de facturation pour les Sessions Checkout
  • Ajoute le paramètre d’étiquette d’unité au hachage des données du produit
  • Ajoute la prise en charge des cadences de facturation, des paramètres de facturation et des profils de facturation
Cette page vous a-t-elle été utile ?
OuiNon
  • Besoin d'aide ? Contactez le service Support.
  • Consultez notre log des modifications.
  • Des questions ? Contactez l'équipe commerciale.
  • LLM ? Lire llms.txt.
  • Propulsé par Markdoc