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
About Stripe payments
Upgrade your integration
Payments analytics
Online payments
OverviewFind your use caseManaged Payments
Use Payment Links
Build a checkout page
Build an advanced integration
Build an in-app integration
Payment Methods
Add payment methods
Manage payment methods
    Payment method support
    Payment method support for platforms and marketplaces
    Register payment method domains
    Dynamic payment methods
    Dynamic payment methods
    A/B testing payment methods
    Payment method rules
    Payment method configurations
Faster checkout with Link
Payment interfaces
Payment Links
Checkout
Web Elements
In-app Elements
Payment scenarios
Custom payment flows
Flexible acquiring
Orchestration
In-person payments
Terminal
Other Stripe products
Financial Connections
Crypto
Climate
HomePaymentsManage payment methods

Dynamic payment methods

Simplify your payment methods code by dynamically ordering and displaying payment methods.

Copy page

Dynamic payment methods is part of the default Stripe integration and enables you to configure payment methods settings from the Dashboard – no code required. When you use dynamic payment methods in an Element, Checkout, Payment Links, or Hosted Invoice Page integration, Stripe handles the logic for dynamically displaying the most relevant eligible payment methods to each customer to maximise conversion. Dynamic payment methods also unlocks customisation features to help you customise and experiment with payment methods.

Use dynamic payment methods to:

  • Turn on and manage most payment methods in the Dashboard
  • Eliminate the need to specify eligibility requirements for individual payment methods
  • Apply Stripe’s AI models based on more than 100 signals to dynamically determine which payment methods are eligible and how to display them in order for every checkout session
  • Set rules when payment methods are shown to buyers
  • Run A/B Tests for new payment methods before rolling them out to buyers

Integration options

Use Checkout or Payment Element with dynamic payment methods to have Stripe handle the logic for displaying eligible payment methods in your front end for each transaction. If you have a platform account, follow our Connect integration.

Migrate to dynamic payment methods

Dashboard-based customisation features

Access the following features with dynamic payment methods to control how and when payment methods render.

FeatureDescription
Payment method rulesCustomise how you display payment methods by setting targeting parameters based on amount or the buyer’s location.
A/B test payment methodsTurn on payment methods for a percentage of traffic, run an experiment, and see the resulting impact on conversion rate, average order value, and shift in volume from other payment methods.
Payment method configurationsCreate different sets of payment methods for different checkout scenarios using complex logic, such as only showing specific payment methods for one-off purchases and another set for recurring purchases.
Embed the Payment methods settings componentEmbed a payment method settings page directly into your website to allow your users to manage their payment methods.

How dynamic payment methods work

Apple and Google Pay

This section doesn’t cover Apple Pay and Google Pay, because they use different criteria.

Review this section to understand the criteria that Stripe uses to eligible payment methods, decide whether to hide or show them, and in what order. If a specific payment method isn’t appearing in your payment flow, one or more of these criteria might not be met.

Dashboard settings

View the available payment methods in your Stripe Dashboard. Only payment methods that you enabled can be shown to your customers.

If a payment method isn’t listed in your Dashboard settings, it’s either not supported by Stripe or not supported in the country where your account is registered. For example, PayNow is only available to Stripe accounts in Singapore.

Learn more about country support.

Note

When using Stripe Connect with Direct Charges or on_behalf_of, the settings of the connected account determines the available payment methods. You can configure them in your connect settings.

Product support

Several Stripe products allow you to charge customers, such as Checkout Sessions and Payment Element. Not all payment methods are available in all products. For example, Bacs Direct Debit isn’t available in the Mobile Payment Element. Some payment methods, such as Swish, don’t support recurring payments.

Learn more about product support.

Presentment currency

Stripe supports over 135 presentment currencies, but most payment methods only support a subset of these. For example, ACH Direct Debit is only available for payments in USD currency.

Learn more about currency support.

Charge amount

On top of the general minimum and maximum amount Stripe supports, some payment methods have their own minimum and maximum. For example, SEPA Direct Debit is only available for payments below 10,000 EUR.

Note

The final amount, including tax and discounts, is the amount used to determine available payment methods.

To learn more, go to the a payment method’s overview page.

API support

Some payment methods, such as TWINT, can’t be set up for future usage. When you set setup_future_usage, some payment methods are automatically filtered out.

Similarly, some payment methods, such as iDEAL, don’t support manual capture. When you set capture_method: manual, some payment methods are automatically filtered out.

Learn more about API support.

Customer’s country

A customer’s country impacts which payment methods are available on the payment page, because most payment methods are available in a predefined number of countries. For example, BLIK is only available for customers in Poland.

Learn more about country support.

Other considerations

The following features can also impact the availability of some payment methods:

  • Payment method configuration, to customise the payment method shown.
  • Payment method rules, to show or hide a payment method based on conditions, such as the amount and currencies.
  • A/B testing, to temporarily show or hide a payment method to see its impact on conversion rates.

AI models

For every checkout session, the AI models in the Optimized Checkout Suite dynamically determine how eligible payment methods are displayed, including their order. These models incorporate more than 100 on-session signals – such as real-time payment method uptime and popularity among similar customers – as well as broader network signals, such as preferred payment methods used by similar businesses. The AI models work alongside any payment method logic you add in code or any rules you set up in the Dashboard.

Our AI models use an exploration-exploitation framework, delivering proven strategies while continuously testing new approaches. As a result, payment method ordering quickly adapts to changing customer expectations and systematically improves over time.

Was this page helpful?
YesNo
Need help? Contact Support.
Join our early access programme.
Check out our changelog.
Questions? Contact Sales.
LLM? Read llms.txt.
Powered by Markdoc