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
Stripe pour Visual Studio Code
Terraform
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
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-08-27.basil

Remarque

Cette page n'est pas encore disponible dans cette langue. Nous faisons tout notre possible pour proposer notre documentation dans davantage de langues et nous vous fournirons la version traduite dès qu'elle sera disponible.

Ajoute la prise en charge des métadonnées des postes de facture et de la période dans les abonnements et les planifications

Nouveautés

Nous avons introduit une nouvelle façon de personnaliser les champs de metadata et de period pour les postes de facture générés par les abonnements et les planifications d’abonnement :.

  • Vous pouvez joindre directement des metadata lors de la configuration d’add_invoice_items, ce qui élimine la nécessité d’ajouter ces informations ultérieurement lors d’appels à l’API ultérieurs et distincts.

  • Vous pouvez spécifier des dates period.start et period.end personnalisées qui rectification les dates par défaut du cycle de facturation des abonnements. Cela vous donne un contrôle précis sur les périodes de comptabilisation des revenus pour les paiements ponctuels. Nous avons également inclus des indicateurs d’horodatage (tels que max_item_period_start et min_item_period_end pour Subscriptions, phase_start et phase_end pour les planifications). Cela vous aide à aligner les dates sur les horodatages importants tels que les périodes de facturation des abonnements ou les dates de phase de planification d’abonnement.

Impact

Spécifiez les metadata ou le champ de period pour add_invoice_items à l’aide des endpoints d’API suivants :

  • Créer ou mettre à jour des Abonnement
  • Créez ou mettez à jour des planifications.
  • Créez un aperçu de la facture en spécifiant le paramètre schedule_details.

Modifications

paramètresModifierRessources ou endpoints
metadataperiodAjouté
Invoice#create_preview.schedule_details.phases[].add_invoice_items[]Subscription#create.add_invoice_items[]Subscription#update.add_invoice_items[]
 + 3 de plus
SubscriptionSchedule.phases[].add_invoice_items[]SubscriptionSchedule#create.phases[].add_invoice_items[]SubscriptionSchedule#update.phases[].add_invoice_items[]

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-08-27.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

  • Ajoute un champ de nom à l’objet de configuration du portail client
  • Ajoute la prise en charge de la taxe tierce sur les abonnements en mode de facturation flexible
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