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

La politique de gestion des versions des API Stripe fonctionne par date de publication. Par exemple : 15/01/2023. Nous publions les nouvelles versions de l’API en même temps que les nouvelles versions du SDK. Pour comprendre ce qu’implique une nouvelle version de l’API, consultez la page Mises à niveau 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.

Versions bêta des SDK Stripe

Vous pouvez accéder à certains produits et fonctionnalités Stripe au stade bêta avec les SDK bêta. Les versions de ces SDK bêta présentent le suffixe beta ou b, par exemple, 5.1.0b3 dans Python et 5.1.0-beta.3 dans les SDK d’autres langages. Essayez ces SDK en version bêta et faites-nous part de vos commentaires avant que les fonctionnalités n’atteignent la phase stable. Pour en savoir plus sur l’utilisation des SDK bêta, lisez le fichier readme dans le référentiel GitHub des SDK de chaque langue.

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