# 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. #### Ruby ### Configuration de la version d’API La bibliothèque 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 utiliseront 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' Stripe.api_key = <> Stripe.api_version = '2026-03-25.dahlia' ``` Ou définissez la version par requête : ```ruby require 'stripe' intent = Stripe::PaymentIntent.retrieve( 'pi_1DlIVK2eZvKYlo2CW4yj5l2C', { stripe_version: '2026-03-25.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 ### Configuration de la version d’API La bibliothèque 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 utiliseront 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 à la [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 stripe.api_key = <> stripe.api_version = '2026-03-25.dahlia' ``` Ou définissez la version par requête : ```python import stripe intent = stripe.PaymentIntent.retrieve( "pi_1DlIVK2eZvKYlo2CW4yj5l2C", stripe_version="2026-03-25.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 ### Configuration de la version d’API La bibliothèque 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 utiliseront 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([ "api_key" => "<>", "stripe_version" => "2026-03-25.dahlia" ]); ``` Ou définissez la version par requête : ```php $intent = $stripe->paymentIntents->capture( 'pi_1DlIVK2eZvKYlo2CW4yj5l2C', [], ['stripe_version' => '2026-03-25.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 ### Configuration de la version d’API Java étant un langage de programmation fortement typé, la version de l’API utilisée dans le SDK est *fixe* : elle 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 ### Configuration de la version d’API La bibliothèque 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 utiliseront 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 const stripe = require('stripe')('<>', { apiVersion: '2026-03-25.dahlia', }); ``` Ou définissez la version par requête : ```javascript const intent = await stripe.paymentIntents.retrieve('pi_1DlIVK2eZvKYlo2CW4yj5l2C', { apiVersion: '2026-03-25.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-la en tant que `new Stripe()` avec la dernière version de l’API. ```javascript import Stripe from 'stripe'; const stripe = new Stripe('<>', { apiVersion: '2026-03-25.dahlia' }); ``` #### Go ### Configuration de la version d’API Go étant un langage de programmation fortement typé, la version de l’API utilisée dans le SDK est *fixe* : elle 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 ### Configuration de la version d’API C\# étant un langage de programmation fortement typé, la version de l’API utilisée dans le SDK .NET est *fixe* : elle 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-03-25.dahlia" ``` #### Interface de ligne de commande Stripe ```sh stripe charges create --stripe-version 2026-03-25.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)