Payment method settingsBeta
Display a configurable list of payment methods that connected accounts can offer during checkout.
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.
Beta
This Connect embedded component is in beta. Request access below.
Note
We support the following payment methods in the embedded component:
Affirm, Afterpay Clearpay, Apple Pay, Bancontact, BLIK, Cards, EPS, Google Pay, iDEAL, Klarna, Link, P24, Sofort, and Zip.
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 beta 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 beta components:
Integrate the component
When creating an Account Session, enable payment method settings by specifying payment_
in the components
parameter.
After creating the account session and initializing ConnectJS, you can render the payment method settings component in the frontend:
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 beta, the component supports multiple configurations with the payment-method-configuration
attribute.
Supported parameters
This embedded component supports the following parameters:
Request early access Beta
Sign in to request access to this Connect embedded component in beta.
If you don’t have a Stripe account, you can register here.