Stripe adds real-time events for reserve holds, releases, and plans
New Event Types
Stripe now supports real-time notifications for reserve fund management through seven new event types:
- reserve.hold.created and reserve.hold.updated: Track when reserve holds are created or modified
- reserve.release.created: Fired when funds are released from reserve
- reserve.plan.created, reserve.plan.updated, reserve.plan.expired, and reserve.plan.disabled: Monitor the full lifecycle of reserve plans
What Developers Need to Do
To use these events, developers must upgrade to API version 2026-02-25.clover. This requires:
- Upgrading to the latest SDK version for your language (Ruby, Python, PHP, Java, Node.js, Go, or .NET)
- Updating webhook endpoint configurations to use the new API version
- Testing your integration against the new version before deploying to production
- If using Stripe Connect, testing Connect-specific integrations as well
Key Benefits
These new events enable automated workflows around reserve fund management, such as:
- Building dashboards that react to hold and release events
- Triggering notifications when reserve plans expire or are disabled
- Integrating reserve management with existing payment processing systems
- Monitoring compliance and reserve status changes in real time
Note that API version changes can be rolled back within 72 hours if needed, allowing for safe testing and validation.