Changelog

August 3, 2026

Stripe Adaptive Pricing in custom checkouts

A new guide shows how to surface Stripe Adaptive Pricing in a custom checkout built on checkout-sdk-js, letting shoppers pay in their local currency while the store settles in its default currency.

  • Currency selector — render a host container and pass currencySelectorContainerId when initializing the Stripe OCS Checkout Session method; the SDK mounts Stripe’s currency selector and styles it through the Stripe Appearance API.
  • Reacting to currency changes — subscribe to checkout state and read paymentProviderCustomer.isCustomerCurrencySelected to know when a shopper switches to a currency other than the store’s default.
  • Payment method filtering — narrow the payment methods list to only the Stripe OCS Checkout Session method while a presentment currency is active, because other gateways can’t settle in it.
  • Testing and troubleshooting — verify the integration with Stripe test currencies and resolve common issues such as a missing selector or a NotInitializedError.

Requires the Stripe OCS Checkout Session payment method and @bigcommerce/checkout-sdk version 1.948.1 or later. Stores on the reference checkout-js support Adaptive Pricing without additional work.

For details, see Integrating Stripe Adaptive Pricing.