# Adds alternative requirements to the Accounts v2 API ## What’s new Adds an [alternatives](https://docs.stripe.com/api/v2/core/accounts/object.md?api-version=2026-10-28.endive#v2_account_object-requirements-alternatives) array to the [requirements](https://docs.stripe.com/api/v2/core/accounts/object.md?api-version=2026-10-28.endive#v2_account_object-requirements) and [future_requirements](https://docs.stripe.com/api/v2/core/accounts/object.md?api-version=2026-10-28.endive#v2_account_object-future_requirements) properties on the [Account](https://docs.stripe.com/api/v2/core/accounts/object.md?api-version=2026-10-28.endive) object returned by the Accounts v2 API. Each item in [alternatives](https://docs.stripe.com/api/v2/core/accounts/object.md?api-version=2026-10-28.endive#v2_account_object-requirements-alternatives) contains an [options](https://docs.stripe.com/api/v2/core/accounts/object.md?api-version=2026-10-28.endive#v2_account_object-requirements-alternatives-options) array that lists alternative ways to satisfy the requirements in [original_entries](https://docs.stripe.com/api/v2/core/accounts/object.md?api-version=2026-10-28.endive#v2_account_object-requirements-alternatives-original_entries). Complete any one option by providing every entry it requires. For example, the following alternative provides two options for satisfying one original requirement. Other properties are omitted. ```json { "requirements": { "entries": [ { "description": "original_requirement", ...} ], "alternatives": [ { "original_entries": [ { "description": "original_requirement", ... } ], "options": [ { "entries": [ { "description": "requirement_a", ... }, { "description": "requirement_b", ... } ] }, { "entries": [ { "description": "requirement_c", ... }, { "description": "requirement_d", ... } ] } ] } ] } } ``` To satisfy `original_requirement`, provide both `requirement_a` and `requirement_b`, or both `requirement_c` and `requirement_d`. Completing only `requirement_a` and `requirement_c` doesn’t satisfy either option. Each option lists every entry required for that alternative verification path, including entries it shares with [original_entries](https://docs.stripe.com/api/v2/core/accounts/object.md?api-version=2026-10-28.endive#v2_account_object-requirements-alternatives-original_entries). You only need to provide a shared entry once. The original requirement and its capability restrictions remain in [requirements.entries](https://docs.stripe.com/api/v2/core/accounts/object.md?api-version=2026-10-28.endive#v2_account_object-requirements-entries) until you provide it to Stripe or complete an available alternative. ## Impact You can offer account holders alternative ways to satisfy onboarding requirements through the Accounts v2 API. Use [requirements.alternatives](https://docs.stripe.com/api/v2/core/accounts/object.md?api-version=2026-10-28.endive#v2_account_object-requirements-alternatives) and [future_requirements.alternatives](https://docs.stripe.com/api/v2/core/accounts/object.md?api-version=2026-10-28.endive#v2_account_object-future_requirements-alternatives) to identify the available options for each v2 Account. ## Changes #### REST API | Parameter | Change | Resources or endpoints | | --- | --- | --- | | `alternatives` | Added | [V2.Core.Account.future_requirements](/api/v2/core/accounts/object?api-version=2026-10-28.endive#v2_account_object-future_requirements), [V2.Core.Account.requirements](/api/v2/core/accounts/object?api-version=2026-10-28.endive#v2_account_object-requirements) | #### Ruby | Parameter | Change | Resources or methods | | --- | --- | --- | | `alternatives` | Added | [V2::Core::Account::FutureRequirement](/api/v2/core/accounts/object?api-version=2026-10-28.endive#v2_account_object-future_requirements), [V2::Core::Account::Requirement](/api/v2/core/accounts/object?api-version=2026-10-28.endive#v2_account_object-requirements) | #### Python | Parameter | Change | Resources or methods | | --- | --- | --- | | `alternatives` | Added | [V2.Core.Account.FutureRequirement](/api/v2/core/accounts/object?api-version=2026-10-28.endive#v2_account_object-future_requirements), [V2.Core.Account.Requirement](/api/v2/core/accounts/object?api-version=2026-10-28.endive#v2_account_object-requirements) | #### PHP | Parameter | Change | Resources or methods | | --- | --- | --- | | `alternatives` | Added | [V2.Core.Account.future_requirements](/api/v2/core/accounts/object?api-version=2026-10-28.endive#v2_account_object-future_requirements), [V2.Core.Account.requirements](/api/v2/core/accounts/object?api-version=2026-10-28.endive#v2_account_object-requirements) | #### Java | Parameter | Change | Resources or methods | | --- | --- | --- | | `alternatives` | Added | [v2.core.Account.future_requirements](/api/v2/core/accounts/object?api-version=2026-10-28.endive#v2_account_object-future_requirements), [v2.core.Account.requirements](/api/v2/core/accounts/object?api-version=2026-10-28.endive#v2_account_object-requirements) | #### Node.js | Parameter | Change | Resources or methods | | --- | --- | --- | | `alternatives` | Added | [V2.Core.Account.future_requirements](/api/v2/core/accounts/object?api-version=2026-10-28.endive#v2_account_object-future_requirements), [V2.Core.Account.requirements](/api/v2/core/accounts/object?api-version=2026-10-28.endive#v2_account_object-requirements) | #### Go | Parameter | Change | Resources or methods | | --- | --- | --- | | `Alternatives` | Added | [V2CoreAccountFutureRequirements](/api/v2/core/accounts/object?api-version=2026-10-28.endive#v2_account_object-future_requirements), [V2CoreAccountRequirements](/api/v2/core/accounts/object?api-version=2026-10-28.endive#v2_account_object-requirements) | #### .NET | Parameter | Change | Resources or methods | | --- | --- | --- | | `Alternatives` | Added | [V2.Core.Account.FutureRequirements](/api/v2/core/accounts/object?api-version=2026-10-28.endive#v2_account_object-future_requirements), [V2.Core.Account.Requirements](/api/v2/core/accounts/object?api-version=2026-10-28.endive#v2_account_object-requirements) | ## Upgrade #### REST API 1. [View your current API version](https://docs.stripe.com/workbench/guides.md#view-api-versions) in Workbench. 2. 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-versions.md#how-versions-are-specified-in-requests) to include `Stripe-Version: 2026-10-28.endive` 3. Upgrade the API version used for [webhook endpoints](https://docs.stripe.com/webhooks/versioning.md). 4. [Test your integration](https://docs.stripe.com/testing.md) against the new version. 5. If you use Connect, [test your Connect integration](https://docs.stripe.com/connect/testing.md). 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. 2. Upgrade your Ruby SDK to the latest version. 3. Upgrade the API version used for [webhook endpoints](https://docs.stripe.com/webhooks/versioning.md). 4. [Test your integration](https://docs.stripe.com/testing.md) against the new version. 5. If you use Connect, [test your Connect integration](https://docs.stripe.com/connect/testing.md). 6. 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. 2. Upgrade your Python SDK to the latest version. 3. Upgrade the API version used for [webhook endpoints](https://docs.stripe.com/webhooks/versioning.md). 4. [Test your integration](https://docs.stripe.com/testing.md) against the new version. 5. If you use Connect, [test your Connect integration](https://docs.stripe.com/connect/testing.md). 6. 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. 2. Upgrade your PHP SDK to the latest version. 3. Upgrade the API version used for [webhook endpoints](https://docs.stripe.com/webhooks/versioning.md). 4. [Test your integration](https://docs.stripe.com/testing.md) against the new version. 5. If you use Connect, [test your Connect integration](https://docs.stripe.com/connect/testing.md). 6. 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. 2. Upgrade your Java SDK to the latest version. 3. Upgrade the API version used for [webhook endpoints](https://docs.stripe.com/webhooks/versioning.md). 4. [Test your integration](https://docs.stripe.com/testing.md) against the new version. 5. If you use Connect, [test your Connect integration](https://docs.stripe.com/connect/testing.md). 6. 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. 2. Upgrade your Node SDK to the latest version. 3. Upgrade the API version used for [webhook endpoints](https://docs.stripe.com/webhooks/versioning.md). 4. [Test your integration](https://docs.stripe.com/testing.md) against the new version. 5. If you use Connect, [test your Connect integration](https://docs.stripe.com/connect/testing.md). 6. 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. 2. Upgrade your Go SDK to the latest version. 3. Upgrade the API version used for [webhook endpoints](https://docs.stripe.com/webhooks/versioning.md). 4. [Test your integration](https://docs.stripe.com/testing.md) against the new version. 5. If you use Connect, [test your Connect integration](https://docs.stripe.com/connect/testing.md). 6. 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. 2. Upgrade your .NET SDK to the latest version. 3. Upgrade the API version used for [webhook endpoints](https://docs.stripe.com/webhooks/versioning.md). 4. [Test your integration](https://docs.stripe.com/testing.md) against the new version. 5. If you use Connect, [test your Connect integration](https://docs.stripe.com/connect/testing.md). 6. 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). ## Related changes - [Adds Connect embedded components for buying Terminal hardware](https://docs.stripe.com/changelog/endive/2026-10-28/connect-embedded-components-ordering-terminal-hardware.md) - [Adds the Reporting Chart embedded component](https://docs.stripe.com/changelog/endive/2026-10-28/reporting-chart-embedded-component.md)