Politique de gestion des versions et de prise en charge Stripe

Comprendre la politique de gestion des versions et de prise en charge Stripe.

Versions de l’API Stripe

À partir de la version 2024-09-30.acacia, Stripe suit un nouveau processus de publication d’API dans lequel nous publions de nouvelles versions d’API tous les mois sans modification importante. Deux fois par an, nous publions une nouvelle version (par exemple acacia) qui commence avec une version de l’API comportant des modifications importantes.

Vous pouvez vous attendre à de nouvelles versions mineures des SDK avec chaque version mensuelle de l’API et à de nouvelles versions majeures des SDK avec chaque version majeure publiée deux fois par an.

Vous pouvez parfois voir une mise à jour de version majeure des SDK avec les mises à jour mensuelles de la version de l’API si les SDK présentent des modifications importantes à intégrer.

Pour découvrir les changements apportés à toute nouvelle version de l’API, consultez les modifications de l’API.

Versions des SDK Stripe

La politique de gestion des versions du SDK de Stripe repose sur la norme de gestion sémantique des versions. Par exemple dans la version 4.3.2, 4 correspond à une modification majeure, 3 à une modification mineure et 2 à un correctif. Quand nous publions une nouvelle version de SDK contenant de nouvelles fonctionnalités ou des corrections de bogues, nous ajoutons 1 à l’un de ces trois composants de version, selon le type de changement introduit.

Majeur. Nous changeons le composant de version majeure lorsque la version contient des changements importants, non rétrocompatibles avec la version la plus récente : la version ajoute un paramètre obligatoire ou modifie un type, une propriété, une méthode ou un paramètre. Par exemple si la version renomme les classes d’exceptions du SDK.
Mineur. Nous changeons le composant de version mineure lorsque la version contient de nouvelles fonctionnalités rétrocompatibles avec la version la plus récente : la version ajoute un nouveau type, une nouvelle propriété, une nouvelle méthode, un nouveau paramètre facultatif ou une nouvelle valeur de paramètre prise en charge. Par exemple si la version clarifie le message de suppression des métadonnées du SDK.
Correctif. Nous changeons le composant de version corrective lorsque la version contient des corrections de bogues rétrocompatibles : la version modifie un comportement, sans changer les types, propriétés, méthodes ou paramètres documentés. Par exemple, la version corrige un bogue à cause duquel les chargements de fichiers n’étaient pas correctement répertoriés.

Vous pouvez tester les nouvelles fonctionnalités et améliorations de la version bêta en utilisant les versions de nos SDK qui portent le suffixe « beta » ou « b » (par exemple, 5.1.0b3 en Python et 5.1.0-beta.3 dans les SDK rédigés dans un autre langage).

Pour obtenir les instructions d’installation ou des informations sur la transmission des en-têtes de la version bêta dans l’en-tête Stripe-Version, consultez les fichiers README disponibles dans les référentiels GitHub correspondants.

Politique de prise en charge des SDK Stripe

Les nouvelles fonctionnalités et corrections de bogues sont publiées sur la dernière version majeure d’un SDK. Si vous utilisez une ancienne version majeure du SDK, nous vous recommandons de passer à la version majeure la plus récente pour bénéficier de ces fonctionnalités et corrections de bogues. Les anciennes versions majeures du paquet restent disponibles, mais ne reçoivent plus aucune mise à jour.

Guides de migration

Nous fournissons des guides de migration pour vous aider à effectuer une mise à niveau à partir d’anciennes versions majeures de SDK. Vous les trouverez dans la section Wiki de nos référentiels SDK GitHub.

Voir aussi

Définir une version de l’API Stripe