Removes currency conversion field from Checkout Session objectBreaking changes
What’s new
Removes the currency_conversion field from the Checkout Session object for any requests made with API version 2025-09-30. or later.
Why is this a breaking change?
Previously, the currency_conversion field provided details about Adaptive Pricing for Checkout Sessions created before 2025-03-30. Any Checkout Sessions created after 2025-03-30 that use Adaptive Pricing have the presentment_details field populated instead.
Impact
The currency_conversion field contains currency and amount information when Adaptive Pricing was used on a Checkout Session.
To get this information for any requests made with API version 2025-09-30. or later:
- For Checkout Session objects created before 2025-03-30, use the top level fields on the Checkout Session object
- For Checkout Session objects created on or after 2025-03-30, use the presentment_details field stored on the Checkout Session object
Upgrade
Related changes
- Removes postal code for card payments in certain regions on Checkout and Payment Element
- Removes support for the redirectToCheckout method
- Updates initCheckout to be synchronous
- Adds support for collecting business and individual names in Checkout Sessions
- Adds the ability to exclude payment methods from Checkout Sessions and Payment Intents
- Adds support for setting the capture method for specific payment methods with the Checkout Sessions API
- Adds support for configuring branding settings for Checkout Sessions
- Enables specifying units of measurement for Products