# Payment method settings Display a configurable list of payment methods that connected accounts can offer during checkout. Render a connected account’s [Payment Method Configuration](https://docs.stripe.com/api/payment_method_configurations.md) to enable customization of payment methods displayed at checkout. Connected accounts can customize their checkout payment methods and provide the necessary compliance details for their usage. > This Connect embedded component is in private preview. [Subscribe](https://docs.stripe.com/connect/supported-embedded-components/payment-method-settings.md#next-steps) below to get notified when the component is available. Note: The following is a preview/demo component that behaves differently than live mode usage with real connected accounts. The actual component has more functionality than what might appear in this demo component. For example, for connected accounts without Stripe dashboard access (custom accounts), no user authentication is required in production. > We support the following payment methods in the embedded component: > > - ACH Direct Debit - Affirm - Afterpay Clearpay - Amazon Pay - Apple Pay - Canadian pre-authorized debits - Bancontact - BLIK - Cards - EPS - Google Pay - iDEAL - Klarna - Link - P24 - Zip The embedded payment method settings uses the [Payment Method Configurations](https://docs.stripe.com/connect/payment-method-configurations.md) and [Account Capabilities](https://docs.stripe.com/connect/account-capabilities.md) APIs to display a list of customizable payment methods to your connected accounts. If a connected account requires additional compliance data prior to requesting the payment method [capability](https://docs.stripe.com/api/capabilities/object.md), the component indicates this and collects the necessary information in advance. ## Requirements Your integration must use [dynamic payment methods](https://docs.stripe.com/connect/dynamic-payment-methods.md) to automatically apply the connected account’s preferences during checkout. In prebuilt payment UIs such as [Payment Element](https://stripe.com/payments/elements) and [Checkout](https://stripe.com/payments/checkout), Stripe handles the logic for displaying eligible payment methods for each transaction. Install a beta version of the Stripe SDKs to create account sessions for private preview components: - [Ruby](https://github.com/stripe/stripe-ruby/#public-preview-sdks) `>=15.5.0-beta.1` - [Python](https://github.com/stripe/stripe-python/#public-preview-sdks) `>=12.5.0b1` - [PHP](https://github.com/stripe/stripe-php/#public-preview-sdks) `>=17.6.0-beta.1` - [Node](https://github.com/stripe/stripe-node/#public-preview-sdks) `>=18.5.0-beta.1` - [.NET](https://github.com/stripe/stripe-dotnet#public-preview-sdks) `>=48.5.0-beta.1` - [Java](https://github.com/stripe/stripe-java#public-preview-sdks) `>=29.5.0-beta.1` - [Go](https://github.com/stripe/stripe-go#public-preview-sdks) `>=82.5.0-beta.1` Use the beta version of the Stripe’s client-side libraries to render private preview components: #### npm Install the library: ```bash npm install --save @stripe/connect-js@preview ``` If you’re using React in your application: ```bash npm install --save @stripe/react-connect-js@preview ``` #### GitHub Download the [@stripe/connect-js](https://github.com/stripe/connect-js) and [@stripe/react-connect-js](https://github.com/stripe/react-connect-js) libraries source code directly from GitHub. ## Integrate the component When [creating an Account Session](https://docs.stripe.com/api/account_sessions/create.md), enable payment method settings by specifying `payment_method_settings` in the `components` parameter. ```curl curl https://api.stripe.com/v1/account_sessions \ -u "<>:" \ -H "Stripe-Version: 2026-02-25.preview; embedded_connect_beta=v2;" \ -d account="{{CONNECTEDACCOUNT_ID}}" \ -d "components[payment_method_settings][enabled]"=true ``` After creating the account session and [initializing ConnectJS](https://docs.stripe.com/connect/get-started-connect-embedded-components.md#account-sessions), you can render the payment method settings component in the frontend: #### JavaScript ```js // Include this element in your HTML const paymentMethodSettings = stripeConnectInstance.create('payment-method-settings'); container.appendChild(paymentMethodSettings); ``` ### Platform-level controls The embedded payment method settings component respects the platform-level defaults that you configure in the [Dashboard](https://docs.stripe.com/connect/payment-methods.md) or the [Payment Method Configurations API](https://docs.stripe.com/connect/payment-method-configurations.md). For payment methods that you configure as **On by default** or **Off by default**, the connected account can override that preference in the component. If you’ve set a payment method to **Blocked**, it’s completely hidden in the component. ### Multiple payment method configurations With default settings, the embedded payment method settings component shows the connected account’s default payment method configuration. During the preview, the component supports [multiple configurations](https://docs.stripe.com/connect/multiple-payment-method-configurations.md) with the `payment-method-configuration` attribute. ### Supported parameters This embedded component supports the following parameters: #### HTML + JS | Method | Type | Description | | | ------------------------------- | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------- | | `setPaymentMethodConfiguration` | `string` | Set the payment method configuration ID to appear in the component. You can pass any payment method configuration that the connected account owns. If you don’t set this parameter, the embedded component shows the connected account’s default payment method configuration that inherits from your platform’s settings. For more information, see [Payment method configurations](https://docs.stripe.com/payments/payment-method-configurations.md) or [List payment method configurations](https://docs.stripe.com/api/payment_method_configurations/list.md). | optional | | #### React | React prop | Type | Description | | | ---------------------------- | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | -------- | | `paymentMethodConfiguration` | `string` | The payment method configuration ID that appears in the component. You can pass any payment method configuration that the connected account owns. If you don’t set this parameter, the embedded component shows the connected account’s default payment method configuration that inherits from your platform’s settings. For more information, see [Payment method configurations](https://docs.stripe.com/payments/payment-method-configurations.md) or [List payment method configurations](https://docs.stripe.com/api/payment_method_configurations/list.md). | optional | ## Next steps (Private preview) Sign in to subscribe to updates about this Connect embedded component. If you don’t have a Stripe account, you can [register here](https://dashboard.stripe.com/register). ## See also - [Connect integration guide](https://docs.stripe.com/connect/charges.md) - [Upgrading to dynamic payment methods](https://docs.stripe.com/connect/dynamic-payment-methods.md) - [Payment Method Configurations API](https://docs.stripe.com/connect/payment-method-configurations.md) - [Account Capabilities API](https://docs.stripe.com/connect/account-capabilities.md)