# Accounts v2 の要件回収パラメーターを更新 ## 新機能 [defaults.responsibilities.requirements_collector](https://docs.stripe.com/api/v2/core/accounts/object.md?api-version=2025-11-17.preview#v2_account_object-defaults-responsibilities-requirements_collector) パラメーターが、非推奨となった [requirements.collector](https://docs.stripe.com/api/v2/core/accounts/object.md?api-version=2025-10-29.preview#v2_account_object-requirements-collector) パラメーターに置き換わります。`requirements_collector` パラメーターを使用すると、[Accounts v2](https://docs.stripe.com/api/v2/core/accounts/.md?api-version=2025-11-17.preview) の使用時に連結アカウントの要件を収集する責任が Stripe にあるのか、プラットフォームにあるのかを指定できます。 この変更により [requirements.entries[].reference.type](https://docs.stripe.com/api/v2/core/accounts/object.md?api-version=2025-11-17.preview#account_object-requirements-entries-reference-type) の列挙値も更新されます。これはどの API リソースが特定の要件に関連するかを特定するものです。 ## なぜこれは、互換性に関わる変更なのでしょうか？ これは互換性に関わる変更です。理由は以下の通りです： - `requirements_collector` パラメーターは、`collector` パラメーターに代わるものです。 - `requirements.entries[].reference.type` のパラメーターの列挙値が、より具体的な値 (`payment_method`、`person` など) に更新されました。そのため、統合が以前の一般的な値である `resource` を前提としている場合、検証エラーが発生する可能性があります。 ## 影響 更新されたパラメータの列挙値 `requirements.entries[].reference.type` によって、検証フローの特定の要件の扱い方に変更が必要になるかもしれません。 連携が `collector` パラメーターや `resource` 列挙値に依存している場合、この API バージョンをアップグレードする前にコードを更新して連携の失敗を回避する必要があります。 ## 変化 #### REST API | Parameter | Change | Resources or endpoints | | ------------------------ | ------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | `requirements_collector` | Added | [V2.Core.Account.defaults.responsibilities](/api/v2/core/accounts/object?api-version=2025-11-17.preview#v2_account_object-defaults-responsibilities), [V2.Core.Account.requirements](/api/v2/core/accounts/object?api-version=2025-11-17.preview#v2_account_object-requirements), [V2.Core.Account.requirements.entries[].reference](/api/v2/core/accounts/object?api-version=2025-11-17.preview#v2_account_object-requirements-entries-reference-type), [V2.Core.Account.requirements.entries[].reference](/api/v2/core/accounts/object?api-version=2025-11-17.preview#v2_account_object-requirements-entries-reference-type) | #### Ruby | Parameter | Change | Resources or methods | | ------------------------ | ------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `requirements_collector` | Added | [V2::Core::Account::Default::Responsibility](/api/v2/core/accounts/object?api-version=2025-11-17.preview#v2_account_object-defaults-responsibilities), [V2::Core::Account::Requirement](/api/v2/core/accounts/object?api-version=2025-11-17.preview#v2_account_object-requirements) | #### Python | Parameter | Change | Resources or methods | | ------------------------ | ------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `requirements_collector` | Added | [V2.Core.Account.Default.Responsibility](/api/v2/core/accounts/object?api-version=2025-11-17.preview#v2_account_object-defaults-responsibilities), [V2.Core.Account.Requirement](/api/v2/core/accounts/object?api-version=2025-11-17.preview#v2_account_object-requirements), [V2.Core.Account.Requirement.Entry.Reference](/api/v2/core/accounts/object?api-version=2025-11-17.preview#v2_account_object-requirements-entries-reference-type), [V2.Core.Account.Requirement.Entry.Reference](/api/v2/core/accounts/object?api-version=2025-11-17.preview#v2_account_object-requirements-entries-reference-type) | #### PHP | Parameter | Change | Resources or methods | | ------------------------ | ------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | `requirements_collector` | Added | [V2.Core.Account.defaults.responsibilities](/api/v2/core/accounts/object?api-version=2025-11-17.preview#v2_account_object-defaults-responsibilities), [V2.Core.Account.requirements](/api/v2/core/accounts/object?api-version=2025-11-17.preview#v2_account_object-requirements), [V2.Core.Account.requirements.entries[].reference](/api/v2/core/accounts/object?api-version=2025-11-17.preview#v2_account_object-requirements-entries-reference-type), [V2.Core.Account.requirements.entries[].reference](/api/v2/core/accounts/object?api-version=2025-11-17.preview#v2_account_object-requirements-entries-reference-type) | #### Java | Parameter | Change | Resources or methods | | ----------------------- | ------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `requirementsCollector` | Added | [v2.core.Account.defaults.responsibilities](/api/v2/core/accounts/object?api-version=2025-11-17.preview#v2_account_object-defaults-responsibilities), [v2.core.Account.requirements](/api/v2/core/accounts/object?api-version=2025-11-17.preview#v2_account_object-requirements) | #### Node.js | Parameter | Change | Resources or methods | | ------------------------ | ------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | `requirements_collector` | Added | [V2.Core.Account.defaults.responsibilities](/api/v2/core/accounts/object?api-version=2025-11-17.preview#v2_account_object-defaults-responsibilities), [V2.Core.Account.requirements](/api/v2/core/accounts/object?api-version=2025-11-17.preview#v2_account_object-requirements), [V2.Core.Account.requirements.entries[].reference](/api/v2/core/accounts/object?api-version=2025-11-17.preview#v2_account_object-requirements-entries-reference-type), [V2.Core.Account.requirements.entries[].reference](/api/v2/core/accounts/object?api-version=2025-11-17.preview#v2_account_object-requirements-entries-reference-type) | #### Go | Parameter | Change | Resources or methods | | ----------------------- | ------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `RequirementsCollector` | Added | [V2CoreAccountDefaultsResponsibilities](/api/v2/core/accounts/object?api-version=2025-11-17.preview#v2_account_object-defaults-responsibilities), [V2CoreAccountRequirements](/api/v2/core/accounts/object?api-version=2025-11-17.preview#v2_account_object-requirements), [V2CoreAccountRequirementsEntryReference](/api/v2/core/accounts/object?api-version=2025-11-17.preview#v2_account_object-requirements-entries-reference-Type), [V2CoreAccountRequirementsEntryReference](/api/v2/core/accounts/object?api-version=2025-11-17.preview#v2_account_object-requirements-entries-reference-Type) | #### .NET | Parameter | Change | Resources or methods | | ----------------------- | ------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `RequirementsCollector` | Added | [V2.Core.Account.Defaults.Responsibilities](/api/v2/core/accounts/object?api-version=2025-11-17.preview#v2_account_object-defaults-responsibilities), [V2.Core.Account.Requirements](/api/v2/core/accounts/object?api-version=2025-11-17.preview#v2_account_object-requirements) | ## アップグレード #### REST API 1. Workbench で[現在の API バージョンを表示します](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench)。 1. SDK を使用している場合は、この API バージョンに対応する SDK バージョンにアップグレードします。 - SDK を使用していない場合は、`Stripe-Version: 2025-11-17.preview` を含めるように [API リクエスト](https://docs.stripe.com/api/versioning.md)を更新してください。 1. [Webhook エンドポイント](https://docs.stripe.com/webhooks/versioning.md)に使用する API バージョンをアップグレードします。 1. 新しいバージョンに対して、[実装内容をテスト](https://docs.stripe.com/testing.md)します。 1. Connect を使用する場合は、[Connect の実装内容をテスト](https://docs.stripe.com/connect/testing.md)します。 1. Workbench で[アップグレードを実行](https://docs.stripe.com/upgrades.md#perform-the-upgrade)します。[バージョンをロールバック](https://docs.stripe.com/upgrades.md#roll-back-your-api-version)できるのは 72 時間以内です。 [Stripe API のアップグレード](https://docs.stripe.com/upgrades.md)について、詳細をご確認ください。 #### Ruby 1. Workbench で[現在の API バージョンを表示します](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench)。 1. Ruby SDK を 最新バージョンにアップグレードします。 1. [Webhook エンドポイント](https://docs.stripe.com/webhooks/versioning.md)に使用する API バージョンをアップグレードします。 1. 新しいバージョンに対して、[実装内容をテスト](https://docs.stripe.com/testing.md)します。 1. Connect を使用する場合は、[Connect の実装内容をテスト](https://docs.stripe.com/connect/testing.md)します。 1. Workbench で[アップグレードを実行](https://docs.stripe.com/upgrades.md#perform-the-upgrade)します。[バージョンをロールバック](https://docs.stripe.com/upgrades.md#roll-back-your-api-version)できるのは 72 時間以内です。 [Stripe API のアップグレード](https://docs.stripe.com/upgrades.md)について、詳細をご確認ください。 #### Python 1. Workbench で[現在の API バージョンを表示します](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench)。 1. Python SDK を 最新バージョンにアップグレードします。 1. [Webhook エンドポイント](https://docs.stripe.com/webhooks/versioning.md)に使用する API バージョンをアップグレードします。 1. 新しいバージョンに対して、[実装内容をテスト](https://docs.stripe.com/testing.md)します。 1. Connect を使用する場合は、[Connect の実装内容をテスト](https://docs.stripe.com/connect/testing.md)します。 1. Workbench で[アップグレードを実行](https://docs.stripe.com/upgrades.md#perform-the-upgrade)します。[バージョンをロールバック](https://docs.stripe.com/upgrades.md#roll-back-your-api-version)できるのは 72 時間以内です。 [Stripe API のアップグレード](https://docs.stripe.com/upgrades.md)について、詳細をご確認ください。 #### PHP 1. Workbench で[現在の API バージョンを表示します](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench)。 1. PHP SDK を 最新バージョンにアップグレードします。 1. [Webhook エンドポイント](https://docs.stripe.com/webhooks/versioning.md)に使用する API バージョンをアップグレードします。 1. 新しいバージョンに対して、[実装内容をテスト](https://docs.stripe.com/testing.md)します。 1. Connect を使用する場合は、[Connect の実装内容をテスト](https://docs.stripe.com/connect/testing.md)します。 1. Workbench で[アップグレードを実行](https://docs.stripe.com/upgrades.md#perform-the-upgrade)します。[バージョンをロールバック](https://docs.stripe.com/upgrades.md#roll-back-your-api-version)できるのは 72 時間以内です。 [Stripe API のアップグレード](https://docs.stripe.com/upgrades.md)について、詳細をご確認ください。 #### Java 1. Workbench で[現在の API バージョンを表示します](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench)。 1. Java SDK を 最新バージョンにアップグレードします。 1. [Webhook エンドポイント](https://docs.stripe.com/webhooks/versioning.md)に使用する API バージョンをアップグレードします。 1. 新しいバージョンに対して、[実装内容をテスト](https://docs.stripe.com/testing.md)します。 1. Connect を使用する場合は、[Connect の実装内容をテスト](https://docs.stripe.com/connect/testing.md)します。 1. Workbench で[アップグレードを実行](https://docs.stripe.com/upgrades.md#perform-the-upgrade)します。[バージョンをロールバック](https://docs.stripe.com/upgrades.md#roll-back-your-api-version)できるのは 72 時間以内です。 [Stripe API のアップグレード](https://docs.stripe.com/upgrades.md)について、詳細をご確認ください。 #### Node.js 1. Workbench で[現在の API バージョンを表示します](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench)。 1. Node SDK を 最新バージョンにアップグレードします。 1. [Webhook エンドポイント](https://docs.stripe.com/webhooks/versioning.md)に使用する API バージョンをアップグレードします。 1. 新しいバージョンに対して、[実装内容をテスト](https://docs.stripe.com/testing.md)します。 1. Connect を使用する場合は、[Connect の実装内容をテスト](https://docs.stripe.com/connect/testing.md)します。 1. Workbench で[アップグレードを実行](https://docs.stripe.com/upgrades.md#perform-the-upgrade)します。[バージョンをロールバック](https://docs.stripe.com/upgrades.md#roll-back-your-api-version)できるのは 72 時間以内です。 [Stripe API のアップグレード](https://docs.stripe.com/upgrades.md)について、詳細をご確認ください。 #### Go 1. Workbench で[現在の API バージョンを表示します](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench)。 1. Go SDK を 最新バージョンにアップグレードします。 1. [Webhook エンドポイント](https://docs.stripe.com/webhooks/versioning.md)に使用する API バージョンをアップグレードします。 1. 新しいバージョンに対して、[実装内容をテスト](https://docs.stripe.com/testing.md)します。 1. Connect を使用する場合は、[Connect の実装内容をテスト](https://docs.stripe.com/connect/testing.md)します。 1. Workbench で[アップグレードを実行](https://docs.stripe.com/upgrades.md#perform-the-upgrade)します。[バージョンをロールバック](https://docs.stripe.com/upgrades.md#roll-back-your-api-version)できるのは 72 時間以内です。 [Stripe API のアップグレード](https://docs.stripe.com/upgrades.md)について、詳細をご確認ください。 #### .NET 1. Workbench で[現在の API バージョンを表示します](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench)。 1. .NET SDK を 最新バージョンにアップグレードします。 1. [Webhook エンドポイント](https://docs.stripe.com/webhooks/versioning.md)に使用する API バージョンをアップグレードします。 1. 新しいバージョンに対して、[実装内容をテスト](https://docs.stripe.com/testing.md)します。 1. Connect を使用する場合は、[Connect の実装内容をテスト](https://docs.stripe.com/connect/testing.md)します。 1. Workbench で[アップグレードを実行](https://docs.stripe.com/upgrades.md#perform-the-upgrade)します。[バージョンをロールバック](https://docs.stripe.com/upgrades.md#roll-back-your-api-version)できるのは 72 時間以内です。 [Stripe API のアップグレード](https://docs.stripe.com/upgrades.md)について、詳細をご確認ください。 ## 関連する変更 - [Accounts v2 に今後必要となる要件用フィールドを追加](https://docs.stripe.com/changelog/clover/2025-11-17/accounts-v2-future-requirements.md) - [PaymentMethods が Accounts v2 を使用して顧客アカウントに決済手段を一覧表示できるようになりました](https://docs.stripe.com/changelog/clover/2025-11-17/v2-accounts-payment-methods.md) - [アカウントに PayPay のサポートを追加](https://docs.stripe.com/changelog/clover/2025-11-17/paypay-connect.md) - [Accounts v2 にコンビニ決済と日本語の明細書表記のサポートを追加](https://docs.stripe.com/changelog/clover/2025-11-17/accounts-v2-konbini-payments.md) - [Accounts v2 に EUR 資金の保持機能を追加](https://docs.stripe.com/changelog/clover/2025-11-17/account-v2-storer-config-eur.md) - [機密データを安全に送信できるよう Accounts v2 にアカウントと個人のトークンを追加](https://docs.stripe.com/changelog/clover/2025-11-17/accounts-v2-tokens.md)