# Accounts v2 で設定を無効にするサポートを追加 ## 新機能 [Accounts v2](https://docs.stripe.com/api/v2/core/accounts.md?api-version=2025-07-30.preview) に設定の無効化と再適用のサポートが追加されました。これにより、Stripe でのユーザーの表示方法を指定できます。 ## 効果 以前は、以下のいずれかを選択する必要がありました。 - **ケイパビリティのリクエスト解除**: この差戻しアクションにより、アカウントに未使用の設定が残り、意図しないワークフローが発生する可能性があります。 - **アカウントの閉鎖**: この半永久的な措置には、アカウントを再開する Stripe サポートが必要でした。 設定の無効化により、以下を実行できるようになりました。 - Accounts v2 をユーザーの正確な表現として維持するために、設定が不要になった場合は構成を無効にします。 - 再度必要になったときに、設定を再適用します。 これにより、Accounts v2 で未使用の設定を管理し、数を減らすことができます。 また、各構成のレスポンスオブジェクトに、構成のステータスを示す新しい`applied`フィールドを追加しました。このステータスにより、有効な構成と非アクティブな構成を区別できます。 ## 変更点 #### REST API | Parameter | Change | Resources or endpoints | | --------- | ------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `applied` | Added | [V2.Core.Account#update.configuration.customer](/api/v2/core/accounts/update?api-version=2025-08-27.preview#v2_account_object-configuration-customer), [V2.Core.Account#update.configuration.merchant](/api/v2/core/accounts/update?api-version=2025-08-27.preview#v2_account_object-configuration-merchant), [V2.Core.Account#update.configuration.recipient](/api/v2/core/accounts/update?api-version=2025-08-27.preview#v2_account_object-configuration-recipient), [V2.Core.Account#update.configuration.storer](/api/v2/core/accounts/update?api-version=2025-08-27.preview#v2_account_object-configuration-storer), [V2.Core.Account.configuration.customer](/api/v2/core/accounts/object?api-version=2025-08-27.preview#v2_account_object-configuration-customer), [V2.Core.Account.configuration.merchant](/api/v2/core/accounts/object?api-version=2025-08-27.preview#v2_account_object-configuration-merchant), [V2.Core.Account.configuration.recipient](/api/v2/core/accounts/object?api-version=2025-08-27.preview#v2_account_object-configuration-recipient), [V2.Core.Account.configuration.storer](/api/v2/core/accounts/object?api-version=2025-08-27.preview#v2_account_object-configuration-storer) | #### Ruby | Parameter | Change | Resources or methods | | --------- | ------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `applied` | Added | [V2::Core::Account::Configuration::Customer](/api/v2/core/accounts/object?api-version=2025-08-27.preview#v2_account_object-configuration-customer), [V2::Core::Account::Configuration::Merchant](/api/v2/core/accounts/object?api-version=2025-08-27.preview#v2_account_object-configuration-merchant), [V2::Core::Account::Configuration::Recipient](/api/v2/core/accounts/object?api-version=2025-08-27.preview#v2_account_object-configuration-recipient), [V2::Core::Account::Configuration::Storer](/api/v2/core/accounts/object?api-version=2025-08-27.preview#v2_account_object-configuration-storer), [V2::Core::Account::UpdateParams::Configuration::Customer](/api/v2/core/accounts/update?api-version=2025-08-27.preview#v2_account_object-configuration-customer), [V2::Core::Account::UpdateParams::Configuration::Merchant](/api/v2/core/accounts/update?api-version=2025-08-27.preview#v2_account_object-configuration-merchant), [V2::Core::Account::UpdateParams::Configuration::Recipient](/api/v2/core/accounts/update?api-version=2025-08-27.preview#v2_account_object-configuration-recipient), [V2::Core::Account::UpdateParams::Configuration::Storer](/api/v2/core/accounts/update?api-version=2025-08-27.preview#v2_account_object-configuration-storer) | #### Python | Parameter | Change | Resources or methods | | --------- | ------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `applied` | Added | [V2.Core.Account.Configuration.Customer](/api/v2/core/accounts/object?api-version=2025-08-27.preview#v2_account_object-configuration-customer), [V2.Core.Account.Configuration.Merchant](/api/v2/core/accounts/object?api-version=2025-08-27.preview#v2_account_object-configuration-merchant), [V2.Core.Account.Configuration.Recipient](/api/v2/core/accounts/object?api-version=2025-08-27.preview#v2_account_object-configuration-recipient), [V2.Core.Account.Configuration.Storer](/api/v2/core/accounts/object?api-version=2025-08-27.preview#v2_account_object-configuration-storer), [v2.core.Account.ModifyParamsConfigurationCustomer](/api/v2/core/accounts/update?api-version=2025-08-27.preview#v2_account_object-configuration-customer), [v2.core.Account.ModifyParamsConfigurationMerchant](/api/v2/core/accounts/update?api-version=2025-08-27.preview#v2_account_object-configuration-merchant), [v2.core.Account.ModifyParamsConfigurationRecipient](/api/v2/core/accounts/update?api-version=2025-08-27.preview#v2_account_object-configuration-recipient), [v2.core.Account.ModifyParamsConfigurationStorer](/api/v2/core/accounts/update?api-version=2025-08-27.preview#v2_account_object-configuration-storer) | #### PHP この変更は、PHP SDK には影響しません。 #### Java | Parameter | Change | Resources or methods | | --------- | ------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | `applied` | Added | [v2.core.Account.configuration.customer](/api/v2/core/accounts/object?api-version=2025-08-27.preview#v2_account_object-configuration-customer), [v2.core.Account.configuration.merchant](/api/v2/core/accounts/object?api-version=2025-08-27.preview#v2_account_object-configuration-merchant), [v2.core.Account.configuration.recipient](/api/v2/core/accounts/object?api-version=2025-08-27.preview#v2_account_object-configuration-recipient), [v2.core.Account.configuration.storer](/api/v2/core/accounts/object?api-version=2025-08-27.preview#v2_account_object-configuration-storer), [v2.core.AccountUpdateParams.configuration.customer](/api/v2/core/accounts/update?api-version=2025-08-27.preview#v2_account_object-configuration-customer), [v2.core.AccountUpdateParams.configuration.merchant](/api/v2/core/accounts/update?api-version=2025-08-27.preview#v2_account_object-configuration-merchant), [v2.core.AccountUpdateParams.configuration.recipient](/api/v2/core/accounts/update?api-version=2025-08-27.preview#v2_account_object-configuration-recipient), [v2.core.AccountUpdateParams.configuration.storer](/api/v2/core/accounts/update?api-version=2025-08-27.preview#v2_account_object-configuration-storer) | #### Node.js | Parameter | Change | Resources or methods | | --------- | ------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | `applied` | Added | [V2.Core.Account.configuration.customer](/api/v2/core/accounts/object?api-version=2025-08-27.preview#v2_account_object-configuration-customer), [V2.Core.Account.configuration.merchant](/api/v2/core/accounts/object?api-version=2025-08-27.preview#v2_account_object-configuration-merchant), [V2.Core.Account.configuration.recipient](/api/v2/core/accounts/object?api-version=2025-08-27.preview#v2_account_object-configuration-recipient), [V2.Core.Account.configuration.storer](/api/v2/core/accounts/object?api-version=2025-08-27.preview#v2_account_object-configuration-storer), [V2.Core.AccountUpdateParams.configuration.customer](/api/v2/core/accounts/update?api-version=2025-08-27.preview#v2_account_object-configuration-customer), [V2.Core.AccountUpdateParams.configuration.merchant](/api/v2/core/accounts/update?api-version=2025-08-27.preview#v2_account_object-configuration-merchant), [V2.Core.AccountUpdateParams.configuration.recipient](/api/v2/core/accounts/update?api-version=2025-08-27.preview#v2_account_object-configuration-recipient), [V2.Core.AccountUpdateParams.configuration.storer](/api/v2/core/accounts/update?api-version=2025-08-27.preview#v2_account_object-configuration-storer) | #### Go | Parameter | Change | Resources or methods | | --------- | ------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `Applied` | Added | [V2CoreAccountConfigurationCustomer](/api/v2/core/accounts/object?api-version=2025-08-27.preview#v2_account_object-configuration-customer), [V2CoreAccountConfigurationCustomerParams](/api/v2/core/accounts/update?api-version=2025-08-27.preview#v2_account_object-configuration-customer), [V2CoreAccountConfigurationMerchant](/api/v2/core/accounts/object?api-version=2025-08-27.preview#v2_account_object-configuration-merchant), [V2CoreAccountConfigurationMerchantParams](/api/v2/core/accounts/update?api-version=2025-08-27.preview#v2_account_object-configuration-merchant), [V2CoreAccountConfigurationRecipient](/api/v2/core/accounts/object?api-version=2025-08-27.preview#v2_account_object-configuration-recipient), [V2CoreAccountConfigurationRecipientParams](/api/v2/core/accounts/update?api-version=2025-08-27.preview#v2_account_object-configuration-recipient), [V2CoreAccountConfigurationStorer](/api/v2/core/accounts/object?api-version=2025-08-27.preview#v2_account_object-configuration-storer), [V2CoreAccountConfigurationStorerParams](/api/v2/core/accounts/update?api-version=2025-08-27.preview#v2_account_object-configuration-storer) | #### .NET | Parameter | Change | Resources or methods | | --------- | ------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | `Applied` | Added | [V2.Core.Account.Configuration.Customer](/api/v2/core/accounts/object?api-version=2025-08-27.preview#v2_account_object-configuration-customer), [V2.Core.Account.Configuration.Merchant](/api/v2/core/accounts/object?api-version=2025-08-27.preview#v2_account_object-configuration-merchant), [V2.Core.Account.Configuration.Recipient](/api/v2/core/accounts/object?api-version=2025-08-27.preview#v2_account_object-configuration-recipient), [V2.Core.Account.Configuration.Storer](/api/v2/core/accounts/object?api-version=2025-08-27.preview#v2_account_object-configuration-storer), [V2CoreAccountConfigurationCustomerOptions](/api/v2/core/accounts/update?api-version=2025-08-27.preview#v2_account_object-configuration-customer), [V2CoreAccountConfigurationMerchantOptions](/api/v2/core/accounts/update?api-version=2025-08-27.preview#v2_account_object-configuration-merchant), [V2CoreAccountConfigurationRecipientOptions](/api/v2/core/accounts/update?api-version=2025-08-27.preview#v2_account_object-configuration-recipient), [V2CoreAccountConfigurationStorerOptions](/api/v2/core/accounts/update?api-version=2025-08-27.preview#v2_account_object-configuration-storer) | ## アップグレード #### 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-08-27.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 を [v15.6.0-beta.1](https://github.com/stripe/stripe-ruby/releases/tag/v15.6.0-beta.1)にアップグレードします。 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 を [v12.6.0b1](https://github.com/stripe/stripe-python/releases/tag/v12.6.0b1)にアップグレードします。 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 を [v17.7.0-beta.1](https://github.com/stripe/stripe-php/releases/tag/v17.7.0-beta.1)にアップグレードします。 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 を [v29.6.0-beta.1](https://github.com/stripe/stripe-java/releases/tag/v29.6.0-beta.1)にアップグレードします。 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 を [v18.6.0-beta.1](https://github.com/stripe/stripe-node/releases/tag/v18.6.0-beta.1)にアップグレードします。 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 を [v82.6.0-beta.1](https://github.com/stripe/stripe-go/releases/tag/v82.6.0-beta.1)にアップグレードします。 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 を [v48.6.0-beta.1](https://github.com/stripe/stripe-dotnet/releases/tag/v48.6.0-beta.1)にアップグレードします。 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)について、詳細をご確認ください。 ## 関連する変更 - [Balance Settings リクエストオブジェクトを新しい Payments パラメータにネストします](https://docs.stripe.com/changelog/basil/2025-08-27/balance-settings-nested-in-payments-field.md)