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

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

Stripe API バージョン

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

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

SDK のメジャーバージョン更新が、月次の API バージョン更新と同時期に行われることがあります。これは、SDK に互換性に関わる変更を含める必要がある場合に発生します。

API の現行バージョンは 2025-12-15.clover です。

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

組織の API キー

組織の API キーを使用して行われるすべての API リクエストには、組織のシステム全体で一貫性と予測可能性を保持するために Stripe-Version ヘッダーを含める必要があります。

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 言語ランタイムバージョンサポートポリシー

プログラミング言語のランタイムバージョンがサポート終了を迎えると、弊社は以下の表でそのバージョンを「非推奨」とマークし、延長サポート期間を開始します。この延長サポート期間の正確な長さは言語によって異なりますが、期間は通常 1 年から 2 年の範囲です。

ある言語バージョンの延長サポート期間が終了した後、SDK の次のメジャーバージョンは、その言語バージョンをサポートしなくなります。ただし、SDK のそれ以前のバージョンは、引き続きそれらの古い言語バージョンと互換性があります。弊社は、すべてのランタイムの非推奨化について、このページ、各 SDK の README、および各言語の変更履歴にて、事前に告知します。

警告

SDK は、サポートされていない言語バージョン上でも 動作し続ける 可能性はありますが、使用を継続しないでください。サポート対象外のバージョンで動作する 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.basil の代わりに 2025-04-30.preview を利用しています。現在のプレビュー API バージョンは**2025-12-15.preview**です。

プレビューステージの新機能や強化にアクセスするには、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 のバージョン管理を処理する