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 バージョン間のマッピングも含まれています。
パブリックプレビューリリースチャンネル
私たちは、パブリックプレビューリリースチャンネルを持っており、これは一般提供（GA）バージョンとは異なるプレビュー APIバージョンを使用します。例えば、2025-04-30.の代わりに2025-04-30.。
プレビューステージの新機能や強化にアクセスするには、betaまたはbサフィックスが付いたSDKのバージョンを使用してください。例えば、Pythonでは5.、他の言語のSDKでは5.です。
インストール手順や、Stripe-Versionヘッダーでプレビューヘッダーを渡すことについての詳細は、各SDK GitHubリポジトリのREADMEファイル内のパブリックプレビューSDKセクションを参照してください。