# Adds risk verification details for connected accounts ## What’s new Upgrading to this version helps you better understand the causes of supportability verification issues for your connected accounts. You can see the verification error in the [requirements.errors.code](https://docs.stripe.com/api/accounts/object.md?api-version=2024-09-30.acacia#account_object-requirements-errors-code) enum. The new error includes text that describes the requirement for the following risk requirements: - `supportability_rejection_appeal` - `business_model_verification` - `restricted_or_prohibited_industry_diligence` - `other_supportability_inquiry` For example, if a verification fails because your connected account is selling alcohol, this message is shown in the `reason` field: “We can’t accept payments for age-restricted goods such as alcohol under the Stripe Services Agreement, as mentioned in [the prohibited and restricted businesses list](https://stripe.com/legal/restricted-businesses).” ```javascript { "id": "{{CONNECTED_ACCOUNT_ID}}", // ... "requirements": { "disabled_reason": "other", "past_due": ["interv_abc123.restricted_or_prohibited_industry_diligence.form"], "pending_verification": [], "errors": [ {"code": "verification_supportability", "reason": "We can't accept payments for age-resticted goods such as alcohol under the Stripe Services Agreement, as mentioned in the restricted businesses list.", "requirement": "interv_abc123.restricted_or_prohibited_industry_diligence.form" } ], "alternatives": [] // ... } } ``` Learn more about [handling risk verifications](https://docs.stripe.com/connect/handling-api-verification.md#handle-risk-verifications). ## Why is this a breaking change? This is a breaking change because it adds the new `verification_supportability` value to the requirements [error code enumeration](https://docs.stripe.com/api/accounts/object.md?api-version=2024-09-30.acacia#account_object-requirements-errors-code). ## Impact You can use the details to send notifications to connected accounts and guide them to a form where they can address the requirements. ## Changes #### REST API | Value | Change | Enums | | ----------------------------- | ------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | `verification_supportability` | Added | [Account.future_requirements.errors[].code](/api/accounts/object?api-version=2024-09-30.acacia#account_object-future_requirements-errors-code), [Account.requirements.errors[].code](/api/accounts/object?api-version=2024-09-30.acacia#account_object-requirements-errors-code), [BankAccount.future_requirements.errors[].code](/api/external_account_bank_accounts/object?api-version=2024-09-30.acacia#account_bank_account_object-future_requirements-errors-code), [BankAccount.requirements.errors[].code](/api/external_account_bank_accounts/object?api-version=2024-09-30.acacia#account_bank_account_object-requirements) | #### Ruby This change does not affect the Ruby SDK. #### Python | Value | Change | Enums | | ----------------------------- | ------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `verification_supportability` | Added | [stripe.Account.FutureRequirements.Error.code](/api/accounts/object?api-version=2024-09-30.acacia#account_object-future_requirements-errors-code), [stripe.Account.Requirements.Error.code](/api/accounts/object?api-version=2024-09-30.acacia#account_object-requirements-errors-code), [stripe.BankAccount.FutureRequirements.Error.code](/api/external_account_bank_accounts/object?api-version=2024-09-30.acacia#account_bank_account_object-future_requirements-errors-code), [stripe.BankAccount.Requirements.Error.code](/api/external_account_bank_accounts/object?api-version=2024-09-30.acacia#account_bank_account_object-requirements), [stripe.Capability.FutureRequirements.Error.code](/api/capabilities/object?api-version=2024-09-30.acacia#capability_object-future_requirements-errors-code), [stripe.Capability.Requirements.Error.code](/api/capabilities/object?api-version=2024-09-30.acacia#capability_object-requirements-errors-code), [stripe.Person.FutureRequirements.Error.code](/api/persons/object?api-version=2024-09-30.acacia#person_object-future_requirements-errors-code), [stripe.Person.Requirements.Error.code](/api/persons/object?api-version=2024-09-30.acacia#person_object-requirements-errors-code) | #### PHP This change does not affect the PHP SDK. #### Java This change does not affect the Java SDK. #### Node.js | Value | Change | Enums | | ----------------------------- | ------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | `verification_supportability` | Added | [Account.future_requirements.errors[].code](/api/accounts/object?api-version=2024-09-30.acacia#account_object-future_requirements-errors-code), [Account.requirements.errors[].code](/api/accounts/object?api-version=2024-09-30.acacia#account_object-requirements-errors-code), [BankAccount.future_requirements.errors[].code](/api/external_account_bank_accounts/object?api-version=2024-09-30.acacia#account_bank_account_object-future_requirements-errors-code), [BankAccount.requirements.errors[].code](/api/external_account_bank_accounts/object?api-version=2024-09-30.acacia#account_bank_account_object-requirements) | #### Go | Value | Change | Enums | | ----------------------------- | ------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `verification_supportability` | Added | [AccountFutureRequirementsErrorsCode](/api/accounts/object?api-version=2024-09-30.acacia#account_object-future_requirements-errors-code), [AccountRequirementsErrorsCode](/api/accounts/object?api-version=2024-09-30.acacia#account_object-requirements-errors-code), [BankAccountFutureRequirementsErrorsCode](/api/external_account_bank_accounts/object?api-version=2024-09-30.acacia#account_bank_account_object-future_requirements-errors-code), [BankAccountRequirementsErrorsCode](/api/external_account_bank_accounts/object?api-version=2024-09-30.acacia#account_bank_account_object-requirements) | #### .NET This change does not affect the .NET SDK. ## Upgrade #### REST API 1. [View your current API version](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench) in Workbench. 1. 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](https://docs.stripe.com/api/versioning.md) to include `Stripe-Version: 2024-09-30.acacia` 1. Upgrade the API version used for [webhook endpoints](https://docs.stripe.com/webhooks/versioning.md). 1. [Test your integration](https://docs.stripe.com/testing.md) against the new version. 1. If you use Connect, [test your Connect integration](https://docs.stripe.com/connect/testing.md). 1. In Workbench, [perform the upgrade](https://docs.stripe.com/upgrades.md#perform-the-upgrade). You can [roll back the version](https://docs.stripe.com/upgrades.md#roll-back-your-api-version) for 72 hours. Learn more about [Stripe API upgrades](https://docs.stripe.com/upgrades.md). #### Ruby 1. [View your current API version](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench) in Workbench. 1. Upgrade your Ruby SDK to [v13.0.0](https://github.com/stripe/stripe-ruby/releases/tag/v13.0.0) 1. Upgrade the API version used for [webhook endpoints](https://docs.stripe.com/webhooks/versioning.md). 1. [Test your integration](https://docs.stripe.com/testing.md) against the new version. 1. If you use Connect, [test your Connect integration](https://docs.stripe.com/connect/testing.md). 1. In Workbench, [perform the upgrade](https://docs.stripe.com/upgrades.md#perform-the-upgrade). You can [roll back the version](https://docs.stripe.com/upgrades.md#roll-back-your-api-version) for 72 hours. Learn more about [Stripe API upgrades](https://docs.stripe.com/upgrades.md). #### Python 1. [View your current API version](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench) in Workbench. 1. Upgrade your Python SDK to [v11.0.0](https://github.com/stripe/stripe-python/releases/tag/v11.0.0) 1. Upgrade the API version used for [webhook endpoints](https://docs.stripe.com/webhooks/versioning.md). 1. [Test your integration](https://docs.stripe.com/testing.md) against the new version. 1. If you use Connect, [test your Connect integration](https://docs.stripe.com/connect/testing.md). 1. In Workbench, [perform the upgrade](https://docs.stripe.com/upgrades.md#perform-the-upgrade). You can [roll back the version](https://docs.stripe.com/upgrades.md#roll-back-your-api-version) for 72 hours. Learn more about [Stripe API upgrades](https://docs.stripe.com/upgrades.md). #### PHP 1. [View your current API version](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench) in Workbench. 1. Upgrade your PHP SDK to [v16.0.0](https://github.com/stripe/stripe-php/releases/tag/v16.0.0) 1. Upgrade the API version used for [webhook endpoints](https://docs.stripe.com/webhooks/versioning.md). 1. [Test your integration](https://docs.stripe.com/testing.md) against the new version. 1. If you use Connect, [test your Connect integration](https://docs.stripe.com/connect/testing.md). 1. In Workbench, [perform the upgrade](https://docs.stripe.com/upgrades.md#perform-the-upgrade). You can [roll back the version](https://docs.stripe.com/upgrades.md#roll-back-your-api-version) for 72 hours. Learn more about [Stripe API upgrades](https://docs.stripe.com/upgrades.md). #### Java 1. [View your current API version](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench) in Workbench. 1. Upgrade your Java SDK to [v27.0.0](https://github.com/stripe/stripe-java/releases/tag/v27.0.0) 1. Upgrade the API version used for [webhook endpoints](https://docs.stripe.com/webhooks/versioning.md). 1. [Test your integration](https://docs.stripe.com/testing.md) against the new version. 1. If you use Connect, [test your Connect integration](https://docs.stripe.com/connect/testing.md). 1. In Workbench, [perform the upgrade](https://docs.stripe.com/upgrades.md#perform-the-upgrade). You can [roll back the version](https://docs.stripe.com/upgrades.md#roll-back-your-api-version) for 72 hours. Learn more about [Stripe API upgrades](https://docs.stripe.com/upgrades.md). #### Node.js 1. [View your current API version](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench) in Workbench. 1. Upgrade your Node SDK to [v17.0.0](https://github.com/stripe/stripe-node/releases/tag/v17.0.0) 1. Upgrade the API version used for [webhook endpoints](https://docs.stripe.com/webhooks/versioning.md). 1. [Test your integration](https://docs.stripe.com/testing.md) against the new version. 1. If you use Connect, [test your Connect integration](https://docs.stripe.com/connect/testing.md). 1. In Workbench, [perform the upgrade](https://docs.stripe.com/upgrades.md#perform-the-upgrade). You can [roll back the version](https://docs.stripe.com/upgrades.md#roll-back-your-api-version) for 72 hours. Learn more about [Stripe API upgrades](https://docs.stripe.com/upgrades.md). #### Go 1. [View your current API version](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench) in Workbench. 1. Upgrade your Go SDK to [v80.0.0](https://github.com/stripe/stripe-go/releases/tag/v80.0.0) 1. Upgrade the API version used for [webhook endpoints](https://docs.stripe.com/webhooks/versioning.md). 1. [Test your integration](https://docs.stripe.com/testing.md) against the new version. 1. If you use Connect, [test your Connect integration](https://docs.stripe.com/connect/testing.md). 1. In Workbench, [perform the upgrade](https://docs.stripe.com/upgrades.md#perform-the-upgrade). You can [roll back the version](https://docs.stripe.com/upgrades.md#roll-back-your-api-version) for 72 hours. Learn more about [Stripe API upgrades](https://docs.stripe.com/upgrades.md). #### .NET 1. [View your current API version](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench) in Workbench. 1. Upgrade your .NET SDK to [v46.0.0](https://github.com/stripe/stripe-dotnet/releases/tag/v46.0.0) 1. Upgrade the API version used for [webhook endpoints](https://docs.stripe.com/webhooks/versioning.md). 1. [Test your integration](https://docs.stripe.com/testing.md) against the new version. 1. If you use Connect, [test your Connect integration](https://docs.stripe.com/connect/testing.md). 1. In Workbench, [perform the upgrade](https://docs.stripe.com/upgrades.md#perform-the-upgrade). You can [roll back the version](https://docs.stripe.com/upgrades.md#roll-back-your-api-version) for 72 hours. Learn more about [Stripe API upgrades](https://docs.stripe.com/upgrades.md).