# PaymentMethods can now list payment methods for a customer account using Accounts v2

## What’s new

Adds two new optional parameters for [listing PaymentMethods](https://docs.stripe.com/api/payment_methods/list.md?api-version=2025-11-17.preview) of a [customer account](https://docs.stripe.com/api/v2/core/accounts/create.md?api-version=2025-11-17.preview#v2_create_accounts-configuration-customer) using [Accounts v2](https://docs.stripe.com/api/v2/core/accounts/create.md?api-version=2025-11-17.preview):

- [customer_account](https://docs.stripe.com/api/payment_methods/list.md?api-version=2025-11-17.preview#list_payment_methods-customer_account): retrieves the PaymentMethods for the given customer account
- [allow_redisplay](https://docs.stripe.com/api/payment_methods/list.md?api-version=2025-11-17.preview#list_payment_methods-allow_redisplay): indicates whether this payment method can be shown in a checkout flow (values include `always`, `limited`, or `unspecified`)

## Impact

You can list payment methods for a customer account using Accounts v2 by providing its ID to the `customer_account` field. These two parameters provide parity with existing support for [listing a Customer’s PaymentMethods](https://docs.stripe.com/api/payment_methods/customer_list.md?api-version=2025-11-17.preview) API.

## Changes

#### 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) |

## Upgrade

#### REST API

1. [View your current API version](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench) in Workbench.
1. If you use an SDK, upgrade to the corresponding SDK version for this API version.
   - If you don’t use an SDK, update your [API requests](https://docs.stripe.com/api/versioning.md) to include `Stripe-Version: 2025-11-17.preview`
1. Upgrade the API version used for [webhook endpoints](https://docs.stripe.com/webhooks/versioning.md).
1. [Test your integration](https://docs.stripe.com/testing.md) against the new version.
1. If you use Connect, [test your Connect integration](https://docs.stripe.com/connect/testing.md).
1. In Workbench, [perform the upgrade](https://docs.stripe.com/upgrades.md#perform-the-upgrade). You can [roll back the version](https://docs.stripe.com/upgrades.md#roll-back-your-api-version) for 72 hours.

Learn more about [Stripe API upgrades](https://docs.stripe.com/upgrades.md).

#### Ruby

1. [View your current API version](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench) in Workbench.
1. Upgrade your Ruby SDK to the latest version.
1. Upgrade the API version used for [webhook endpoints](https://docs.stripe.com/webhooks/versioning.md).
1. [Test your integration](https://docs.stripe.com/testing.md) against the new version.
1. If you use Connect, [test your Connect integration](https://docs.stripe.com/connect/testing.md).
1. In Workbench, [perform the upgrade](https://docs.stripe.com/upgrades.md#perform-the-upgrade). You can [roll back the version](https://docs.stripe.com/upgrades.md#roll-back-your-api-version) for 72 hours.

Learn more about [Stripe API upgrades](https://docs.stripe.com/upgrades.md).

#### Python

1. [View your current API version](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench) in Workbench.
1. Upgrade your Python SDK to the latest version.
1. Upgrade the API version used for [webhook endpoints](https://docs.stripe.com/webhooks/versioning.md).
1. [Test your integration](https://docs.stripe.com/testing.md) against the new version.
1. If you use Connect, [test your Connect integration](https://docs.stripe.com/connect/testing.md).
1. In Workbench, [perform the upgrade](https://docs.stripe.com/upgrades.md#perform-the-upgrade). You can [roll back the version](https://docs.stripe.com/upgrades.md#roll-back-your-api-version) for 72 hours.

Learn more about [Stripe API upgrades](https://docs.stripe.com/upgrades.md).

#### PHP

1. [View your current API version](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench) in Workbench.
1. Upgrade your PHP SDK to the latest version.
1. Upgrade the API version used for [webhook endpoints](https://docs.stripe.com/webhooks/versioning.md).
1. [Test your integration](https://docs.stripe.com/testing.md) against the new version.
1. If you use Connect, [test your Connect integration](https://docs.stripe.com/connect/testing.md).
1. In Workbench, [perform the upgrade](https://docs.stripe.com/upgrades.md#perform-the-upgrade). You can [roll back the version](https://docs.stripe.com/upgrades.md#roll-back-your-api-version) for 72 hours.

Learn more about [Stripe API upgrades](https://docs.stripe.com/upgrades.md).

#### Java

1. [View your current API version](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench) in Workbench.
1. Upgrade your Java SDK to the latest version.
1. Upgrade the API version used for [webhook endpoints](https://docs.stripe.com/webhooks/versioning.md).
1. [Test your integration](https://docs.stripe.com/testing.md) against the new version.
1. If you use Connect, [test your Connect integration](https://docs.stripe.com/connect/testing.md).
1. In Workbench, [perform the upgrade](https://docs.stripe.com/upgrades.md#perform-the-upgrade). You can [roll back the version](https://docs.stripe.com/upgrades.md#roll-back-your-api-version) for 72 hours.

Learn more about [Stripe API upgrades](https://docs.stripe.com/upgrades.md).

#### Node.js

1. [View your current API version](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench) in Workbench.
1. Upgrade your Node SDK to the latest version.
1. Upgrade the API version used for [webhook endpoints](https://docs.stripe.com/webhooks/versioning.md).
1. [Test your integration](https://docs.stripe.com/testing.md) against the new version.
1. If you use Connect, [test your Connect integration](https://docs.stripe.com/connect/testing.md).
1. In Workbench, [perform the upgrade](https://docs.stripe.com/upgrades.md#perform-the-upgrade). You can [roll back the version](https://docs.stripe.com/upgrades.md#roll-back-your-api-version) for 72 hours.

Learn more about [Stripe API upgrades](https://docs.stripe.com/upgrades.md).

#### Go

1. [View your current API version](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench) in Workbench.
1. Upgrade your Go SDK to the latest version.
1. Upgrade the API version used for [webhook endpoints](https://docs.stripe.com/webhooks/versioning.md).
1. [Test your integration](https://docs.stripe.com/testing.md) against the new version.
1. If you use Connect, [test your Connect integration](https://docs.stripe.com/connect/testing.md).
1. In Workbench, [perform the upgrade](https://docs.stripe.com/upgrades.md#perform-the-upgrade). You can [roll back the version](https://docs.stripe.com/upgrades.md#roll-back-your-api-version) for 72 hours.

Learn more about [Stripe API upgrades](https://docs.stripe.com/upgrades.md).

#### .NET

1. [View your current API version](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench) in Workbench.
1. Upgrade your .NET SDK to the latest version.
1. Upgrade the API version used for [webhook endpoints](https://docs.stripe.com/webhooks/versioning.md).
1. [Test your integration](https://docs.stripe.com/testing.md) against the new version.
1. If you use Connect, [test your Connect integration](https://docs.stripe.com/connect/testing.md).
1. In Workbench, [perform the upgrade](https://docs.stripe.com/upgrades.md#perform-the-upgrade). You can [roll back the version](https://docs.stripe.com/upgrades.md#roll-back-your-api-version) for 72 hours.

Learn more about [Stripe API upgrades](https://docs.stripe.com/upgrades.md).

## Related changes

- [Updates requirements collection parameters for Accounts v2](https://docs.stripe.com/changelog/clover/2025-11-17/accounts-v2-requirements-collection.md)
- [Adds future requirements field to Accounts v2](https://docs.stripe.com/changelog/clover/2025-11-17/accounts-v2-future-requirements.md)
- [Adds support for PayPay to Accounts](https://docs.stripe.com/changelog/clover/2025-11-17/paypay-connect.md)
- [Adds support for Konbini payments and Japanese statement descriptors in Accounts v2](https://docs.stripe.com/changelog/clover/2025-11-17/accounts-v2-konbini-payments.md)
- [Adds the capabilty to hold EUR funds to Accounts v2](https://docs.stripe.com/changelog/clover/2025-11-17/account-v2-storer-config-eur.md)
- [Adds account and person tokens to Accounts v2 to securely transmit sensitive data](https://docs.stripe.com/changelog/clover/2025-11-17/accounts-v2-tokens.md)