コンテンツにスキップ
アカウント作成/サインイン
Stripe ドキュメントのロゴ
/
アカウントを作成サインイン
概要
バージョン管理
API バージョンのアップグレード
Essentials
ツール
Visual Studio Code をご利用の場合
機能
Stripe 健全性アラートファイルのアップロード
AI ソリューション
モデルコンテキストプロトコルエージェントを使用した AI SaaS 請求ワークフローの構築
セキュリティとプライバシー
Stripebot ウェブクローラー
Stripe を拡張する
パートナー
パートナー認定

メモ

このページはまだ日本語ではご利用いただけません。より多くの言語で文書が閲覧できるように現在取り組んでいます。準備が整い次第、翻訳版を提供いたしますので、もう少しお待ちください。

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

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

Stripe API バージョン

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

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

You might sometimes see a major version update to the SDKs coincide with the monthly API version updates. This happens when the SDKs need to ship a breaking change.

The current version of the API is 2025-11-17.clover.

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

プログラミング言語のランタイムバージョンがサポート終了を迎えると、弊社は以下の表でそのバージョンを「非推奨」とマークし、延長サポート期間を開始します。この延長サポート期間の正確な長さは言語によって異なりますが、期間は通常 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.13.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 セクションを参照してください。

参照情報

このページはお役に立ちましたか。
はいいいえ