Adds error types for unsupported countries or entities when requesting capabilities for Accounts v2Public preview
What’s new
When using Accounts v2, each time you update the account’s identity information, we now automatically recalculate country eligibility.
We’ve introduced two error types when requesting capabilities. Rather than returning a 400
validation error, you can now check whether status_
reports:
unsupported_
: the account’s country doesn’t support the capability.country unsupported_
: the account’s entity type doesn’t support the capability.entity_ type
Impact
You no longer need to manually withdraw and re-request an account’s capability if it’s marked as unsupported due to country or entity type. Additionally, you won’t encounter a 400
error when requesting a capability that’s not eligible for a specific country or entity type.
Changes
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-06-30.
preview
- If you don’t use an SDK, update your API requests to include
- 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.