Adds support for disabling future usage of Pix in Checkout Sessions
What’s new
You can now set setup_future_usage to none for Pix payment method options when creating a Checkout Session.
Impact
This update lets you specify that you don’t intend to reuse a Pix payment method for future payments when creating a Checkout Session. By setting setup_future_usage = none, you ensure that the provided payment method is used only for the current transaction.
Changes
| Parameter | Change | Resources or endpoints |
|---|---|---|
| setup_future_usage | Added | Checkout. Session#create. payment_method_options. pix Checkout. Session. payment_method_options. pix |
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-07-30. basil
- 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.