Adaptive Pricing

Manage Adaptive Pricing for Checkout in your Payments settings in the Dashboard. You can enable Adaptive Pricing in a sandbox and live mode. Disabling Adaptive Pricing doesn’t affect Checkout Sessions that have already been converted.

It’s important to display prices consistently according to the selected currency throughout your checkout page, including line items, shipping rates, discounts, tax, and totals.

When using Embedded Components with Adaptive Pricing, the Embedded Components Session object can contain localized values if Adaptive Pricing is active. You should design your integration as though the session could contain amounts and currencies relevant to any country your buyers might be visiting your site from. This workflow relies on preformatted fields like session.total.total.amount. The Checkout Session object returned in the Stripe API remains in the same currency set in your Stripe integration with customer context available under presentment_details and it won’t match exactly with the Embedded Components Session object.

const { actions } = await checkout.loadActions();
const { total } = actions.getSession();

// Display the formatted amounts in your UI
document.getElementById('order-total').textContent = total.total.amount;

The Currency Selector Element is an embeddable UI component that facilitates Adaptive Pricing. Display it near the order total.

<div id="currency-selector"></div>

const currencySelectorElement = checkout.createCurrencySelectorElement();
currencySelectorElement.mount('#currency-selector');

Design best practices

We offer a configurable Currency Selector Element for your checkout page. Follow these best practices when choosing where to place your selector:

• Add the Currency Selector near where payment details are entered, ideally directly above the Payment Element, since the selected currency might affect available payment methods.
• If the Payment Element isn’t initially visible (due to multi-step flows or being lower on the page), position the Currency Selector near the total price display.
• If you’re using the Express Checkout Element, we recommend placing the Currency Selector Element above the Express Checkout Element to ensure your customers know what currency they will be charged in.
• Apply these tips to your page layouts for all screen sizes.

Once you have localized and formatted your prices and rendered the currency selector, mark your integration as ready for Adaptive Pricing by setting the adaptivePricing.allowed parameter when you initialize checkout.

const checkout = stripe.initCheckout({
  clientSecret,
  // Mark your integration as ready for Adaptive Pricing
  adaptivePricing: {
    allowed: true
  }
});
// Use `checkout` to build your checkout page

After your integration is marked as ready, you can manage Adaptive Pricing in your Payments settings in the Dashboard, or per Checkout Session using the adaptive_pricing.enabled parameter.

Adaptive Pricing can increase the usage of local payment methods by ensuring customers have the option to pay in their local currency and with payment methods most relevant to them. As an example, 70% of all e-commerce transactions in the Netherlands use iDEAL, but it only works with EUR. You can configure which payment methods you accept in your payment methods settings if you use dynamic payment methods. Adaptive Pricing provides access to the following payment methods that require presenting in local currency:

• Amazon Pay
• Bancontact
• BLIK
• EPS
• iDEAL
• Link
• P24
• Pix
• South Korean cards
• Naver Pay
• Kakao Pay
• PAYCO
• Revolut Pay
• Samsung Pay
• Wechat Pay

To test local currency presentment, pass in a location-formatted customer email that includes a suffix in a +location_XX format in the local part of the email. XX must be a valid two-letter ISO country code.

For example, to test currency presentment for a customer in France, pass in an email like test+location_FR@example.com.

When you view your checkout page with the Currency Selector Element and Payment Element using a CheckoutSession created with a location-formatted email, you see the same currency as a customer does in the specified country.

When you create a Checkout Session, pass the location-formatted email as customer_email to simulate Checkout from a particular country.

curl https://api.stripe.com/v1/checkout/sessions \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d "line_items[0][price]"={{PRICE_ID}} \
  -d "line_items[0][quantity]"=1 \
  -d mode=payment \
  -d ui_mode=custom \
  -d "adaptive_pricing[enabled]"=true \
  -d return_url={{RETURN_URL}} \
  --data-urlencode customer_email="test+location_FR@example.com"

You can also create a Customer and specify their email that contains the +location_XX suffix. Stripe test cards work as usual.

Adaptive Pricing isn’t available for businesses using Elements with the Payment Intents API.

Adaptive Pricing isn’t supported for Indian businesses.

Additionally, Adaptive Pricing requires the currency for your prices to be one of your settlement currencies. Prices automatically convert during checkout. This applies to prices you create and reference with a price ID and prices you create inline with price_data when you create a Checkout Session.

If you process payments through a platform, we require your platform’s integration currency to be the settlement currency of the merchant of record on the charge.

Adaptive Pricing doesn’t apply for Checkout Sessions that:

• Contain explicitly defined manual currency prices.
• Are in subscription mode.
• Use capture_method as manual.
• Use custom amounts.

Checkout Sessions that aren’t supported by Adaptive Pricing present prices in the original currency that you’ve set your prices in.