コンテンツにスキップ
アカウントを作成
または
サインイン
Stripe ドキュメントのロゴ
/
アカウントを作成
サインイン

注

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

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

新規情報

Connect の Accounts v2 を使用する場合、Account Links v2 を使用して Connect アカウントをユーザー登録できるようになりました。また、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_links.completed イベントを v2.core.account_links.returned に名称変更します。既存の連携は動作が壊れることはありませんが、この変更に伴い、新しいバージョンのイベントに登録（サブスクライブ）する必要があります。

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

効果

Accounts v2 API で作成した Connect アカウントを、アカウントで指定された設定タイプに標準対応している 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 のアップグレードについて、詳細をご確認ください。

関連する変更

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