Définir une version de l'API Stripe

Suivez ces instructions pour garantir la cohérence des versions d'API dans l'ensemble de votre intégration Stripe.

Your account has a default API version, which defines how you call the API, what functionality you have access to, and what you’re guaranteed to get back as part of the response. However, when using our server-side SDKs, your API calls to Stripe use the API version that was current when the SDK was released. You can’t target a different version when using a strongly typed language such as Java, Go, or .NET.

To set an API version when using curl or Stripe CLI instead of an SDK, refer to our versioning page.

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 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 :

require 'stripe'
Stripe.api_key =sk_test_BQokikJOvBiI2HlWgH4olfQ2
Stripe.api_version = '2025-10-29.clover'

Ou définissez la version par requête :

require 'stripe'
intent = Stripe::PaymentIntent.retrieve(
  'pi_1DlIVK2eZvKYlo2CW4yj5l2C',
  {
    stripe_version: '2025-10-29.clover',
  }
)
intent.capture

Remarque

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.

Mise à niveau de la version de votre API

Avant de mettre à niveau la version de votre API, consultez attentivement les ressources suivantes :

You can upgrade your account’s default API version in Workbench. Update your code to use the latest version of the SDK and set the new API version when making your calls.

Voir aussi

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