Adds discount eligibility options for add-on invoice items on Subscriptions and Preview Invoice APIs

What’s new

Adds an optional discountable parameter when creating add-on invoice items using add_invoice_items on the Subscriptions, Subscription Schedules and Preview Invoice APIs. The discountable parameter controls whether an invoice item is eligible for discounts. Discounts are only applied to discountable invoice items.

The discountable value is also returned as a new property in the phases.add_invoice_items array on the Subscription Schedule object.

Impact

With the new discountable parameter, you can explicitly set whether each add-on invoice item is eligible for discounts. This feature gives you more precise control over how discounts interact with one-time charges and credits on your subscriptions. If you don’t provide a value, invoice items default to being discountable. This change doesn’t modify the behaviour of existing integrations, and you must explicitly state in the request when an add-on invoice item must be non-discountable.

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: 2026-05-27. dahlia

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 .

Learn more about Stripe API upgrades.

Related changes

• Adds amount paid off Stripe property to Invoice object
• Adds billing schedules to enable prebilling on subscriptions
• Adds discount and discounts properties to pending subscription updates
• Adds metadata support to pending subscription updates
• Adds credited items information to invoice item proration details
• Adds customer parameter to test clock creation