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 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 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 2025-03-30, 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 .
- In Workbench, perform the upgrade . You can roll back the version for 72 hours.
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