Adds a new error code for business type validationsBreaking changes
What’s new
Adds an unsupported_ error code to the requirements.errors array in the Accounts API, Capabilities API, Persons API, and Bank Accounts API.
We return the unsupported_ error if the business type isn’t supported in the merchant’s country.
// GET /v1/accounts/{{CONNECTED_ACCOUNT_ID}} { ... "requirements": { "currently_due": ["business_type"], "errors": [ { "code": "unsupported_business_type", "requirement": "business_type", "reason": "Business type isn't supported in merchant country. 'individual' isn't a supported business type in country NL." } ], ... }, ... }
Why is this a breaking change?
Some Connect integrations might require an update to handle the new error codes.
Impact
If you provide a business type that isn’t supported for the merchant’s country, we return the unsupported_ error code. You need to update the business type to a valid value.
Create new accounts with the correct business type and company structure
When creating new accounts, make sure to provide a valid business type and company structure for the country. Doing so can prevent you from receiving any errors.
// Correct approach for new accounts curl -X POST https://api.stripe.com/v1/accounts \ -u sk_test_123: \ -d "country=NL" \ -d "type=custom" \ -d "business_type=company" \ -d "company[structure]=sole_proprietorship"
If you encounter the error on existing accounts, update the accounts to resolve the error.
// Update existing accounts curl -X POST https://api.stripe.com/v1/accounts/acct_123 \ -u sk_test_123: \ -d "business_type=company" \ -d "company[structure]=sole_proprietorship" \ // Successful response { "id": "acct_123", "business_type": "company", "company": { "structure": "sole_proprietorship", ... }, "requirements": { "currently_due": [], // business_type requirement resolved "errors": [] } ... }