# Accounts v2 にコンビニ決済と日本語の明細書表記のサポートを追加 ## 新機能 [Accounts v2](https://docs.stripe.com/api/v2/core/accounts.md?api-version=2025-11-17.preview) を使用して [konbini_payments](https://docs.stripe.com/api/accounts/update.md?api-version=2025-11-17.clover#update_account-capabilities-konbini_payments) ケイパビリティをリクエストし、その要件を満たす機能を追加しました。`konbini_payments` ケイパビリティをサポートするために、[加盟店設定](https://docs.stripe.com/api/v2/core/accounts/object.md?api-version=2025-11-17.preview#v2_account_object-configuration-merchant)に新しいフィールドを追加しました。 - [konbini_payments](https://docs.stripe.com/api/v2/core/accounts/object.md?api-version=2025-11-17.preview#v2_account_object-configuration-merchant-konbini_payments): メール、電話、サポートの対応時間など、コンビニ決済ケイパビリティに固有のサポートフィールドが含まれます。 - [script_statement_descriptor](https://docs.stripe.com/api/v2/core/accounts/object.md?api-version=2025-11-17.preview#v2_account_object-configuration-merchant-script_statement_descriptor): 日本の決済明細書に、カナと漢字の明細書表記を設定できます。 コンビニ決済の詳細については、[コンビニ決済のドキュメント](https://docs.stripe.com/payments/konbini.md)を参照してください。 ## 影響 Accounts v2 で `konbini_payments` ケイパビリティをリクエストし、新しい必須フィールドを指定することで、日本の連結アカウントでコンビニ決済を有効にできるようになりました。これにより、連結アカウントは決済手段としてコンビニ決済を顧客に提供できるようになります。 さらに、カナと漢字でのローカライズされた明細書表記を用意して、日本の顧客の決済明細書に正しく表示され、日本での決済明細書の明瞭さを向上させることができます。 ## 変更点 #### REST API | Parameters | Change | Resources or endpoints | | ------------------------------------------------- | ------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `konbini_payments`, `script_statement_descriptor` | Added | [V2.Core.Account#create.configuration.merchant](/api/v2/core/accounts/create?api-version=2025-11-17.preview#v2_create_accounts-configuration-merchant), [V2.Core.Account#update.configuration.merchant](/api/v2/core/accounts/update?api-version=2025-11-17.preview#v2_update_accounts-configuration-merchant), [V2.Core.Account.configuration.merchant](/api/v2/core/accounts/object?api-version=2025-11-17.preview#v2_account_object-configuration-merchant) | #### Ruby | Parameters | Change | Resources or methods | | ------------------------------------------------- | ------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | `konbini_payments`, `script_statement_descriptor` | Added | [V2::Core::Account::Configuration::Merchant](/api/v2/core/accounts/object?api-version=2025-11-17.preview#v2_account_object-configuration-merchant), [V2::Core::AccountCreateParams::Configuration::Merchant](/api/v2/core/accounts/create?api-version=2025-11-17.preview#v2_create_accounts-configuration-merchant), [V2::Core::AccountUpdateParams::Configuration::Merchant](/api/v2/core/accounts/update?api-version=2025-11-17.preview#v2_update_accounts-configuration-merchant) | #### Python | Parameters | Change | Resources or methods | | ------------------------------------------------- | ------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `konbini_payments`, `script_statement_descriptor` | Added | [V2.Core.Account.Configuration.Merchant](/api/v2/core/accounts/object?api-version=2025-11-17.preview#v2_account_object-configuration-merchant), [v2.core.AccountCreateParamsConfigurationMerchant](/api/v2/core/accounts/create?api-version=2025-11-17.preview#v2_create_accounts-configuration-merchant), [v2.core.AccountModifyParamsConfigurationMerchant](/api/v2/core/accounts/update?api-version=2025-11-17.preview#v2_update_accounts-configuration-merchant) | #### PHP | Parameters | Change | Resources or methods | | ------------------------------------------------- | ------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `konbini_payments`, `script_statement_descriptor` | Added | [V2.Core.Account.configuration.merchant](/api/v2/core/accounts/object?api-version=2025-11-17.preview#v2_account_object-configuration-merchant), [V2\Core\Account.create().$params.configuration.merchant](/api/v2/core/accounts/create?api-version=2025-11-17.preview#v2_create_accounts-configuration-merchant), [V2\Core\Account.update().$params.configuration.merchant](/api/v2/core/accounts/update?api-version=2025-11-17.preview#v2_update_accounts-configuration-merchant) | #### Java | Parameters | Change | Resources or methods | | ---------------------------------------------- | ------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | `konbiniPayments`, `scriptStatementDescriptor` | Added | [v2.core.Account.configuration.merchant](/api/v2/core/accounts/object?api-version=2025-11-17.preview#v2_account_object-configuration-merchant), [v2.core.AccountCreateParams.configuration.merchant](/api/v2/core/accounts/create?api-version=2025-11-17.preview#v2_create_accounts-configuration-merchant), [v2.core.AccountUpdateParams.configuration.merchant](/api/v2/core/accounts/update?api-version=2025-11-17.preview#v2_update_accounts-configuration-merchant) | #### Node.js | Parameters | Change | Resources or methods | | ------------------------------------------------- | ------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | `konbini_payments`, `script_statement_descriptor` | Added | [V2.Core.Account.configuration.merchant](/api/v2/core/accounts/object?api-version=2025-11-17.preview#v2_account_object-configuration-merchant), [V2.Core.AccountCreateParams.configuration.merchant](/api/v2/core/accounts/create?api-version=2025-11-17.preview#v2_create_accounts-configuration-merchant), [V2.Core.AccountUpdateParams.configuration.merchant](/api/v2/core/accounts/update?api-version=2025-11-17.preview#v2_update_accounts-configuration-merchant) | #### Go | Parameters | Change | Resources or methods | | ---------------------------------------------- | ------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `KonbiniPayments`, `ScriptStatementDescriptor` | Added | [V2CoreAccountConfigurationMerchant](/api/v2/core/accounts/object?api-version=2025-11-17.preview#v2_account_object-configuration-merchant), [V2CoreAccountConfigurationMerchantParams](/api/v2/core/accounts/create?api-version=2025-11-17.preview#v2_create_accounts-configuration-merchant) | #### .NET | Parameters | Change | Resources or methods | | ---------------------------------------------- | ------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `KonbiniPayments`, `ScriptStatementDescriptor` | Added | [V2.Core.Account.Configuration.Merchant](/api/v2/core/accounts/object?api-version=2025-11-17.preview#v2_account_object-configuration-merchant), [V2CoreAccountConfigurationMerchantOptions](/api/v2/core/accounts/create?api-version=2025-11-17.preview#v2_create_accounts-configuration-merchant) | ## アップグレード #### 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-requirements-collection.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 に 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)