Adds the ability to monitor reserve activity on Balance Transactions and reconcile Risk Reserved balance changes
What’s new
Adds two new Balance Transaction type values for tracking reserve activity:
- reserve _ hold : Records when funds are held in reserve
- reserve _ release : Records when reserved funds are released back to your available balance
Adds a new risk_reserved value to the balance_type property to indicate which transactions impact your Risk Reserved balance.
Impact
You can now monitor reserve activity by filtering Balance Transactions for the reserve_hold and reserve_release types. Use the risk_reserved balance type to reconcile Risk Reserved balance changes.
Changes
| Values | Change | Enums |
|---|---|---|
| risk_reserved | Added | BalanceTransaction |
| reserve_hold reserve_release | Added | BalanceTransaction |
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-01-28. 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.