Adds presentment details for Adaptive Pricing

What’s new

Adds a presentment_details object to the Checkout Session to provide information about the currency and amount presented to customers when Adaptive Pricing was used on a Checkout Session.

Impact

A recent update to Adaptive Pricing maintains Checkout Session currency in the same currency as your Stripe integration, with context about the customer’s choice now available under Checkout Session presentment_details when Adaptive Pricing is used. Previously, currency was the customer’s choice of currency and the currency of your Stripe integration was described under currency_conversion.

We plan to remove the legacy currency_conversion field from the Checkout Session resource in a future release. To prepare, update your integration by replacing references to currency_conversion.source_currency with Checkout Session currency, and currency_conversion.amount_total with Checkout Session amount_total. For information about the currency selected by your customer, see presentment_details.

Changes

Upgrade

1. View your current API version in Workbench.
2. 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-03-31. basil

3. Upgrade the API version used for webhook endpoints .
4. Test your integration against the new version.
5. If you use Connect, test your Connect integration .
6. In Workbench, perform the upgrade . You can roll back the version for 72 hours.

Learn more about Stripe API upgrades.