Breaking changes
Removes currency conversion field from Checkout Sessions Breaking changes
What’s new
Removes the currency_conversion field from Checkout Sessions.
Why is this a breaking change?
Previously, the currency_conversion field provided details about Adaptive Pricing for Checkout Sessions created before the relevant part of the product Any Checkout Sessions created after the relevant part of the product 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 starting with API version 2025-09-30.clover 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 the relevant part of the product, use the presentment_details field stored on the Checkout Session object
Changes
| Parameter | Change | Resources or endpoints |
|---|---|---|
| currency_conversion | Changed | Checkout. Session |
Upgrade
- View your current API version in Workbench.
- If you use an SDK, upgrade to the corresponding SDK version for this API version.
- If you don’t use an SDK, update your API requests to include Stripe-Version: 2025-09-30. clover
- Upgrade the API version used for webhook endpoints .
- Test your integration against the new version.
- If you use Connect, test your Connect integration .
Learn more about Stripe API upgrades.
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