# Stripe のバージョン管理とサポートに関するポリシー Stripe のバージョン管理とサポートに関するポリシーについてご紹介します。 ## Stripe API バージョン 2024-09-30.acacia リリース以降、Stripe は、[新しい API リリースのプロセス](https://stripe.com/blog/introducing-stripes-new-api-release-process)に従い、大きな変更なしに新しい API バージョンをリリースしています。年 2 回、新しいリリース (`acacia` など) を発行し、最初の API バージョンには対応処理が必要な変更が行われます。 SDK の新しいマイナーバージョンは毎月の API バージョンで提供され、SDK の新しいメジャーバージョンは年 2 回のメジャーリリースで提供されます。 SDK のメジャーバージョン更新が、月次の API バージョン更新と同時期に行われることがあります。これは、SDK に互換性に関わる変更を含める必要がある場合に発生します。 API の現行バージョンは **2026-03-25.dahlia** です。 新しい API バージョンの予定については、[API のアップグレード](https://docs.stripe.com/upgrades.md)をご覧ください。 ### 組織の API キー [組織の API キー](https://docs.stripe.com/keys.md#organization-api-keys)を使用して行われるすべての API リクエストには、組織のシステム全体で一貫性と予測可能性を保持するために `Stripe-Version` ヘッダーを含める必要があります。 ## Stripe SDK バージョン Stripe の SDK バージョン管理ポリシーは、セマンティックバージョニング標準に基づいています。たとえば、バージョン 4.3.2 では、4 が「メジャー」、3 が「マイナー」、2 が「パッチ」を表します。Stripe が新機能やバグ修正のために新しい SDK バージョンをリリースする際には、導入される変更のタイプに応じて、これら 3 つのバージョンコンポーネントのいずれかが増分されます。 - **メジャー**。最新バージョンとの後方互換性がない、対応が必要な変更がバージョンに含まれる場合は、「メジャー」バージョンコンポーネントが増分されます (必須パラメーターの追加や、タイプ、プロパティ、メソッド、パラメーターの変更)。たとえば、SDK の例外クラスの名前の変更がこれに含まれます。 - **マイナー**。最新バージョンとの後方互換性がある新機能がバージョンに含まれる場合は、「マイナー」バージョンコンポーネントが増分されます (新しいタイプ、プロパティ、メソッド、オプションのパラメーター、またはサポートされるパラメーター値の追加)。たとえば、SDK のメタデータ削除メッセージの明確化がこれに含まれます。 - **パッチ**。バージョンに後方互換性のあるバグ修正が含まれる場合は、「パッチ」バージョンコンポーネントが増分されます (修正してもドキュメント化された型、プロパティ、メソッド、パラメーターを変更することのない、動作の変更)。たとえば、ファイルのアップロードが正しくリストされないバグの修正がこれに含まれます。 各SDKバージョンは、そのリリース時点での最新のAPIバージョンを使用してAPIリクエストを行います。これを上書きする方法については、[バージョン管理ページ](https://docs.stripe.com/api/versioning.md)を参照してください。 ## Stripe SDK のサポートポリシー 新機能とバグ修正は、SDK の最新の「メジャー」バージョンでリリースされます。以前の「メジャー」 SDK バージョンをご使用の場合は、新機能とバグ修正を利用するために、最新のメジャーバージョンにアップグレードすることをお勧めします。以前のメジャーバージョンのパッケージは引き続き使用できますが、追加の更新は提供されません。 ### 移行ガイド 古い主要SDKバージョンからのアップグレードを支援するための移行ガイドを提供しています。これらは SDK GitHub リポジトリの wiki セクションで見つけることができます。同じ wiki には、SDK メジャーバージョンと API バージョン間のマッピングも含まれています。 - [Python SDK wiki](https://github.com/stripe/stripe-python/wiki) - [.NET SDK wiki](https://github.com/stripe/stripe-dotnet/wiki) - [Java SDK wiki](https://github.com/stripe/stripe-java/wiki) - [Go SDK wiki](https://github.com/stripe/stripe-go/wiki) - [PHP SDK wiki](https://github.com/stripe/stripe-php/wiki) - [Ruby SDK wiki](https://github.com/stripe/stripe-ruby/wiki) - [Node.js SDK wiki](https://github.com/stripe/stripe-node/wiki) ## Stripe SDK 言語ランタイムバージョンサポートポリシー プログラミング言語のランタイムバージョンがサポート終了を迎えると、弊社は以下の表でそのバージョンを「非推奨」とマークし、延長サポート期間を開始します。この延長サポート期間の正確な長さは言語によって異なりますが、期間は通常 1 年から 2 年の範囲です。 ある言語バージョンの延長サポート期間が終了した後、SDK の次のメジャーバージョンは、その言語バージョンをサポートしなくなります。ただし、SDK のそれ以前のバージョンは、引き続きそれらの古い言語バージョンと互換性があります。弊社は、すべてのランタイムの非推奨化について、このページ、各 SDK の README、および各言語の変更履歴にて、事前に告知します。 > SDK は、サポートされていない言語バージョン上でも *動作し続ける* 可能性はありますが、使用を継続しないでください。サポート対象外のバージョンで動作する SDK は、どのリリースにおいても予期せず破損する可能性があり、その破損の原因が変更履歴に記載されない場合があるためです。 ### 言語ポリシー #### Python Python 3.10 は 2026 年 10 月にサポートが終了します。2027 年 3 月と 9 月の API リリースでは引き続きサポートされます。2028 年 3 月のメジャーリリースではサポートが削除されます。 *Python 3.9 以降* をサポートします。これには、[現在セキュリティサポート](https://endoflife.date/python)を受けている Python のすべてのバージョンと、延長サポート期間内のバージョンが含まれます。 サポート終了日に達した Python バージョンは、対応する期間を *1 年* 延長します (2 つのメジャー API リリース)。毎年 3 月の API リリースをもって、サポート対象の最も古い Python バージョンのサポートを終了します。 非推奨スケジュールは以下のとおりです。 | Python バージョン | ステータス | 使用終了 | サポート終了 | Last Compatible SDK | 備考 | | ------------ | --------- | ----------- | ---------- | ------------------- | ------------------------------------------------------------ | | 3.12 | (サポート対象) | 2028 年 10 月 | 2030 年 3 月 | 未定 | | | 3.11 | (サポート対象) | 2027 年 10 月 | 2029 年 3 月 | 未定 | | | 3.10 | (サポート対象) | 2026 年10 月 | 2028 年 3 月 | 未定 | | | 3.9 | (非推奨) | 2025 年 10 月 | 2027 年 3 月 | 未定 | | | 3.8 | (サポート対象外) | 2024 年 10 月 | 2026 年 3 月 | `v14.4.1` | 3.8 は、このポリシーで定義されているスケジュールでサポートが終了した最初のバージョンです。 | | 3.7 | (サポート対象外) | 2023 年 6 月 | 2026 年 3 月 | `v14.4.1` | このポリシーへの移行を容易にするために、3.7 のサポート期間を延長し、ユーザーが統合を更新するための時間を確保します。 | | 3.6 | (サポート対象外) | 2021 年 12 月 | 2025 年 9 月 | `v12.5.1` | 3.6 を廃止する決定は、このポリシーより前のものであり、結果として上記のパターンに従っていません。 | #### Ruby Ruby 3.4 は 2028 年 3 月にサポートが終了します。3 つの API リリース (2028 年 3 月、2028 年 9 月、2029 年 3 月) については引き続きサポートされます。2029 年 9 月のリリースで 3.4 のサポートは終了します。 *Ruby 2.7 以降* をサポートします。これには、[現在サポート](https://endoflife.date/ruby)されているすべてのバージョンの Ruby と、延長サポート期間内のバージョンが含まれます。 サポート終了日に達した Ruby バージョンのサポート期間は _1.5 年_に延長されます (3 つのメジャー API リリース)。スケジュールが追いつくと、毎年 9 月の API リリースで、サポートされる最も古い Ruby バージョンのサポートが終了します。 非推奨スケジュールは以下のとおりです。 | Ruby バージョン | ステータス | 使用終了 | サポート終了 | Last Compatible SDK | 備考 | | ---------- | --------- | ---------- | ---------- | ------------------- | ------------------------------------------------------------ | | 4.0 | (サポート対象) | 2029 年 3 月 | 2030 年 9 月 | 未定 | | | 3.4 | (サポート対象) | 2028 年 3 月 | 2029 年 9 月 | 未定 | | | 3.3 | (サポート対象) | 2027 年 3 月 | 2028 年 9 月 | 未定 | 3.3 は、このポリシーで定義されているスケジュールに対応しなくなった最初のバージョンです。 | | 3.2 | (非推奨) | 2026 年 3 月 | 2028 年 3 月 | 未定 | このポリシーへの移行を容易にするために、3.2 のサポート期間を延長し、ユーザーが統合を更新するための時間を確保します。 | | 3.1 | (非推奨) | 2025 年 3 月 | 2027 年 9 月 | 未定 | このポリシーへの移行を容易にするために、3.1 のサポート期間を延長し、ユーザーが統合を更新するための時間を確保します。 | | 3.0 | (非推奨) | 2024 年 4 月 | 2027 年 3 月 | 未定 | このポリシーへの移行を容易にするために、3.0 のサポート期間を延長し、ユーザーが統合を更新するための時間を確保します。 | | 2.7 | (非推奨) | 2023 年 3 月 | 2026 年 9 月 | 未定 | このポリシーへの移行を容易にするために、2.7 のサポート期間を延長し、ユーザーが統合を更新するための時間を確保します。 | | 2.6 | (サポート対象外) | 2022 年 3 月 | 2026 年 3 月 | `v18.4.2` | このポリシーへの移行を容易にするために、2.6 の対応する期間を延長し、ユーザーが統合を更新するための時間を確保します。 | | 25 | (サポート対象外) | 2021 年 3 月 | 2025 年 9 月 | `v15.5.0` | 2.5 を廃止する決定は、このポリシーより前のものであり、結果として上記のスケジュールに従っていません。 | | 2.4 | (サポート対象外) | 2020 年 3 月 | 2025 年 9 月 | `v15.5.0` | 2.4 を廃止する決定は、このポリシーより前のものであり、結果として上記のスケジュールに従っていません。 | | 2.3 | (サポート対象外) | 2019 年 3 月 | 2025 年 9 月 | `v15.5.0` | 2.3 を廃止する決定は、このポリシーより前のものであり、結果として上記のスケジュールに従っていません。 | #### PHP *PHP 7.2 以降* をサポートします。 PHP バージョンの廃止に関する明確なポリシーはまだないため、今後のすべてのリリースで提供可能なスケジュールはまだありません。それでも、長い間サポートが終了している PHP バージョンについては、廃止を事前発表しています (以下の表を参照)。 サポートが終了したバージョンは廃止される予定です。7.4 より前の PHP バージョンを使用している場合は、アップグレード (またはプロセスを円滑に進めるために共有ホストに連絡) することをお勧めします。ガイダンスは変更され次第、更新されます。 非推奨スケジュールは以下のとおりです。 | PHP バージョン | ステータス | 使用終了 | サポート終了 | Last Compatible SDK | | --------- | --------- | ----------- | ----------------- | ------------------- | | 8.2 | (サポート対象) | 2026 年 12 月 | 現時点では非推奨プランはありません | 未定 | | 8.1 | (サポート対象) | 2025 年 12 月 | 現時点では非推奨プランはありません | 未定 | | 8.0 | (サポート対象) | 2023 年 11 月 | 現時点では非推奨プランはありません | 未定 | | 7.4 | (サポート対象) | 2022 年 11 月 | 現時点では非推奨プランはありません | 未定 | | 7.3 | (非推奨) | 2020 年 11 月 | 2026 年 9 月頃 | 未定 | | 7.2 | (非推奨) | 2019 年 12 月 | 2026 年 9 月頃 | 未定 | | 7.1 | (サポート対象外) | 2019 年 12 月 | 2026 年 3 月 | `v19.4.1` | | 7.0 | (サポート対象外) | 2019 年 1 月 | 2026 年 3 月 | `v19.4.1` | | 5.6 | (サポート対象外) | 2018 年 12 月 | 2026 年 3 月 | `v19.4.1` | #### Go Go 1.25 は 2026 年 8 月にサポートが終了します。2026 年 9 月と 2027 年 3 月の API リリースではサポートを継続します。2027 年 9 月のメジャーリリースでサポートを終了します。 *Go 1.22 以降* に対応しています。これには、[現在対応中](https://endoflife.date/go)のすべての Go バージョンと、延長サポート期間内のバージョンが含まれます。 サポート終了日に達した Go バージョンは、 *1年* の延長サポート期間 (2 つのメジャー API リリース) を開始します。スケジュールが追いつくと、メジャー API リリースごとに、サポートされている最も古い Go バージョンのサポートが終了します。 非推奨スケジュールは以下のとおりです。 | Go バージョン | ステータス | 使用終了 | サポート終了 | Last Compatible SDK | 備考 | | -------- | --------- | ---------- | ---------- | ------------------- | ------------------------------------------------------------- | | 1.26 | (サポート対象) | 2027 年 2 月 | 2028 年 3 月 | 未定 | | | 1.25 | (サポート対象) | 2026 年 8 月 | 2027 年 9 月 | 未定 | | | 1.24 | (非推奨) | 2026 年 2 月 | 2027 年 3 月 | 未定 | | | 1.23 | (非推奨) | 2025 年 8 月 | 2026 年 9 月 | 未定 | 1.23 は、予定どおりに廃止される最初のバージョンになります。 | | 1.22 | (非推奨) | 2025 年 2 月 | 2026 年 9 月 | 未定 | このポリシーへの移行を容易にするために、1.22 のサポート期間を延長し、ユーザーが統合を更新するための時間を確保します。 | | 1.21 | (サポート対象外) | 2024 年 8 月 | 2026 年 3 月 | `v84.4.1` | このポリシーへの移行を容易にするために、1.21 のサポート期間を延長し、ユーザーが統合を更新するための時間を確保します。 | | 1.20 | (サポート対象外) | 2024 年 2 月 | 2026 年 3 月 | `v84.4.1` | このポリシーへの移行を容易にするために、1.20 のサポート期間を延長し、ユーザーが統合を更新するための時間を確保します。 | | 1.19 | (サポート対象外) | 2023 年 9 月 | 2025 年 9 月 | `v82.5.1` | 1.19 の廃止の決定は、このポリシーより前のため、上記のパターンに従っていません。 | | 1.18 | (サポート対象外) | 2023 年 2 月 | 2025 年 9 月 | `v82.5.1` | 1.18 を廃止する決定は、このポリシーより前のものであるため、上記のパターンに従っていません。 | #### Node.js Node 22 は 2027 年 4 月にサポート終了となります。2027 年 9 月と 2028 年 3 月の API リリースでは引き続きサポートされます。2028 年 9 月のメジャーリリースでサポートが終了します。 LTS (偶数番号) バージョンの *Node 18 以降\** をサポートします。これには、[現在サポートを受けている](https://endoflife.date/nodejs)すべての Node のバージョンと、延長サポート期間内のバージョンが含まれます。 > Node.js のリリーススケジュールは [2026 年 10 月に変更](https://nodejs.org/en/blog/announcements/evolving-the-nodejs-release-schedule)されるため、それに応じてこのスケジュールも変更されます。延長サポート期間の長さは変わりませんが、非推奨のサイクルは変更されます。 サポート終了日に達した Node.js バージョンは、1 年間の延長サポート期間 (2 つのメジャー API リリース) を開始します。スケジュールに追いつくと、毎年 9 月の API リリースで、サポートされる最も古い Node LTS バージョンのサポートが終了します。 非推奨スケジュールは以下のとおりです。 | Node のバージョン | ステータス | 使用終了 | サポート終了 | Last Compatible SDK | 備考 | | ----------- | --------- | ---------- | ---------- | ------------------- | -------------------------------------------------------------------- | | 24 | (サポート対象) | 2028 年 4 月 | 2029 年 9 月 | 未定 | | | 22 | (サポート対象) | 2027 年 4 月 | 2028 年 9 月 | 未定 | | | 20 | (非推奨) | 2026 年 4 月 | 2027 年 9 月 | 未定 | | | 18 | (非推奨) | 2025 年 4 月 | 2026 年 9 月 | 未定 | 18 は、このポリシーで定義されているスケジュールでサポートが終了した最初のバージョンです。 | | 16 | (サポート対象外) | 2023 年 9 月 | 2026 年 3 月 | `v20.4.1` | このポリシーへの移行を容易にするために、Stripe は 16 のサポート期間を延長し、ユーザーが統合を更新するための時間を確保します。 | | 14 | (サポート対象外) | 2023 年 4 月 | 2025 年 9 月 | `v18.5.0` | 14 を廃止するという決定は、このポリシーより前のものであり、結果として上記のパターンに従っていません。 | | 12 | (サポート対象外) | 2022 年 4 月 | 2025 年 9 月 | `v18.5.0` | 12 を削除するという決定は、このポリシーより前のものであるため、上記のパターンに従っていません。 | #### .NET .NET 9.0 は 2026 年 5 月にサポート終了となります。STS バージョンであるため、次のメジャーリリース (2026 年 9 月) でサポートを終了します。もし LTS バージョンであれば、代わりに 2027 年 9 月の API リリースでサポートを終了する予定です。 .NET は 2 つのカテゴリに対応します。 - .NET Framework では、 *4.6.2+* をサポートしています。 - .NET Core では、*.NET 6 以降* に対応します。 .NET Core バージョンのサポートは、次のスケジュールに従って提供されます。 - LTS(偶数番号)リリースは、サポート終了後 *1 年*(メジャー API リリース 2 つ分)の間対応 - STS(奇数番号)リリースは、有効なバージョンである期間のみ対応 非推奨スケジュールは以下のとおりです。 | .NET Core バージョン | ステータス | 使用終了 | サポート終了 | Last Compatible SDK | 備考 | | --------------- | --------- | ----------- | ---------- | ------------------- | ----------------------------------------------------------------------- | | 10 | (サポート対象) | 2028 年 11 月 | 2030 年 3 月 | 未定 | | | 9 | (サポート対象) | 2026 年 11 月 | 2027 年 3 月 | 未定 | | | 8 | (サポート対象) | 2026 年 11 月 | 2028 年 3 月 | 未定 | 8 は、このポリシーで定義されているスケジュールでサポートが終了した最初のバージョンです。 | | 7 | (サポート対象外) | 2024 年 5 月 | 2026 年 3 月 | `v50.4.1` | このポリシーへの移行を容易にするために、7 のサポート期間を延長し、ユーザーが統合を更新するための時間を確保します。 | | 6 | (非推奨) | 2024 年 11 月 | 2026 年 9 月 | 未定 | このポリシーへの移行を容易にするために、6 つのサポート期間を延長し、ユーザーが統合を更新するための時間を確保します。 | | 5 | (サポート対象外) | 2022 年 5 月 | 2026 年 3 月 | `v50.4.1` | このポリシーへの移行を容易にするために、Stripe はユーザーが統合の更新により多くの時間を費やせるように、5 の対応する期間を延長します。 | | 3.1 | (サポート対象外) | 2022 年 12 月 | 2025 年 9 月 | `v48.5.0` | 3.1 を廃止する決定は、このポリシーより前のものであり、結果として上記のパターンに従っていません。 | #### Java すべての LTS バージョンの Java をサポートします。現在 Java バージョンは次のとおりです。 - 25 - 21 - 17 - 11 - 8 (1.8) ## パブリックプレビューリリースチャンネル 当社では[パブリックプレビューリリースチャンネル](https://stripe.dev/blog/introducing-stripes-new-public-preview-release-channel)を設け、[一般提供](https://docs.stripe.com/release-phases.md) (GA) バージョンとは異なるプレビュー API バージョンを使用しています。例えば、`2025-04-30.basil` の代わりに `2025-04-30.preview` を利用しています。現在のプレビュー API バージョンは**2026-03-25.preview\**です。 [プレビュー](https://docs.stripe.com/release-phases.md)ステージの新機能や強化にアクセスするには、`beta`または`b`サフィックスが付いたSDKのバージョンを使用してください。例えば、Pythonでは`5.1.0b3`、他の言語のSDKでは`5.1.0-beta.3`です。 インストール手順や、`Stripe-Version`ヘッダーでプレビューヘッダーを渡すことについての詳細は、各SDK GitHubリポジトリのREADMEファイル内の**パブリックプレビューSDK**セクションを参照してください。 - [Python SDKパブリックプレビュー](https://github.com/stripe/stripe-python/?tab=readme-ov-file#public-preview-sdks) - [.NET SDKパブリックプレビュー](https://github.com/stripe/stripe-dotnet?tab=readme-ov-file#public-preview-sdks) - [Java SDK パブリックプレビュー](https://github.com/stripe/stripe-java?tab=readme-ov-file#public-preview-sdks) - [Go SDK パブリックプレビュー](https://github.com/stripe/stripe-go?tab=readme-ov-file#public-preview-sdks) - [PHP SDK パブリックプレビュー](https://github.com/stripe/stripe-php?tab=readme-ov-file#public-preview-sdks) - [Ruby SDKパブリックプレビュー](https://github.com/stripe/stripe-ruby?tab=readme-ov-file#public-preview-sdks) - [Node.js SDKパブリックプレビュー](https://github.com/stripe/stripe-node?tab=readme-ov-file#public-preview-sdks) ## プライベートプレビュー版のリリースチャンネル また、招待制の限定的なアクセスを必要とする [プライベートプレビュー段階](https://docs.stripe.com/release-phases.md) の機能も公開されています。これらの機能もプレビュー API バージョンを使用します。 招待を受けた後にプライベートプレビューの機能と拡張機能にアクセスするには、`alpha` または `a` の接尾辞がついた SDK のバージョンを使用します。たとえば、Pythonでは`5.1.0a3`、その他の言語 SDK では`5.1.0-alpha.3` を使用します。 インストール方法や、`Stripe-Version` ヘッダーでプレビューヘッダーを渡す方法についての詳細は、各 SDK の GitHub リポジトリにある README ファイル内の **プライベートプレビュー SDK** セクションを参照してください。 - [Python SDK プライベートプレビュー版](https://github.com/stripe/stripe-python/?tab=readme-ov-file#private-preview-sdks) - [.NET SDK プライベートプレビュー版](https://github.com/stripe/stripe-dotnet?tab=readme-ov-file#private-preview-sdks) - [Java SDK プライベートプレビュー版](https://github.com/stripe/stripe-java?tab=readme-ov-file#private-preview-sdks) - [Go SDK プライベートプレビュー版](https://github.com/stripe/stripe-go?tab=readme-ov-file#private-preview-sdks) - [PHP SDK プライベートプレビュー版](https://github.com/stripe/stripe-php?tab=readme-ov-file#private-preview-sdks) - [Ruby SDK プライベートプレビュー版](https://github.com/stripe/stripe-ruby?tab=readme-ov-file#private-preview-sdks) - [Node.js SDK プライベートプレビュー版](https://github.com/stripe/stripe-node?tab=readme-ov-file#private-preview-sdks) ## See also - [Webhook のバージョン管理を処理する](https://docs.stripe.com/webhooks/versioning.md)