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

メモ

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

Accounts v2 API で作成された接続アカウント向けに Account Links v2 API のサポートを追加互換性に関わる変更

新規情報

Connect の Accounts v2 を使用する場合、Account Links v2 を使用して連結アカウントをオンボーディングできるようになりました。また、Accounts v2 では merchant や customer などの追加設定にも対応しています。

また、接続アカウントからStripeが収集する必要事項を指定できるオプションのcollection_optionsパラメータを導入しました。

  • collection_options.fields: 現在支払いが必要な要件 (currently_due) のみを収集するか、現在および将来的に支払いが必要な要件 (eventually_due) の両方を収集するかを指定します。collection_options を指定しない場合、デフォルト値は currently_due になります。
  • collection_options.future_requirements: Connectオンボーディングの要件に加えて、将来必要となる要件 (future_requirements) を収集するかどうかを指定します。デフォルト値は omit です。

この変更により互換性が失われる理由

このリリースの一環として、わかりやすくするために、v2.core.account_link.completed イベントの名前を v2.core.account_link.returned に変更します。既存の実装は壊れませんが、この変更に伴い、イベントの新しいバージョンに登録する必要があります。

API に破壊的な変更はありません。

効果

Accounts v2 API で作成した Connect アカウントを、Account で指定された設定タイプに標準対応している Account Links v2 API で直接オンボーディングできます。これは Accounts v2 で Account Links v1 API を使用する場合と比べて改善されています。

変更点

パラメーター変更するリソースまたは エンドポイント
collection_options追加済み
V2.Core.AccountLink.use_case.account_update
フィールド変更する送信元 → 送信先
V2.Core.AccountLink#create.use_case.account_onboarding.configurationsV2.Core.AccountLink#create.use_case.account_update.configurationsV2.Core.AccountLink.use_case.account_onboarding.configurationsV2.Core.AccountLink.use_case.account_update.configurations変更しました
literal('recipient') → enum('customer'|'merchant'|'recipient'|'storer')

アップグレード

  1. Workbench で現在の API バージョンを表示します。
  2. SDK を使用している場合は、この API バージョンに対応する SDK バージョンにアップグレードします。
    • SDK を使用していない場合は、Stripe-Version: 2025-07-30.preview を含めるように API リクエストを更新してください。
  3. Webhook エンドポイントに使用する API バージョンをアップグレードします。
  4. 新しいバージョンに対して、実装内容をテストします。
  5. Connect を使用する場合は、Connect の実装内容をテストします。
  6. Workbench でアップグレードを実行します。バージョンをロールバックできるのは 72 時間以内です。

Stripe API のアップグレードについて、詳細をご確認ください。

関連する変更