Accéder directement au contenu
Créez un compte ou connecter-vous
Logo de la documentation Stripe
/
Demander à l'assistant IA
Créez un compteConnectez-vous
Démarrer
Paiements
Revenus
Plateformes et marketplaces
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éveloppeursChangelogBasil2025-03-31.basil

Suppression de l’ancienne facturation à l’usageModifications majeures

Nouveautés

Nous avons supprimé le service de support de l’ancienne facturation à l’usage. Vous ne pouvez plus créer un tarif avec un usage_type à l’usage sans compteur spécifié. Nous avons également supprimé les billing_thresholds des endpoints d’abonnement.

Nous avons supprimé les attributs billing_thresholds et aggregate_usage de tous les endpoints API. Il n’est plus possible de créer les anciens tarifs à l’usage ni d’associer des tarifs à l’usage existants à des devis, à des factures à venir ou à des abonnements.

Un ancien tarif à l’usage est défini comme un tarif dont l’attribut usage_type est metered mais ne spécifie pas de dispositif de mesure.

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

  • Suppression des billing_thresholds des endpoints abonnement
  • Suppression de la valeur aggregate_usage des endpoints tarif.
  • L’utilisation de la valeur usage_type de metered sans de valeur meter spécifiée renvoie désormais une erreur lors de la création du tarif.
  • Suppression de la prise en charge de l’ajout de tarifs usage_type=metered sans un meter défini aux abonnements, aux planifications d’abonnement et aux devis.

Impact

Suivez notre guide de migration pour mettre à jour votre intégration afin d’utiliser les compteurs.

Modifications

Modifierressources
Supprimé
UsageRecordSummaryUsageRecord
endpoints Modifierressources
createSupprimé
UsageRecord
listSupprimé
UsageRecordSummary
usage_record_summariesSupprimé
SubscriptionItem
paramètresModifierRessources ou endpoints
aggregate_usageSupprimé
Plan#createPlanPrice#create.recurring
 + 1 de plus
Price.recurring
billing_thresholdsSupprimé
Invoice#create_preview.schedule_details.phases[].items[]Invoice#create_preview.schedule_details.phases[]Invoice#create_preview.subscription_details.items[]
 + 17 de plus
Subscription#create.items[]Subscription#createSubscription#update.items[]Subscription#updateSubscriptionItem#createSubscriptionItem#updateSubscriptionItemSubscriptionSchedule#create.default_settingsSubscriptionSchedule#create.phases[].items[]SubscriptionSchedule#create.phases[]SubscriptionSchedule#update.default_settingsSubscriptionSchedule#update.phases[].items[]SubscriptionSchedule#update.phases[]SubscriptionSchedule.default_settingsSubscriptionSchedule.phases[].items[]SubscriptionSchedule.phases[]Subscription

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-03-31.basil
  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.

Changements connexes

  • Remplace les méthodes de l’API Upcoming Invoice par l’API Create Preview Invoice
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