Adds a webhook event type for updates to the balance settings for connected accounts
What’s new
Adds a balance_settings.updated webhook event type. Stripe sends this event when the Balance Settings for a connected account changes.
Impact
You can now retrieve or listen to balance_settings.updated events. Balance Settings specify options for customizing account balances and payouts of a connected account.
Changes
| Values | Change | Enums |
|---|---|---|
| balance_settings. updated | Added | Event |
| balance_settings. updated | Added | WebhookEndpoint#update WebhookEndpoint#create |
| Change | Event type | |
| balance_settings. updated | Added | BalanceSettings |
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-10-29. 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.