> This page is for Developer.

> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.bigcommerce.com/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.bigcommerce.com/_mcp/server.

## Stripe Adaptive Pricing in custom checkouts

A new guide shows how to surface [Stripe Adaptive Pricing](https://docs.stripe.com/payments/currencies/localize-prices/adaptive-pricing?payment-ui=embedded-components) in a custom checkout built on [checkout-sdk-js](https://github.com/bigcommerce/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](https://github.com/bigcommerce/checkout-js) support Adaptive Pricing without additional work.

For details, see [Integrating Stripe Adaptive Pricing](/developer/docs/admin/checkout-and-cart/payment-providers/stripe/integrating-stripe-adaptive-pricing).