Skip to content
Create account
or
Sign in
The Stripe Docs logo
/
Ask AI
Create account
Sign in
Get started
Payments
Finance automation
Platforms and marketplaces
Money management
Developer tools
Get started
Payments
Finance automation
Get started
Payments
Finance automation
Platforms and marketplaces
Money management
Overview
Get started with Connect
Integration fundamentals
Example integrations
Onboard accounts
Configure account Dashboards
Accept payments
Pay out to accounts
Manage your Connect platform
Tax forms for your Connect platform
Work with connected account types
    Connected account types
    Dynamic payment methods
      Payment Method Configurations API
HomePlatforms and marketplacesWork with connected account types

Update to use dynamic payment methods

Add dynamic payment methods to your existing platform.

Copy page

This guide provides instructions for existing platforms to integrate dynamic payment methods. If you’re setting up a new platform, start with the Connect integration guide.

Integration instructions for dynamic payment methods

Use the following form to select your integration. If you need help determining your platform setup, including checkout solution, connected account types, and charge types, refer to Create a charge.

Confirm your integration
Checkout is a Stripe-hosted payment form.
Payment Element (for web and mobile) is a UI component that you embed into your website or app.

Enable payment methods for connected accounts
Recommended

If necessary, consult the following resources for payment method information:

  • A guide to payment methods for help in choosing the right payment methods for your platform.
  • Account capabilities to make sure your chosen payment methods work for your connected accounts.
  • Payment method and product support table to make sure your chosen payment methods work for your Stripe products and payments flows.

Stripe enables certain payment methods for your connected accounts by default. Visit the Manage payment methods for your connected accounts page in your Dashboard to configure which payment methods your connected accounts accept. Changes to default settings apply to all new and existing connected accounts.

For each payment method, you can select one of the following dropdown options:

On by defaultYour connected accounts accept this payment method during checkout. Some payment methods can only be off or blocked, this is because the owners of your platform’s connected accounts must activate them in their Dashboard settings page.
Off by defaultYour connected accounts don’t accept this payment method during checkout. If you allow the owners of your platform’s connected accounts to manage their own payment methods in their Dashboard, however, they have the ability to turn it on.
BlockedYour connected accounts don’t accept this payment method during checkout. If you allow the owners of your platform’s connected accounts to manage their own payment methods in their Dashboard, they don’t have the option to turn it on.
Dropdown options for payment methods, each showing an available option (blocked, on by default, off by default)

Payment method options

If you make a change to a payment method, you must click Review changes in the bottom bar of your screen and Save and apply to update your connected accounts.

Dialog that shows after clicking Save button with a list of what the user changed

Save dialog

Allow your connected accounts to manage their payment methods
Recommended

Stripe recommends that you allow the owners of your platform’s connected accounts to customize their own payment methods from the Dashboard. If you enable this option, then each connected account with Stripe Dashboard access can log in to their Dashboard and view their Payment methods page. The Dashboard displays the set of payment method defaults you applied to all new and existing connected accounts. The owners of your platform’s connected accounts can override these defaults, excluding payment methods you have blocked.

Check the Account customization checkbox to enable this option. You must click Review changes in the bottom bar of your screen and then select Save and apply to update this setting.

Screenshot of the checkbox to select when allowing connected owners to customize payment methods

Account customization checkbox

Integrate Checkout using dynamic payment methods
Required

Previously, you might have used the payment_method_types parameter when defining your Checkout session to accept different payment methods. To begin managing your payment methods in the Dashboard, remove this parameter from your integration.

After you remove the payment_method_types parameter from your integration, some payment methods turn on automatically, including cards and wallets. The currency parameter restricts the payment methods that are shown to the customer during the checkout session.

Select a languageRuby
Stripe::Checkout::Session.
create
({
mode
: 'payment', # Remove the payment_method_types parameter # to manage payment methods in the Dashboard
payment_method_types
: ['card'],
line_items
: [{
price_data
: { # The currency parameter determines which # payment methods are used in the Checkout Session.
currency
: 'eur',
product_data
: {
name
: 'T-shirt', },
unit_amount
: 2000, },
quantity
: 1, }],
success_url
: 'https://example.com/success',
cancel_url
: 'https://example.com/cancel', })

Enable shipping address collection in Checkout
Recommended

If you collect shipping addresses, you need to define which countries you can ship to when you create the Checkout session. Specify the two-letter ISO country codes in the shipping_address_collection.allowed_countries parameter.

You can optionally add shipping rates with the shipping_options parameter.

If you use Afterpay or Clearpay, you must collect shipping addresses, but you don’t need to specify shipping rates for those payment methods.

Note

Shipping address collection is required to use Afterpay or Clearpay as a payment method in Checkout, but shipping rates aren’t.

Handle delayed notification payment methods, if applicable
Recommended

Follow the steps in our Manage payment methods in the Dashboard guide on how to handle delayed notification payment methods.

Test your integration
Recommended

Test your integration to ensure it performs as you expect. Log in to one of your test accounts and navigate to Payment methods settings to view your settings for your connected accounts. Test your checkout flow with your test API key and a test account. If a payment method you expect to be available is not available, check the payment method product support table to make sure your products and merchants are in a compatible currency and country.

Have your connected accounts with Stripe Dashboard access enable any payment methods that require setup steps
Optional

Your connected accounts with Stripe Dashboard access are able to use most payment methods by default; however, some payment methods (such as Alipay and WeChat Pay) require your users to manually activate the payment method in their Dashboard. Confirm which payment methods require manual activation using the payment method capabilities table. If the Available by default column reads no, the payment method requires manual activation.

If you allow the owners of your platform’s connected accounts to manage payment methods, then instruct them to enable these payment methods from their Dashboard.

Screenshot of connected account payment method customization through Dashboard showing available payment methods as on and available.

Payment method customization

If you don’t allow the owners of your platform’s connected accounts to customize payment methods, then instruct them to visit their manual settings page.

Screenshot of manual settings page with payment methods listed with the option to request access, request invite, or configure.

Manual settings for payment methods

Private preview

The embedded payment method settings component allows connected accounts to configure the payment methods they offer at checkout without the need to access the Stripe Dashboard. Request access and learn how to integrate with Payment Method Configurations.

See also

  • Connect integration guide
  • Payment method configurations API
  • Multiple payment method configurations
  • Add payment method capabilities
Was this page helpful?
YesNo
Need help? Contact Support.
Join our early access program.
Check out our changelog.
Questions? Contact Sales.
LLM? Read llms.txt.
Powered by Markdoc
You can unsubscribe at any time. Read our privacy policy.
On this page
Integration instructions for dynamic payment methods
Enable payment methods for connected accounts
Allow your connected accounts to manage their payment methods
Integrate Checkout using dynamic payment methods
Enable shipping address collection in Checkout
Handle delayed notification payment methods, if applicable
Test your integration
Have your connected accounts with Stripe Dashboard access enable any payment methods that require setup steps
See also
Products Used
Connect

Assistant

Responses are generated using AI and may contain mistakes.

Ask questions about Stripe and get help with your integration.

Tip: you can highlight any text to ask questions about it

Stripe Shell
Test mode
Welcome to the Stripe Shell! Stripe Shell is a browser-based shell with the Stripe CLI pre-installed. Log in to your Stripe account and press Control + Backtick (`) on your keyboard to start managing your Stripe resources in test mode. - View supported Stripe commands: - Find webhook events: - Listen for webhook events: - Call Stripe APIs: stripe [api resource] [operation] (e.g., )
The Stripe Shell is best experienced on desktop.
$