Public preview
Adds support for automatic surcharge calculations on Checkout Sessions Public preview
What’s new
Adds support for automatic surcharge calculations on Checkout Sessions. When you set automatic_surcharge.enabled to true, Stripe calculates a surcharge after the customer provides their payment details and billing address.
Impact
You can now collect surcharge fees when using Checkout Sessions. A surcharge is a fee added to a transaction to offset payment processing costs. It’s typically a percentage of the order amount you charge customers when they use certain payment methods (primarily credit cards).
Changes
| Parameters | Change | Resources or endpoints |
|---|---|---|
| automatic_surcharge | Added | Checkout. Session Checkout. Session#create |
| surcharge_cost | Added | Checkout. Session |
| amount_surcharge | Added | Checkout. Session. total_details |
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: 2026-04-22. preview
- 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.