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 で指定された設定タイプに標準対応している Account Links v2 API で直接ユーザー登録できます。これは Accounts v2 で Account Links v1 API を使用する場合と比べて改善されています。

変更点

アップグレード