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 possède une version d’API par défaut qui détermine comment vous appelez l’API, les fonctionnalités auxquelles vous avez accès et ce que vous êtes assuré de recevoir dans la réponse. Cependant, lorsque vous utilisez nos SDK côté serveur, vos appels d’API vers Stripe utilisent la version d’API qui était courante au moment de la publication du SDK. Vous ne pouvez pas cibler une version différente lorsque vous utilisez un langage fortement typé comme Java, Go ou .NET.

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-11-17.clover'

Ou définissez la version par requête :

require 'stripe'
intent = Stripe::PaymentIntent.retrieve(
  'pi_1DlIVK2eZvKYlo2CW4yj5l2C',
  {
    stripe_version: '2025-11-17.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 :

Vous pouvez mettre à niveau la version d’API par défaut de votre compte dans Workbench. Mettez à jour votre code pour utiliser la dernière version du SDK et définissez la nouvelle version d’API lors de vos appels.

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