Adds payment behaviour control for subscription item deletion
What’s new
You can specify the payment_behavior parameter when you delete a subscription item. Setting payment_behavior=pending_if_incomplete stages the deletion as a pending update when the change would generate an invoice that requires payment, rather than deleting the item immediately.
Impact
This new approach maintains consistency in your subscription management workflow and prevents items from being removed before payment is confirmed. Further, this change aligns subscription item deletion with the existing pending update behaviour available when adding and modifying subscription items. Previously, you could only delete subscription items immediately, which could create inconsistencies in how subscription changes are handled across different operations.
Changes
| Parameter | Change | Resources or endpoints |
|---|---|---|
| payment_behavior | Added | SubscriptionItem#delete |
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-02-25. clover
- 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.