# Accounts now include the verification[disabled_reason] field to describe why they can't make transfers or charges ## What’s new Replaces the `verification[contacted]` boolean property on the `Account` object with a `verification[disabled_reason]` string that describes why the account is unable to make transfers or charges. ## Impact This change provides you with more detailed information about account verification status. ## Changes #### REST API | Parameter | Change | Resources or endpoints | | --- | --- | --- | | `contacted` | Removed | [Account.additional_verifications.address.requirements](/api/accounts/object?api-version=2024-06-20#account_object-additional_verifications-address-requirements), [Account.additional_verifications.document.requirements](/api/accounts/object?api-version=2024-06-20#account_object-additional_verifications-document-requirements), [Account.additional_verifications.person_identity.requirements](/api/accounts/object?api-version=2024-06-20#account_object-additional_verifications-person_identity-requirements), [Account.additional_verifications.tax_id.requirements](/api/accounts/object?api-version=2024-06-20#account_object-additional_verifications-tax_id-requirements), [Account.additional_verifications.tax_reporting.requirements](/api/accounts/object?api-version=2024-06-20#account_object-additional_verifications-tax_reporting-requirements), [Account.additional_verifications.us_w8_or_w9.requirements](/api/accounts/object?api-version=2024-06-20#account_object-additional_verifications-us_w8_or_w9-requirements), [Account.additional_verifications.vat_id.requirements](/api/accounts/object?api-version=2024-06-20#account_object-additional_verifications-vat_id-requirements), [Account.future_requirements](/api/accounts/object?api-version=2024-06-20#account_object-future_requirements), [Account.verification](/api/accounts/object?api-version=2024-06-20#account_object-verification) | #### Ruby | Parameter | Change | Resources or methods | | --- | --- | --- | | `contacted` | Removed | [Account::AdditionalVerification::Address::Requirement](/api/accounts/object?api-version=2024-06-20#account_object-additional_verifications-address-requirements), [Account::AdditionalVerification::Document::Requirement](/api/accounts/object?api-version=2024-06-20#account_object-additional_verifications-document-requirements), [Account::AdditionalVerification::PersonIdentity::Requirement](/api/accounts/object?api-version=2024-06-20#account_object-additional_verifications-person_identity-requirements), [Account::AdditionalVerification::TaxId::Requirement](/api/accounts/object?api-version=2024-06-20#account_object-additional_verifications-tax_id-requirements), [Account::AdditionalVerification::TaxReporting::Requirement](/api/accounts/object?api-version=2024-06-20#account_object-additional_verifications-tax_reporting-requirements), [Account::AdditionalVerification::UsW8OrW9::Requirement](/api/accounts/object?api-version=2024-06-20#account_object-additional_verifications-us_w8_or_w9-requirements), [Account::AdditionalVerification::VatId::Requirement](/api/accounts/object?api-version=2024-06-20#account_object-additional_verifications-vat_id-requirements), [Account::FutureRequirement](/api/accounts/object?api-version=2024-06-20#account_object-future_requirements), [Account::Verification](/api/accounts/object?api-version=2024-06-20#account_object-verification) | #### Python | Parameter | Change | Resources or methods | | --- | --- | --- | | `contacted` | Removed | [Account.AdditionalVerification.Address.Requirement](/api/accounts/object?api-version=2024-06-20#account_object-additional_verifications-address-requirements), [Account.AdditionalVerification.Document.Requirement](/api/accounts/object?api-version=2024-06-20#account_object-additional_verifications-document-requirements), [Account.AdditionalVerification.PersonIdentity.Requirement](/api/accounts/object?api-version=2024-06-20#account_object-additional_verifications-person_identity-requirements), [Account.AdditionalVerification.TaxId.Requirement](/api/accounts/object?api-version=2024-06-20#account_object-additional_verifications-tax_id-requirements), [Account.AdditionalVerification.TaxReporting.Requirement](/api/accounts/object?api-version=2024-06-20#account_object-additional_verifications-tax_reporting-requirements), [Account.AdditionalVerification.UsW8OrW9.Requirement](/api/accounts/object?api-version=2024-06-20#account_object-additional_verifications-us_w8_or_w9-requirements), [Account.AdditionalVerification.VatId.Requirement](/api/accounts/object?api-version=2024-06-20#account_object-additional_verifications-vat_id-requirements), [Account.FutureRequirement](/api/accounts/object?api-version=2024-06-20#account_object-future_requirements), [Account.Verification](/api/accounts/object?api-version=2024-06-20#account_object-verification) | #### PHP | Parameter | Change | Resources or methods | | --- | --- | --- | | `contacted` | Removed | [Account.additional_verifications.address.requirements](/api/accounts/object?api-version=2024-06-20#account_object-additional_verifications-address-requirements), [Account.additional_verifications.document.requirements](/api/accounts/object?api-version=2024-06-20#account_object-additional_verifications-document-requirements), [Account.additional_verifications.person_identity.requirements](/api/accounts/object?api-version=2024-06-20#account_object-additional_verifications-person_identity-requirements), [Account.additional_verifications.tax_id.requirements](/api/accounts/object?api-version=2024-06-20#account_object-additional_verifications-tax_id-requirements), [Account.additional_verifications.tax_reporting.requirements](/api/accounts/object?api-version=2024-06-20#account_object-additional_verifications-tax_reporting-requirements), [Account.additional_verifications.us_w8_or_w9.requirements](/api/accounts/object?api-version=2024-06-20#account_object-additional_verifications-us_w8_or_w9-requirements), [Account.additional_verifications.vat_id.requirements](/api/accounts/object?api-version=2024-06-20#account_object-additional_verifications-vat_id-requirements), [Account.future_requirements](/api/accounts/object?api-version=2024-06-20#account_object-future_requirements), [Account.verification](/api/accounts/object?api-version=2024-06-20#account_object-verification) | #### Java | Parameter | Change | Resources or methods | | --- | --- | --- | | `contacted` | Removed | [Account.additional_verifications.address.requirements](/api/accounts/object?api-version=2024-06-20#account_object-additional_verifications-address-requirements), [Account.additional_verifications.document.requirements](/api/accounts/object?api-version=2024-06-20#account_object-additional_verifications-document-requirements), [Account.additional_verifications.person_identity.requirements](/api/accounts/object?api-version=2024-06-20#account_object-additional_verifications-person_identity-requirements), [Account.additional_verifications.tax_id.requirements](/api/accounts/object?api-version=2024-06-20#account_object-additional_verifications-tax_id-requirements), [Account.additional_verifications.tax_reporting.requirements](/api/accounts/object?api-version=2024-06-20#account_object-additional_verifications-tax_reporting-requirements), [Account.additional_verifications.us_w8_or_w9.requirements](/api/accounts/object?api-version=2024-06-20#account_object-additional_verifications-us_w8_or_w9-requirements), [Account.additional_verifications.vat_id.requirements](/api/accounts/object?api-version=2024-06-20#account_object-additional_verifications-vat_id-requirements), [Account.future_requirements](/api/accounts/object?api-version=2024-06-20#account_object-future_requirements), [Account.verification](/api/accounts/object?api-version=2024-06-20#account_object-verification) | #### Node.js | Parameter | Change | Resources or methods | | --- | --- | --- | | `contacted` | Removed | [Account.additional_verifications.address.requirements](/api/accounts/object?api-version=2024-06-20#account_object-additional_verifications-address-requirements), [Account.additional_verifications.document.requirements](/api/accounts/object?api-version=2024-06-20#account_object-additional_verifications-document-requirements), [Account.additional_verifications.person_identity.requirements](/api/accounts/object?api-version=2024-06-20#account_object-additional_verifications-person_identity-requirements), [Account.additional_verifications.tax_id.requirements](/api/accounts/object?api-version=2024-06-20#account_object-additional_verifications-tax_id-requirements), [Account.additional_verifications.tax_reporting.requirements](/api/accounts/object?api-version=2024-06-20#account_object-additional_verifications-tax_reporting-requirements), [Account.additional_verifications.us_w8_or_w9.requirements](/api/accounts/object?api-version=2024-06-20#account_object-additional_verifications-us_w8_or_w9-requirements), [Account.additional_verifications.vat_id.requirements](/api/accounts/object?api-version=2024-06-20#account_object-additional_verifications-vat_id-requirements), [Account.future_requirements](/api/accounts/object?api-version=2024-06-20#account_object-future_requirements), [Account.verification](/api/accounts/object?api-version=2024-06-20#account_object-verification) | #### Go | Parameter | Change | Resources or methods | | --- | --- | --- | | `Contacted` | Removed | [AccountAdditionalVerificationsAddressRequirements](/api/accounts/object?api-version=2024-06-20#account_object-additional_verifications-address-requirements), [AccountAdditionalVerificationsDocumentRequirements](/api/accounts/object?api-version=2024-06-20#account_object-additional_verifications-document-requirements), [AccountAdditionalVerificationsPersonIdentityRequirements](/api/accounts/object?api-version=2024-06-20#account_object-additional_verifications-person_identity-requirements), [AccountAdditionalVerificationsTaxIdRequirements](/api/accounts/object?api-version=2024-06-20#account_object-additional_verifications-tax_id-requirements), [AccountAdditionalVerificationsTaxReportingRequirements](/api/accounts/object?api-version=2024-06-20#account_object-additional_verifications-tax_reporting-requirements), [AccountAdditionalVerificationsUsW8OrW9Requirements](/api/accounts/object?api-version=2024-06-20#account_object-additional_verifications-us_w8_or_w9-requirements), [AccountAdditionalVerificationsVatIdRequirements](/api/accounts/object?api-version=2024-06-20#account_object-additional_verifications-vat_id-requirements), [AccountFutureRequirements](/api/accounts/object?api-version=2024-06-20#account_object-future_requirements), [AccountVerification](/api/accounts/object?api-version=2024-06-20#account_object-verification) | #### .NET | Parameter | Change | Resources or methods | | --- | --- | --- | | `Contacted` | Removed | [Account.AdditionalVerifications.Address.Requirements](/api/accounts/object?api-version=2024-06-20#account_object-additional_verifications-address-requirements), [Account.AdditionalVerifications.Document.Requirements](/api/accounts/object?api-version=2024-06-20#account_object-additional_verifications-document-requirements), [Account.AdditionalVerifications.PersonIdentity.Requirements](/api/accounts/object?api-version=2024-06-20#account_object-additional_verifications-person_identity-requirements), [Account.AdditionalVerifications.TaxId.Requirements](/api/accounts/object?api-version=2024-06-20#account_object-additional_verifications-tax_id-requirements), [Account.AdditionalVerifications.TaxReporting.Requirements](/api/accounts/object?api-version=2024-06-20#account_object-additional_verifications-tax_reporting-requirements), [Account.AdditionalVerifications.UsW8OrW9.Requirements](/api/accounts/object?api-version=2024-06-20#account_object-additional_verifications-us_w8_or_w9-requirements), [Account.AdditionalVerifications.VatId.Requirements](/api/accounts/object?api-version=2024-06-20#account_object-additional_verifications-vat_id-requirements), [Account.FutureRequirements](/api/accounts/object?api-version=2024-06-20#account_object-future_requirements), [Account.Verification](/api/accounts/object?api-version=2024-06-20#account_object-verification) | ## 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. 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/versioning.md) to include `Stripe-Version: 2015-07-13` 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). #### 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).