Payment method settingsPrivate preview

Render a connected account’s Payment Method Configuration 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.

The embedded payment method settings uses the Payment Method Configurations and Account Capabilities 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, the component indicates this and collects the necessary information in advance.

Requirements

Your integration must use dynamic payment methods to automatically apply the connected account’s preferences during checkout. In prebuilt payment UIs such as Payment Element and 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 >=12.5.0-beta.1
• Python >=10.6.0b1
• PHP >=15.5.0-beta.1
• Node >=16.6.0-beta.1
• .NET >=45.6.0-beta.1
• Java >=26.6.0-beta.1
• Go >=79.6.1-beta.1

Use the beta version of the Stripe’s client-side libraries to render private preview components:

Integrate the component

When creating an Account Session, enable payment method settings by specifying payment_method_settings in the components parameter.

curl https://api.stripe.com/v1/account_sessions \
  -u "
sk_test_4eC39HqLyjWDarjtT1zdp7dc
:" \
  -H "Stripe-Version: 2024-11-20.acacia; embedded_connect_beta=v2;" \
  -d account=
{{CONNECTED_ACCOUNT_ID}} \
  -d "components[payment_method_settings][enabled]"=true

After creating the account session and initializing ConnectJS, you can render the payment method settings component in the frontend:

// 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 or the Payment Method Configurations API.

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 have 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 with the payment-method-configuration attribute.

Supported parameters

This embedded component supports the following parameters:

Request early access Private preview

Sign in to request access to this Connect embedded component in preview.

If you don’t have a Stripe account, you can register here.