Stripe のバージョン管理とサポートに関するポリシー

Stripe のバージョン管理とサポートに関するポリシーについてご紹介します。

Stripe API バージョン

2024-09-30.acacia リリース以降、Stripe は、新しい API リリースのプロセスに従い、大きな変更なしに新しい API バージョンをリリースしています。年 2 回、新しいリリース (acacia など) を発行し、最初の API バージョンには対応処理が必要な変更が行われます。

SDK の新しいマイナーバージョンは毎月の API バージョンで提供され、SDK の新しいメジャーバージョンは年 2 回のメジャーリリースで提供されます。

SDK の出荷に対応処理が必要な変更が伴う場合、SDK のメジャーバージョンの更新のほか、毎月の API バージョンの更新が行われることがあります。

新しい API バージョンの予定については、API のアップグレードをご覧ください。

Stripe SDK バージョン

Stripe の SDK バージョン管理ポリシーは、セマンティックバージョニング標準に基づいています。たとえば、バージョン 4.3.2 では、4 が「メジャー」、3 が「マイナー」、2 が「パッチ」を表します。Stripe が新機能やバグ修正のために新しい SDK バージョンをリリースする際には、導入される変更のタイプに応じて、これら 3 つのバージョンコンポーネントのいずれかが増分されます。

メジャー。最新バージョンとの後方互換性がない、対応が必要な変更がバージョンに含まれる場合は、「メジャー」バージョンコンポーネントが増分されます (必須パラメーターの追加や、タイプ、プロパティ、メソッド、パラメーターの変更)。たとえば、SDK の例外クラスの名前の変更がこれに含まれます。
マイナー。最新バージョンとの後方互換性がある新機能がバージョンに含まれる場合は、「マイナー」バージョンコンポーネントが増分されます (新しいタイプ、プロパティ、メソッド、オプションのパラメーター、またはサポートされるパラメーター値の追加)。たとえば、SDK のメタデータ削除メッセージの明確化がこれに含まれます。
パッチ。バージョンに後方互換性のあるバグ修正が含まれる場合は、「パッチ」バージョンコンポーネントが増分されます (修正してもドキュメント化された型、プロパティ、メソッド、パラメーターを変更することのない、動作の変更)。たとえば、ファイルのアップロードが正しくリストされないバグの修正がこれに含まれます。

各SDKバージョンは、そのリリース時点での最新のAPIバージョンを使用してAPIリクエストを行います。これを上書きする方法については、バージョン管理ページを参照してください。

Stripe SDK のサポートポリシー

新機能とバグ修正は、SDK の最新の「メジャー」バージョンでリリースされます。以前の「メジャー」 SDK バージョンをご使用の場合は、新機能とバグ修正を利用するために、最新のメジャーバージョンにアップグレードすることをお勧めします。以前のメジャーバージョンのパッケージは引き続き使用できますが、追加の更新は提供されません。

移行ガイド

古い主要SDKバージョンからのアップグレードを支援するための移行ガイドを提供しています。これらは SDK GitHub リポジトリの wiki セクションで見つけることができます。同じ wiki には、SDK メジャーバージョンと API バージョン間のマッピングも含まれています。

Stripe SDK 言語バージョンサポートポリシー

予測可能性を高めるため、2025 年 9 月現在、各言語バージョンのサポート予定期間の詳細を提供し、今後予定されているすべてのサポート終了を事前発表します。

言語のバージョンがサポート終了ステータスに達すると、対応する SDK からそれらのバージョンのサポートが徐々に終了します。以前リリースされた SDK バージョンは、これまでどおり引き続き機能しますが、最新の SDK バージョンを使用するにはランタイムをアップグレードする必要があります。

言語バージョンがサポート終了になると、以下の表で「非推奨」としてマークされ、「延長サポート期間」が開始されます。この期間中、SDK をそのバージョンに対してテストし、すべての依存関係が引き続き機能することを確認します。延長サポート期間の正確な長さは言語によって異なりますが、すべて1年から2年です。

対応するバージョンの延長サポート期間が終了すると、SDKは、次に予定されているメジャーバージョンの一部としてサポートを終了します。このページ、各 SDK の README、各言語の変更ログで、ランタイムに関するすべての非推奨が事前にアナウンスされます。

SDK might continue がサポートされていない言語バージョンで動作し続ける可能性はありますが、使用を続けないでください。サポート対象外のバージョンで実行される SDK は、リリースのたびに予期せず動作しなくなることがあり、その不具合の原因が変更履歴に記載されない場合もあります。

言語ポリシー

_Python 3.7以降 _ をサポートします。これには、現在セキュリティサポートを受けている Python のすべてのバージョンと、延長サポート期間内のバージョンが含まれます。

サポート終了日に達した Python バージョンは、対応する期間を 1 年 延長します (2 つのメジャー API リリース)。毎年 3 月の API リリースをもって、サポート対象の最も古い Python バージョンのサポートを終了します。

非推奨スケジュール

Python バージョン	ステータス	使用終了	サポート終了	Last Compatible SDK	備考
3.10	サポート対象	2026 年10 月	2028 年 3 月	未定
3.9	サポート対象	2025 年 10 月	2027 年 3 月	未定
3.8	非推奨	2024 年 10 月	2026 年 3 月	未定	3.8 は、このポリシーで定義されているスケジュールでサポートが終了した最初のバージョンです。
3.7	非推奨	2023 年 6 月	2026 年 3 月	未定	このポリシーへの移行を容易にするために、3.7 のサポート期間を延長し、ユーザーが統合を更新するための時間を確保します。
3.6	サポート対象外	2021 年 12 月	2025 年 9 月	`v12.5.1`	3.6 を廃止する決定は、このポリシーより前のものであり、結果として上記のパターンに従っていません。

パブリックプレビューリリースチャンネル

私たちは、パブリックプレビューリリースチャンネルを持っており、これは一般提供（GA）バージョンとは異なるプレビュー APIバージョンを使用します。例えば、2025-04-30.previewの代わりに2025-04-30.basil。

プレビューステージの新機能や強化にアクセスするには、betaまたはbサフィックスが付いたSDKのバージョンを使用してください。例えば、Pythonでは5.1.0b3、他の言語のSDKでは5.1.0-beta.3です。

インストール手順や、Stripe-Versionヘッダーでプレビューヘッダーを渡すことについての詳細は、各SDK GitHubリポジトリのREADMEファイル内のパブリックプレビューSDKセクションを参照してください。

プライベートプレビュー版のリリースチャンネル

また、招待制の限定的なアクセスを必要とするプライベートプレビュー段階の機能も公開されています。これらの機能もプレビュー API バージョンを使用します。

招待を受けた後にプライベートプレビューの機能と拡張機能にアクセスするには、alpha または a の接尾辞がついた SDK のバージョンを使用します。たとえば、Pythonでは5.1.0a3、その他の言語 SDK では5.1.0-alpha.3 を使用します。

インストール方法や、Stripe-Version ヘッダーでプレビューヘッダーを渡す方法についての詳細は、各 SDK の GitHub リポジトリにある README ファイル内の プライベートプレビュー SDK セクションを参照してください。

参照情報

Webhook のバージョン管理を処理する