Adds events for reserve holds, releases, and plans
What’s new
Adds support for receiving real-time notifications about changes to Reserve Holds, Reserve Releases, and Reserve Plans associated with reserved funds on accounts.
- reserve.hold.created : occurs when a ReserveHold is created.
- reserve.hold.updated : occurs when a ReserveHold is updated.
- reserve.release.created : occurs when a ReserveRelease is created.
- reserve.plan.created : occurs when a ReservePlan is created.
- reserve.plan.updated : occurs when a ReservePlan is updated.
- reserve.plan.expired : occurs when a ReservePlan expires.
- reserve.plan.disabled : occurs when a ReservePlan is disabled.
Impact
You can use these new events to programmatically monitor holds, releases, and plan configurations associated with reserved funds on accounts.
Changes
| Change | Resources | |
|---|---|---|
| Added | Reserve. Hold Reserve. Plan Reserve. Release | |
| Values | Change | Enums |
| reserve. hold. created reserve. hold. updated reserve. plan. created reserve. plan. disabled reserve. plan. expired reserve. plan. updated reserve. release. created | Added | Event WebhookEndpoint#update WebhookEndpoint#create |
| Change | Event types | |
| reserve. hold. created reserve. hold. updated | Added | Reserve.Hold |
| reserve. plan. created reserve. plan. disabled reserve. plan. expired reserve. plan. updated | Added | Reserve.Plan |
| reserve. release. created | Added | Reserve.Release |
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 .
- In Workbench, perform the upgrade . You can roll back the version for 72 hours.
Learn more about Stripe API upgrades.