# 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](https://docs.stripe.com/api/invoiceitems.md?api-version=2025-08-27.basil) générés par les [abonnements](https://docs.stripe.com/api/subscriptions.md?api-version=2025-08-27.basil) et les [planifications d’abonnement](https://docs.stripe.com/api/subscription_schedules.md?api-version=2025-08-27.basil) :. - 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](https://docs.stripe.com/api/subscriptions/create.md?api-version=2025-08-27.basil) ou [mettre à jour](https://docs.stripe.com/api/subscriptions/update.md?api-version=2025-08-27.basil) des Abonnement - [Créez](https://docs.stripe.com/api/subscription_schedules/create.md?api-version=2025-08-27.basil) ou [mettez à jour](https://docs.stripe.com/api/subscription_schedules/update.md?api-version=2025-08-27.basil) des planifications. - [Créez](https://docs.stripe.com/api/invoices/create_preview.md?api-version=2025-08-27.basil) un aperçu de la facture en spécifiant le paramètre `schedule_details`. ## Modifications #### API REST #### Ruby #### Python #### PHP Cette modification n’affecte pas le SDK PHP. #### Java #### Node.js #### Go #### .NET ## Mise à niveau #### API REST 1. [Consultez la version actuelle de votre API](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench) dans Workbench. 1. 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](https://docs.stripe.com/api/versioning.md) pour inclure la `version Stripe : 2025-08-27.basil` 1. Mettez à niveau la version de l’API utilisée pour les [endpoints de webhook](https://docs.stripe.com/webhooks/versioning.md). 1. [Testez votre intégration](https://docs.stripe.com/testing.md) avec la nouvelle version. 1. Si vous utilisez Connect, [testez votre intégration Connect](https://docs.stripe.com/connect/testing.md). 1. [Effectuez la mise à niveau](https://docs.stripe.com/upgrades.md#perform-the-upgrade) dans Workbench. Vous pourrez [revenir à la version précédente](https://docs.stripe.com/upgrades.md#roll-back-your-api-version) pendant 72 heures. En savoir plus sur les [mises à niveau de l’API Stripe](https://docs.stripe.com/upgrades.md). #### Ruby 1. [Consultez la version actuelle de votre API](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench) dans Workbench. 1. Mettez à niveau votre SDK Ruby vers [v15.5.0](https://github.com/stripe/stripe-ruby/releases/tag/v15.5.0) 1. Mettez à niveau la version de l’API utilisée pour les [endpoints de webhook](https://docs.stripe.com/webhooks/versioning.md). 1. [Testez votre intégration](https://docs.stripe.com/testing.md) avec la nouvelle version. 1. Si vous utilisez Connect, [testez votre intégration Connect](https://docs.stripe.com/connect/testing.md). 1. [Effectuez la mise à niveau](https://docs.stripe.com/upgrades.md#perform-the-upgrade) dans Workbench. Vous pourrez [revenir à la version précédente](https://docs.stripe.com/upgrades.md#roll-back-your-api-version) pendant 72 heures. En savoir plus sur les [mises à niveau de l’API Stripe](https://docs.stripe.com/upgrades.md). #### Python 1. [Consultez la version actuelle de votre API](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench) dans Workbench. 1. Mettez à niveau votre SDK Python vers [v12.5.0](https://github.com/stripe/stripe-python/releases/tag/v12.5.0) 1. Mettez à niveau la version de l’API utilisée pour les [endpoints de webhook](https://docs.stripe.com/webhooks/versioning.md). 1. [Testez votre intégration](https://docs.stripe.com/testing.md) avec la nouvelle version. 1. Si vous utilisez Connect, [testez votre intégration Connect](https://docs.stripe.com/connect/testing.md). 1. [Effectuez la mise à niveau](https://docs.stripe.com/upgrades.md#perform-the-upgrade) dans Workbench. Vous pourrez [revenir à la version précédente](https://docs.stripe.com/upgrades.md#roll-back-your-api-version) pendant 72 heures. En savoir plus sur les [mises à niveau de l’API Stripe](https://docs.stripe.com/upgrades.md). #### PHP 1. [Consultez la version actuelle de votre API](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench) dans Workbench. 1. Mettez à niveau votre SDK PHP vers [v17.6.0](https://github.com/stripe/stripe-php/releases/tag/v17.6.0) 1. Mettez à niveau la version de l’API utilisée pour les [endpoints de webhook](https://docs.stripe.com/webhooks/versioning.md). 1. [Testez votre intégration](https://docs.stripe.com/testing.md) avec la nouvelle version. 1. Si vous utilisez Connect, [testez votre intégration Connect](https://docs.stripe.com/connect/testing.md). 1. [Effectuez la mise à niveau](https://docs.stripe.com/upgrades.md#perform-the-upgrade) dans Workbench. Vous pourrez [revenir à la version précédente](https://docs.stripe.com/upgrades.md#roll-back-your-api-version) pendant 72 heures. En savoir plus sur les [mises à niveau de l’API Stripe](https://docs.stripe.com/upgrades.md). #### Java 1. [Consultez la version actuelle de votre API](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench) dans Workbench. 1. Mettez à niveau votre SDK Java vers [v29.5.0](https://github.com/stripe/stripe-java/releases/tag/v29.5.0) 1. Mettez à niveau la version de l’API utilisée pour les [endpoints de webhook](https://docs.stripe.com/webhooks/versioning.md). 1. [Testez votre intégration](https://docs.stripe.com/testing.md) avec la nouvelle version. 1. Si vous utilisez Connect, [testez votre intégration Connect](https://docs.stripe.com/connect/testing.md). 1. [Effectuez la mise à niveau](https://docs.stripe.com/upgrades.md#perform-the-upgrade) dans Workbench. Vous pourrez [revenir à la version précédente](https://docs.stripe.com/upgrades.md#roll-back-your-api-version) pendant 72 heures. En savoir plus sur les [mises à niveau de l’API Stripe](https://docs.stripe.com/upgrades.md). #### Node.js 1. [Consultez la version actuelle de votre API](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench) dans Workbench. 1. Mettez à niveau votre SDK Node vers [v18.5.0](https://github.com/stripe/stripe-node/releases/tag/v18.5.0) 1. Mettez à niveau la version de l’API utilisée pour les [endpoints de webhook](https://docs.stripe.com/webhooks/versioning.md). 1. [Testez votre intégration](https://docs.stripe.com/testing.md) avec la nouvelle version. 1. Si vous utilisez Connect, [testez votre intégration Connect](https://docs.stripe.com/connect/testing.md). 1. [Effectuez la mise à niveau](https://docs.stripe.com/upgrades.md#perform-the-upgrade) dans Workbench. Vous pourrez [revenir à la version précédente](https://docs.stripe.com/upgrades.md#roll-back-your-api-version) pendant 72 heures. En savoir plus sur les [mises à niveau de l’API Stripe](https://docs.stripe.com/upgrades.md). #### Go 1. [Consultez la version actuelle de votre API](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench) dans Workbench. 1. Mettez à niveau votre SDK Go vers [v82.5.0](https://github.com/stripe/stripe-go/releases/tag/v82.5.0) 1. Mettez à niveau la version de l’API utilisée pour les [endpoints de webhook](https://docs.stripe.com/webhooks/versioning.md). 1. [Testez votre intégration](https://docs.stripe.com/testing.md) avec la nouvelle version. 1. Si vous utilisez Connect, [testez votre intégration Connect](https://docs.stripe.com/connect/testing.md). 1. [Effectuez la mise à niveau](https://docs.stripe.com/upgrades.md#perform-the-upgrade) dans Workbench. Vous pourrez [revenir à la version précédente](https://docs.stripe.com/upgrades.md#roll-back-your-api-version) pendant 72 heures. En savoir plus sur les [mises à niveau de l’API Stripe](https://docs.stripe.com/upgrades.md). #### .NET 1. [Consultez la version actuelle de votre API](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench) dans Workbench. 1. Mettez à niveau votre SDK .NET vers [v48.5.0](https://github.com/stripe/stripe-dotnet/releases/tag/v48.5.0) 1. Mettez à niveau la version de l’API utilisée pour les [endpoints de webhook](https://docs.stripe.com/webhooks/versioning.md). 1. [Testez votre intégration](https://docs.stripe.com/testing.md) avec la nouvelle version. 1. Si vous utilisez Connect, [testez votre intégration Connect](https://docs.stripe.com/connect/testing.md). 1. [Effectuez la mise à niveau](https://docs.stripe.com/upgrades.md#perform-the-upgrade) dans Workbench. Vous pourrez [revenir à la version précédente](https://docs.stripe.com/upgrades.md#roll-back-your-api-version) pendant 72 heures. En savoir plus sur les [mises à niveau de l’API Stripe](https://docs.stripe.com/upgrades.md). ## Changements connexes - [Ajoute un champ de nom à l’objet de configuration du portail client](https://docs.stripe.com/changelog/basil/2025-08-27/customer-portal-config-name.md) - [Ajoute la prise en charge de la taxe tierce sur les abonnements en mode de facturation flexible](https://docs.stripe.com/changelog/basil/2025-08-27/3p-tax.md)