Adds item-level discount support for pending updates
What’s new
Adds item-level discount support for pending updates when you update a subscription and create or update a subscription item. When you make changes using payment_behavior=pending_if_incomplete and the payment fails or requires customer action, we now store the item-level discount configuration on the pending_update hash.
Impact
You can now apply item-level discounts to subscription updates without losing the discount details if an update results in an incomplete or failed payment.
To use item-level discounts with pending updates, pass the discounts array on subscription items when updating a subscription or creating or updating a subscription item with payment_behavior=pending_if_incomplete. If payment fails, the discount configuration persists on the pending_update hash until the payment completes, or expires if no successful payment is made in 23 hours. For more details, see Pending updates.
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-07-29. dahlia
- 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.