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.
Chaque version du SDK utilise la version de l’API en vigueur au moment de sa publication pour effectuer des requêtes API. Reportez-vous à la page de gestion des versions pour voir comment remplacer cette information.
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 à passer d’anciennes versions majeures du SDK. Vous les trouverez dans la section wiki de nos référentiels SDK GitHub. Le même wiki établit également le mappage entre les versions majeures du SDK et les versions de l’API.
- Wiki du SDK Python
- Wiki du SDK .NET
- Wiki du SDK Java
- Wiki du SDK Go
- Wiki du SDK PHP/wiki
- Wiki du SDK Ruby/wiki
- Wiki du SDK Node.js
Politique de support des versions linguistiques du SDK Stripe
Pour une meilleure prise en charge, à partir de septembre 2025, nous fournirons des informations détaillées sur la durée prévue du support de chaque version de langue et annoncerons à l’avance toutes les suppressions de support à venir.
À mesure que les versions d’une langue atteindront leur fin de vie, nous supprimerons progressivement le support de ces versions du SDK correspondant. Les versions précédentes du SDK continueront de fonctionner comme avant, mais vous devrez mettre à niveau votre runtime pour utiliser la dernière version du SDK.
Lorsqu’une version linguistique arrivera en fin de vie, nous la signalerons comme « obsolète » dans les tableaux ci-dessous et entamerons sa « période de support prolongée ». Pendant cette période, nous continuerons à tester le SDK par rapport à cette version et nous nous assurerons que toutes nos dépendances continuent de fonctionner. La durée exacte de la période de support prolongée varie selon la langue, mais elle est comprise entre 1 et 2 ans.
Lorsque la période de support prolongée pour une version se terminera, le SDK abandonnera son support lors de la prochaine version majeure prévue. Nous annoncerons à l’avance toutes les obsolescences d’exécution sur cette page, dans le fichier README de chaque SDK et dans le journal des modifications de chaque langue.
Même si un SDK peut continuer à fonctionner avec une version linguistique non prise en charge, ne continuez pas à l’utiliser. Les SDK fonctionnant avec des versions non prises en charge peuvent tomber en panne de manière inattendue dans n’importe quelle version, et la cause de cette panne peut ne pas être incluse dans le log des modifications.
Politiques linguistiques
Canal de publication de la version bêta publique
Nous disposons d’un canal public de publication de la version bêta publique, qui utilise des versions bêta de l’API distinctes des versions de disponibilité générale (GA). Par exemple, 2025-04-30. au lieu de 2025-04-30..
Pour accéder aux nouvelles fonctionnalités et améliorations de la version bêta, utilisez les versions de nos SDK qui portent le suffixe beta ou b. Par exemple, 5. en Python et 5. 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 publique dans l’en-tête Stripe-Version, consultez la section **SDK de la version bêta ** dans les fichiers README disponibles dans les référentiels GitHub correspondants.
- Version bêta publique de SDK Python
- Version bêta publique de SDK .NET
- Version bêta publique de SDK Java
- Version bêta publique de Go SDK
- Version bêta publique de SDK PHP
- Version bêta publique de SDK Ruby
- Version bêta publique de SDK Node.js
Canal de diffusion de la version bêta privée
Nous publions également des fonctionnalités en phase de version bêta privée qui nécessitent un accès sur invitation uniquement. Ces fonctionnalités utilisent également les versions bêta de l’API.
Pour accéder aux fonctionnalités et améliorations de la version bêta privée après invitation, utilisez les versions de nos SDK qui ont un suffixe alpha ou a. Par exemple, 5. dans Python et 5. dans d’autres SDK linguistiques.
Pour obtenir les instructions d’installation ou des informations sur la transmission des en-têtes de la version bêta publique dans l’en-tête Stripe-Version, consultez la section SDK de la version bêta privée dans les fichiers README disponibles dans les référentiels GitHub correspondants.