We're rolling out new updates to Adaptive Pricing for Checkout and Payment Links starting on April 8, 2025.
We’ve made significant improvements to Adaptive Pricing:
These updates to Adaptive Pricing will be a built-in feature of Payment Links and can no longer be disabled. It will be automatically enabled for Checkout unless you previously disabled it. You can choose to opt out of Adaptive Pricing for Checkout at any time.
Review your integration to make sure any event destinations can handle PaymentIntent objects with local currencies. With these updates, the Checkout Session and the underlying PaymentIntent objects will reflect your default settlement currency and amount so you will no longer need to use the currency_conversion hash to determine what your customer would have paid in your default currency.
If a customer pays in local currency, the checkout.session.completed
event will contain a presentment_details hash that includes the presentment_amount and presentment_currency. The amount and currency reflect what your customer paid in the local currency.
To test the updates to Adaptive Pricing in test mode prior to April 8, 2025, set a beta header on your Checkout Session and/or Payment Link creation requests: Stripe-Version: adaptive_pricing_beta=v1. When testing Payment Links, you also need to specify payment_method_types. For instructions on setting the Stripe-Version header when using a Stripe SDK, see the README file in the respective GitHub repository. The beta header is only supported in test mode.
Learn more about how to test local currency presentment for Checkout and Payment links using location-formatted customer email.