New Property: risk_reserved Balance Tracking

Stripe has extended the Balance object with a new risk_reserved hash property that provides visibility into funds being held in reserve. This addition helps merchants and developers better understand their financial position by distinguishing between regular available balances and amounts held for risk management purposes.

What You Can Now Track

The risk_reserved property includes:

• available: Funds held in reserve that are accessible
• pending: Funds held in reserve that are not yet accessible

This structured approach makes it easier to reconcile accounts and plan for cash flow when funds are temporarily reserved due to risk assessments or compliance requirements.

SDK and API Version Updates

The new property is available in API version 2026-03-25.preview. To access this feature:

• SDK users: Upgrade to the latest version of your language's Stripe SDK (Ruby, Python, PHP, Java, Node.js, Go, or .NET)
• REST API users: Include the header Stripe-Version: 2026-03-25.preview in your requests
• Webhook endpoints: Update webhook endpoints to use the new API version
• Connect integrations: Test your Connect setup against the new version

You can roll back the API version for 72 hours if needed. Use Stripe's Workbench to manage your API version upgrades and testing.