Optimized Checkout Suite

Stripe’s Optimized Checkout Suite is a modern version of the payment form. As of version 10.7.0, it’s enabled by default for new merchants.

Advantages

↑ Back to top

The Optimized Checkout Suite uses machine learning to decide the order in which payment methods should be displayed to individual shoppers. The goal is to prioritize payment methods that are most likely to lead to purchases.

The prioritization logic only applies to payment methods that you have enabled in the extension settings or via the Stripe dashboard itself. (It’s possible to use it with just a single payment method enabled if you want.)

Enabling Optimized Checkout Suite also lets you use Adaptive Pricing, which allows your your international customers see prices and pay in their preferred currency.

For more details, see Stripe’s documentation.

Enabling

↑ Back to top

First, update to the most recent version of the Stripe extension to be sure that the Optimized Checkout Suite will be available to you. We recommend enabling automatic updates.

If you need to update the Stripe extension manually, you can update to version 9.8 by following the below steps:

1. In your WordPress dashboard, go to Dashboard > Updates.
2. Click the Check again link to check for plugin updates.
3. If a new version of the Stripe plugin is available, update it.
4. Go to Plugins > Installed Plugins.

Here’s how the Dashboard > Updates page will look if a WooCommerce Stripe Gateway update is available to be installed:

After ensuring the most recent version of the plugin is installed:

1. In your store’s WordPress dashboard, go to WooCommerce > Settings > Payments > Stripe > Settings.
2. Scroll to the Advanced Settings section.
3. Check the box for “Dynamically display the most relevant payment methods you’ve enabled.”
   • You can also optionally enable Adaptive Pricing.
4. Choose a layout option.
5. Click Save Changes at the bottom.

Layout

↑ Back to top

The Layout setting controls how the payment methods are shown in the checkout form. See the images below for a comparison.

Also, since the Optimized Checkout Suite works best when Stripe is at the top of your payment providers list (under WooCommerce > Settings > Payments), we present a notice to you if Stripe is not in the top slot:

Clicking the Move to top button will move Stripe to the top of the payment providers list, thus allowing customers to see the full range of payment methods.

Changing the name in checkout

↑ Back to top

By default, when Optimized Checkout Suite is enabled, the list of payment methods shown in checkout will be under a “Payment methods” title, like so:

To change this, use the wc_stripe_optimized_checkout_title filter:

add_filter( 'wc_stripe_optimized_checkout_title', fn() => 'Pay here!' );

The result:

Troubleshooting

↑ Back to top

There are some situations in which Optimized Checkout Suite cannot be enabled.

Settings Sync disabled

↑ Back to top

For Optimized Checkout Suite to work properly, your site and Stripe both need to know which payment methods you have enabled vs. disabled. This is so that shoppers are only shown your enabled payment methods.

We released a settings sync feature in version 9.5.0 that is responsible for keeping your enabled payment methods synchronized between your site and Stripe’s systems. This syncing is critical to Optimized Checkout Suite.

To check to see if settings sync is working correctly:

1. In your WordPress dashboard, navigate to WooCommerce > Settings > Payments.
2. Click the Manage button for the Stripe extension.
3. Click the Settings tab.
4. In the Account Details section, make sure that Sync shows as Enabled.

If the Sync feature does not show Enabled, you will need to reconnect your site to Stripe’s system before Optimized Checkout Suite will be available.

Stripe account on another platform

↑ Back to top

If you created your Stripe account through another platform or service, it may still be controlled by that platform/service, and not by WooCommerce.

To take advantage of the Optimized Checkout Suite, you’ll need to disconnect from that platform account and then reconnect to the WooCommerce platform account.

Using manual API keys

↑ Back to top

Sites that are still using manually entered API keys may not be eligible for Optimized Checkout Suite. Re-authenticating your connection solves this issue.

Some methods not shown

↑ Back to top

Optimized Checkout Suite will only show a payment method if it’s relevant to a given customer. For example, Przelewy24 will be hidden for customers outside Poland.

Furthermore, although the Stripe dashboard shows many payment methods, our Stripe plugin can only support a subset of those. Here’s the list of what our plugin supports.