Adds discount and discounts properties to pending subscription updates
What’s new
Adds the discount hash and discounts array to the pending_update hash on the Subscription object. These properties show any discount changes that are scheduled to take effect at the next billing cycle.
Impact
You can now use discounts when updating a subscription with payment_behavior: "pending_if_incomplete". When you do, you can access the pending discounts on the pending_update hash returned by the subscription update request. If your integration displays subscription details or calculates upcoming charges, you can include pending discount information to give customers a complete picture of their next bill or what the subscription will look like. Learn more about pending updates.
Changes
| Parameters | Change | Resources or endpoints |
|---|---|---|
| discount discounts | Added | Subscription. pending_update |
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-05-27. dahlia
- 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
- Adds discount eligibility options for add-on invoice items on Subscriptions and Preview Invoice APIs
- Adds amount paid off Stripe property to Invoice object
- Adds billing schedules to enable prebilling on subscriptions
- Adds metadata support to pending subscription updates
- Adds credited items information to invoice item proration details
- Adds customer parameter to test clock creation