# Définir une version de l'API Stripe Suivez ces instructions pour cibler une version d’API différente de celle utilisée par vos SDK. Votre compte dispose d’une [version d’API par défaut](https://docs.stripe.com/upgrades.md#how-can-i-upgrade-my-api), qui définit la manière dont vous appelez l’API, les fonctionnalités auxquelles vous avez accès et les éléments que la réponse est garantie de contenir. Toutefois, lorsque vous utilisez nos [SDK côté serveur](https://docs.stripe.com/sdks.md#server-side-libraries), vos appels d’API à Stripe utilisent la version de l’API en vigueur au moment de la publication du SDK. Vous ne pouvez pas cibler une autre version lorsque vous utilisez un langage fortement typé tel que Java, Go ou .NET. ### Définissez la version de l’API #### Ruby La bibliothèque [stripe-ruby](https://github.com/stripe/stripe-ruby) vous permet de définir la version de l’API globalement ou par requête. Si vous ne définissez pas de version d’API, les versions récentes de stripe-ruby utilisent la version d’API la plus récente au moment de la publication de votre version de stripe-ruby. Les versions de stripe-ruby antérieures à la [v9](https://github.com/stripe/stripe-ruby/blob/master/CHANGELOG.md#900---2023-08-16) utilisent la version d’API par défaut de votre compte. Pour définir la version de l’API de manière **globale** avec le SDK, attribuez la version à la propriété `Stripe.api_version` : ```ruby require 'stripe' # Don't put any keys in code. See /keys-best-practices. client = Stripe::StripeClient.new('<>', stripe_version: '2026-08-26.dahlia') ``` Ou définissez la version par requête : ```ruby require 'stripe' # Don't put any keys in code. See /keys-best-practices. client = Stripe::StripeClient.new('<>') intent = client.v1.payment_intents.retrieve( 'pi_1DlIVK2eZvKYlo2CW4yj5l2C', { stripe_version: '2026-08-26.dahlia', }, ) intent.capture ``` > Lorsque vous remplacez la version globalement ou par requête, les objets de réponse de l’API sont également renvoyés dans cette version. #### Python La bibliothèque [stripe-python](https://github.com/stripe/stripe-python) vous permet de définir la version de l’API globalement ou par requête. Si vous ne définissez pas de version d’API, les versions récentes de stripe-python utilisent la version d’API la plus récente au moment de la publication de votre version de stripe-python. Les versions de stripe-python antérieures à [v6](https://github.com/stripe/stripe-python/blob/master/CHANGELOG.md#600---2023-08-16) utilisent la version d’API par défaut de votre compte. Pour définir la version de l’API de manière **globale** avec le SDK, attribuez la version à la propriété `Stripe.api_version` : ```python import stripe # Don't put any keys in code. See /keys-best-practices. stripe.api_key = <> stripe.api_version = '2026-08-26.dahlia' ``` Ou définissez la version par requête : ```python import stripe intent = stripe.PaymentIntent.retrieve( "pi_1DlIVK2eZvKYlo2CW4yj5l2C", stripe_version="2026-08-26.dahlia", ) intent.capture() ``` > Lorsque vous remplacez la version globalement ou par requête, les objets de réponse de l’API sont également renvoyés dans cette version. #### PHP La bibliothèque [stripe-php](https://github.com/stripe/stripe-php) vous permet de définir la version de l’API globalement ou par requête. Si vous ne définissez pas de version d’API, les versions récentes de stripe-php utilisent la version d’API la plus récente au moment de la publication de votre version de stripe-php. Les versions de stripe-php antérieures à la [v11](https://github.com/stripe/stripe-php/blob/master/CHANGELOG.md#1100---2023-08-16) utilisent la version d’API par défaut de votre compte. Pour définir la version de l’API de manière **globale** avec le SDK, transmettez la version à la méthode `\Stripe\Stripe::setApiVersion()` : ```php $stripe = new \Stripe\StripeClient([ // Don't put any keys in code. See /keys-best-practices. "api_key" => "<>", "stripe_version" => "2026-08-26.dahlia" ]); ``` Ou définissez la version par requête : ```php $intent = $stripe->paymentIntents->capture( 'pi_1DlIVK2eZvKYlo2CW4yj5l2C', [], ['stripe_version' => '2026-08-26.dahlia'] ); ``` > Lorsque vous remplacez la version globalement ou par requête, les objets de réponse de l’API sont également renvoyés dans cette version. #### Java Comme Java est un langage de programmation fortement typé, la version de l’API utilisée dans le SDK est *fixe* et correspond à la dernière version de l’API au moment de la publication du SDK. Nous vous déconseillons de définir une version d’API différente pour les langages de programmation fortement typés, car les objets de réponse peuvent ne pas correspondre aux types forts dans le SDK et entraîner l’échec des requêtes. Par exemple, si la version de l’API que vous ciblez nécessite des paramètres qui ne sont pas présents dans les types de SDK, la requête échoue. #### Node La bibliothèque [stripe-node](https://github.com/stripe/stripe-node) vous permet de définir la version de l’API globalement ou par requête. Si vous ne définissez pas de version d’API, les versions récentes de stripe-node utilisent la version d’API la plus récente au moment de la publication de votre version de stripe-node. Les versions de stripe-node antérieures à la [v12](https://github.com/stripe/stripe-node/blob/master/CHANGELOG.md#1200---2023-04-06) utilisent la version d’API par défaut de votre compte. Pour définir la version de l’API de manière **globale** avec le SDK, fournissez l’option `apiVersion` : ```javascript // Don't put any keys in code. See /keys-best-practices. const stripe = require('stripe')('<>', { apiVersion: '2026-08-26.dahlia', }); ``` Ou définissez la version par requête : ```javascript const intent = await stripe.paymentIntents.retrieve('pi_1DlIVK2eZvKYlo2CW4yj5l2C', { apiVersion: '2026-08-26.dahlia', }); ``` #### Utilisation de Typescript Les types TypeScript reflètent la dernière version de l’API au moment de la publication. Cette version est encodée dans le [fichier API_VERSION](https://github.com/stripe/stripe-node/blob/master/API_VERSION). Importez Stripe en mode d’importation par défaut et instanciez-le en tant que `new Stripe()` avec la dernière version de l’API. ```javascript import Stripe from 'stripe'; const stripe = new Stripe('<>', { apiVersion: '2026-08-26.dahlia' }); ``` #### Go Comme Go est un langage de programmation fortement typé, la version de l’API utilisée dans le SDK est *fixe* et correspond à la dernière version de l’API au moment de la publication du SDK. Nous vous déconseillons de définir une version d’API différente pour les langages de programmation fortement typés, car les objets de réponse peuvent ne pas correspondre aux types forts dans le SDK et entraîner l’échec des requêtes. Par exemple, si la version de l’API que vous ciblez nécessite des paramètres qui ne sont pas présents dans les types de SDK, la requête échoue. #### .NET Comme C# est un langage de programmation fortement typé, la version de l’API utilisée dans le SDK .NET est *fixe* et correspond à la dernière version de l’API au moment de la publication du SDK. Nous vous déconseillons de définir une version d’API différente pour les langages de programmation fortement typés, car les objets de réponse peuvent ne pas correspondre aux types forts dans le SDK et entraîner l’échec des requêtes. Par exemple, si la version de l’API que vous ciblez nécessite des paramètres qui ne sont pas présents dans les types de SDK, la requête échoue. #### cURL ```sh curl https://api.stripe.com/v1/charges \ -u <>: \ -H "Stripe-Version: 2026-08-26.dahlia" ``` #### Interface de ligne de commande Stripe ```sh stripe charges create --stripe-version 2026-08-26.dahlia ``` ### Mise à niveau de la version de votre API Avant de mettre à niveau [la version de votre API](https://docs.stripe.com/upgrades.md#how-can-i-upgrade-my-api), consultez attentivement les ressources suivantes : - [Liste des modifications de l’API Stripe](https://docs.stripe.com/changelog.md) - [Afficher les versions de l’API utilisées par les requêtes API](https://docs.stripe.com/workbench/guides.md#view-api-versions) Vous pouvez mettre à niveau la version d’API par défaut de votre compte dans [Workbench](https://dashboard.stripe.com/workbench/overview). Mettez à jour votre code pour utiliser la dernière version du SDK et définissez la nouvelle version d’API lors de vos appels. ## See also Les SDK Stripe suivent leur propre politique de gestion des versions. Consultez le lien ci-dessous pour en savoir plus. - [Politiques de prise en charge et de gestion des versions Stripe](https://docs.stripe.com/sdks/versioning.md)