# PaymentMethods が Accounts v2 を使用して顧客アカウントの決済手段を一覧表示できるようになりました ## 新機能 [Accounts v2](https://docs.stripe.com/api/v2/core/accounts/create.md?api-version=2025-11-17.preview) を使用して [顧客アカウント](https://docs.stripe.com/api/v2/core/accounts/create.md?api-version=2025-11-17.preview#v2_create_accounts-configuration-customer)の [PaymentMethods を一覧表示](https://docs.stripe.com/api/payment_methods/list.md?api-version=2025-11-17.preview)するための 2 つの新しいオプションパラメーターを追加します。 - [customer_account](https://docs.stripe.com/api/payment_methods/list.md?api-version=2025-11-17.preview#list_payment_methods-customer_account): 指定された顧客アカウントの PaymentMethods を取得 - [allow_redisplay](https://docs.stripe.com/api/payment_methods/list.md?api-version=2025-11-17.preview#list_payment_methods-allow_redisplay): この決済手段を決済フローに表示できるかどうかを表しています (値には `always`、`limited` または `unspecified` が含まれます) ## 影響 Accounts v2 を利用して`customer_account` フィールドに顧客アカウントの ID を指定することでそのアカウントの決済手段を一覧表示できます。これら 2 つのパラメーターが提供する機能は顧客の [PaymentMethods API](https://docs.stripe.com/api/payment_methods/customer_list.md?api-version=2025-11-17.preview) を一覧表示する既存のサポートと同等の機能です。 ## 変更点 #### REST API | Parameters | Change | Resources or endpoints | | ------------------------------------- | ------ | ------------------------------------------------------------------------------ | | `allow_redisplay`, `customer_account` | Added | [PaymentMethod#list](/api/payment_methods/list?api-version=2025-11-17.preview) | #### Ruby | Parameters | Change | Resources or methods | | ------------------------------------- | ------ | ----------------------------------------------------------------------------------- | | `allow_redisplay`, `customer_account` | Added | [PaymentMethodListParams](/api/payment_methods/list?api-version=2025-11-17.preview) | #### Python | Parameters | Change | Resources or methods | | ------------------------------------- | ------ | ----------------------------------------------------------------------------------- | | `allow_redisplay`, `customer_account` | Added | [PaymentMethodListParams](/api/payment_methods/list?api-version=2025-11-17.preview) | #### PHP | Parameters | Change | Resources or methods | | ------------------------------------- | ------ | --------------------------------------------------------------------------------------- | | `allow_redisplay`, `customer_account` | Added | [PaymentMethod.all().$params](/api/payment_methods/list?api-version=2025-11-17.preview) | #### Java | Parameters | Change | Resources or methods | | ----------------------------------- | ------ | ----------------------------------------------------------------------------------- | | `allowRedisplay`, `customerAccount` | Added | [PaymentMethodListParams](/api/payment_methods/list?api-version=2025-11-17.preview) | #### Node.js | Parameters | Change | Resources or methods | | ------------------------------------- | ------ | ----------------------------------------------------------------------------------- | | `allow_redisplay`, `customer_account` | Added | [PaymentMethodListParams](/api/payment_methods/list?api-version=2025-11-17.preview) | #### Go | Parameters | Change | Resources or methods | | ----------------------------------- | ------ | ----------------------------------------------------------------------------------- | | `AllowRedisplay`, `CustomerAccount` | Added | [PaymentMethodListParams](/api/payment_methods/list?api-version=2025-11-17.preview) | #### .NET | Parameters | Change | Resources or methods | | ----------------------------------- | ------ | ------------------------------------------------------------------------------------ | | `AllowRedisplay`, `CustomerAccount` | Added | [PaymentMethodListOptions](/api/payment_methods/list?api-version=2025-11-17.preview) | ## アップグレード #### 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) - [アカウントに 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)