Public preview
Adds per-currency minimum balances for automatic payouts on the Balance Settings API Public preview
What’s new
Balance Settings now include a minimum_balance_by_currency parameter under payments.payouts. This allows platforms to retain per-currency amounts (in the minor currency unit) on connected accounts during automatic payouts.
Impact
The minimum_balance_by_currency parameter allows platforms to programmatically retain a per-currency buffer on connected accounts during automatic payouts. This can help reduce the likelihood of negative balances resulting from refunds, disputes, or fees that occur after a payout. Learn more about the minimum balances for automatic payouts.
Changes
| Parameter | Change | Resources or endpoints |
|---|---|---|
| minimum_balance_by_currency | Added | BalanceSettings#update. payments. payouts BalanceSettings. payments. payouts |
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: 2025-09-30. preview
- 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.