- Breaking changes
- Public preview
Updates bank account and payout method resources for Global Payouts Breaking changes Public preview
What’s new
- Renames the enabled _ delivery _ options property to enabled_delivery_schemes on the bank_account hash of the v2 Payout Method object. The new name better reflects that the property represents delivery schemes rather than generic options.
- Adds the restricted property to US Bank Account and GB Bank Account vault resources. This boolean property indicates whether a user can use a correctly configured bank account for money movement. Without this field, users might infer blocked transactions as invalid configuration.
Why is this a breaking change?
Integrations that reference the enabled_delivery_options property of the v2 Payout Methods object’s bank_account hash won’t receive expected data and might receive errors if they don’t handle the renamed property in their integration.
Impact
If your integration reads the enabled_delivery_options property from v2 Payout Method Bank Account objects, you must update your code to use enabled_delivery_schemes instead.
You can also now inspect the restricted property on vault bank accounts to determine whether a bank account can receive payouts on Stripe. This new functionality isn’t breaking and requires no change if you choose not to use it.
Changes
| Parameters | Change | Resources or endpoints |
|---|---|---|
| restricted | Added | V2. Core. Vault. GbBankAccount V2. Core. Vault. UsBankAccount |
| enabled_delivery_schemes | Added | V2. MoneyManagement. PayoutMethod. bank_account |
| enabled_delivery_options | Removed | V2. MoneyManagement. PayoutMethod. bank_account |
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-08-26. 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.