# Several account fields have been refactored to better describe legal entity, verification status and requirements, and configurable settings

## What’s new

Includes multiple changes:

- Replaces the `legal_entity` property on the Account API resource with `individual`, `company`, and `business_type`.
- Replaces the `verification` hash with a `requirements` hash.
- Replaces the `verification[fields_needed]` array with three arrays to better represent when information is required: `requirements[eventually_due]`, `requirements[currently_due]`, and `requirements[past_due]`.
- Renames `verification[due_by]` to `requirements[current_deadline]`.
- Renames the `disabled_reason` enum value of `fields_needed` to `requirements.past_due`.
- Moves properties on the `Account` object that configure behavior within Stripe into the new `settings` hash.
- Moves the `payout_schedule`, `payout_statement_descriptor` and `debit_negative_balances` fields to `settings[payouts]`, renaming them to `schedule`, `statement_descriptor` and `debit_negative_balances`.
- Moves the `statement_descriptor` field to `settings[payments][statement_descriptor]`.
- Moves `decline_charge_on` fields to `settings[card_payments]`, renaming it to `decline_on`.
- Moves the `business_logo`, `business_logo_large` and `business_primary_color` fields to `settings[branding]`, renaming them to `icon`, `logo` and `primary_color`. Additionally, the `icon` field requires the image file you upload to be a square.
- Moves the `display_name` and `timezone` fields to `settings[dashboard]`.

## Impact

This change significantly restructures the Account API resource, providing a more structured and detailed approach to account information and settings. You need to extensively update your code that interacts with the Account API.

## Changes

#### REST API

| Parameters | Change | Resources or endpoints |
| --- | --- | --- |
| `legal_entity` | Changed | [Account](/api/accounts/object?api-version=2024-06-20) |
| `verification[fields_needed]`, `verification[due_by]` | Changed | [Account](/api/accounts/object?api-version=2024-06-20) |
| `payout_schedule`, `payout_statement_descriptor`, `debit_negative_balances`, `statement_descriptor`, `decline_charge_on`, `business_logo`, `business_logo_large`, `business_primary_color`, `display_name`, `timezone` | Changed | [Account](/api/accounts/object?api-version=2024-06-20) |

#### Ruby

| Parameters | Change | Resources or methods |
| --- | --- | --- |
| `business_logo`, `business_logo_large`, `business_name`, `business_primary_color`, `business_url`, `debit_negative_balances`, `decline_charge_on`, `payout_schedule`, `payout_statement_descriptor`, `product_description`, `statement_descriptor`, `statement_descriptor_prefix_kana`, `statement_descriptor_prefix_kanji`, `support_email`, `support_phone`, `support_url` | Removed | [Account](/api/accounts/object?api-version=2024-06-20#account_object), [AccountCreateParams](/api/accounts/create?api-version=2024-06-20#create_account), [AccountUpdateParams](/api/accounts/update?api-version=2024-06-20#update_account) |
| `legal_entity` | Removed | [Account](/api/accounts/object?api-version=2024-06-20#account_object), [AccountCreateParams](/api/accounts/create?api-version=2024-06-20#create_account), [AccountUpdateParams](/api/accounts/update?api-version=2024-06-20#update_account), [TokenCreateParams::Account](/api/tokens/create_bank_account?api-version=2024-06-20#create_bank_account_token-account) |
| `statement_descriptor_prefix` | Removed | [AccountCreateParams](/api/accounts/create?api-version=2024-06-20#create_account), [AccountUpdateParams](/api/accounts/update?api-version=2024-06-20#update_account) |
| `business_profile`, `requirements`, `settings` | Added | [Account](/api/accounts/object?api-version=2024-06-20#account_object-business_profile-requirements-settings) |
| `business_type`, `company`, `individual` | Added | [Account](/api/accounts/object?api-version=2024-06-20#account_object-business_type-company-individual), [TokenCreateParams::Account](/api/tokens/create_bank_account?api-version=2024-06-20#create_bank_account_token-account-business_type-company-individual) |
| `display_name`, `keys`, `statement_descriptor_kana`, `statement_descriptor_kanji`, `support_address`, `timezone`, `verification` | Removed | [Account](/api/accounts/object?api-version=2024-06-20#account_object) |
| `current_deadline`, `currently_due`, `eventually_due`, `past_due`, `pending_verification` | Added | [Account::AdditionalVerification::Address::Requirement](/api/accounts/object?api-version=2024-06-20#account_object-additional_verifications-address-requirements-current_deadline-currently_due-eventually_due-past_due-pending_verification), [Account::AdditionalVerification::Document::Requirement](/api/accounts/object?api-version=2024-06-20#account_object-additional_verifications-document-requirements-current_deadline-currently_due-eventually_due-past_due-pending_verification), [Account::AdditionalVerification::PersonIdentity::Requirement](/api/accounts/object?api-version=2024-06-20#account_object-additional_verifications-person_identity-requirements-current_deadline-currently_due-eventually_due-past_due-pending_verification), [Account::AdditionalVerification::TaxId::Requirement](/api/accounts/object?api-version=2024-06-20#account_object-additional_verifications-tax_id-requirements-current_deadline-currently_due-eventually_due-past_due-pending_verification), [Account::AdditionalVerification::TaxReporting::Requirement](/api/accounts/object?api-version=2024-06-20#account_object-additional_verifications-tax_reporting-requirements-current_deadline-currently_due-eventually_due-past_due-pending_verification), [Account::AdditionalVerification::UsW8OrW9::Requirement](/api/accounts/object?api-version=2024-06-20#account_object-additional_verifications-us_w8_or_w9-requirements-current_deadline-currently_due-eventually_due-past_due-pending_verification), [Account::AdditionalVerification::VatId::Requirement](/api/accounts/object?api-version=2024-06-20#account_object-additional_verifications-vat_id-requirements-current_deadline-currently_due-eventually_due-past_due-pending_verification), [Account::FutureRequirement](/api/accounts/object?api-version=2024-06-20#account_object-future_requirements-current_deadline-currently_due-eventually_due-past_due-pending_verification) |
| `due_by`, `fields_needed` | 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) |

#### Python

| Parameters | Change | Resources or methods |
| --- | --- | --- |
| `business_logo`, `business_logo_large`, `business_name`, `business_primary_color`, `business_url`, `debit_negative_balances`, `decline_charge_on`, `payout_schedule`, `payout_statement_descriptor`, `product_description`, `statement_descriptor`, `statement_descriptor_prefix_kana`, `statement_descriptor_prefix_kanji`, `support_email`, `support_phone`, `support_url` | Removed | [Account](/api/accounts/object?api-version=2024-06-20#account_object), [AccountCreateParams](/api/accounts/create?api-version=2024-06-20#create_account), [AccountModifyParams](/api/accounts/update?api-version=2024-06-20#update_account) |
| `legal_entity` | Removed | [Account](/api/accounts/object?api-version=2024-06-20#account_object), [AccountCreateParams](/api/accounts/create?api-version=2024-06-20#create_account), [AccountModifyParams](/api/accounts/update?api-version=2024-06-20#update_account), [TokenCreateParamsAccount](/api/tokens/create_bank_account?api-version=2024-06-20#create_bank_account_token-account) |
| `statement_descriptor_prefix` | Removed | [AccountCreateParams](/api/accounts/create?api-version=2024-06-20#create_account), [AccountModifyParams](/api/accounts/update?api-version=2024-06-20#update_account) |
| `business_profile`, `requirements`, `settings` | Added | [Account](/api/accounts/object?api-version=2024-06-20#account_object-business_profile-requirements-settings) |
| `business_type`, `company`, `individual` | Added | [Account](/api/accounts/object?api-version=2024-06-20#account_object-business_type-company-individual), [TokenCreateParamsAccount](/api/tokens/create_bank_account?api-version=2024-06-20#create_bank_account_token-account-business_type-company-individual) |
| `display_name`, `keys`, `statement_descriptor_kana`, `statement_descriptor_kanji`, `support_address`, `timezone`, `verification` | Removed | [Account](/api/accounts/object?api-version=2024-06-20#account_object) |
| `current_deadline`, `currently_due`, `eventually_due`, `past_due`, `pending_verification` | Added | [Account.AdditionalVerification.Address.Requirement](/api/accounts/object?api-version=2024-06-20#account_object-additional_verifications-address-requirements-current_deadline-currently_due-eventually_due-past_due-pending_verification), [Account.AdditionalVerification.Document.Requirement](/api/accounts/object?api-version=2024-06-20#account_object-additional_verifications-document-requirements-current_deadline-currently_due-eventually_due-past_due-pending_verification), [Account.AdditionalVerification.PersonIdentity.Requirement](/api/accounts/object?api-version=2024-06-20#account_object-additional_verifications-person_identity-requirements-current_deadline-currently_due-eventually_due-past_due-pending_verification), [Account.AdditionalVerification.TaxId.Requirement](/api/accounts/object?api-version=2024-06-20#account_object-additional_verifications-tax_id-requirements-current_deadline-currently_due-eventually_due-past_due-pending_verification), [Account.AdditionalVerification.TaxReporting.Requirement](/api/accounts/object?api-version=2024-06-20#account_object-additional_verifications-tax_reporting-requirements-current_deadline-currently_due-eventually_due-past_due-pending_verification), [Account.AdditionalVerification.UsW8OrW9.Requirement](/api/accounts/object?api-version=2024-06-20#account_object-additional_verifications-us_w8_or_w9-requirements-current_deadline-currently_due-eventually_due-past_due-pending_verification), [Account.AdditionalVerification.VatId.Requirement](/api/accounts/object?api-version=2024-06-20#account_object-additional_verifications-vat_id-requirements-current_deadline-currently_due-eventually_due-past_due-pending_verification), [Account.FutureRequirement](/api/accounts/object?api-version=2024-06-20#account_object-future_requirements-current_deadline-currently_due-eventually_due-past_due-pending_verification) |
| `due_by`, `fields_needed` | 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) |

#### PHP

| Parameters | Change | Resources or methods |
| --- | --- | --- |
| `business_logo`, `business_logo_large`, `business_name`, `business_primary_color`, `business_url`, `debit_negative_balances`, `decline_charge_on`, `payout_schedule`, `payout_statement_descriptor`, `product_description`, `statement_descriptor`, `statement_descriptor_prefix_kana`, `statement_descriptor_prefix_kanji`, `support_email`, `support_phone`, `support_url` | Removed | [Account](/api/accounts/object?api-version=2024-06-20#account_object), [Account.create().$params](/api/accounts/create?api-version=2024-06-20#create_account), [Account.update().$params](/api/accounts/update?api-version=2024-06-20#update_account) |
| `legal_entity` | Removed | [Account](/api/accounts/object?api-version=2024-06-20#account_object), [Account.create().$params](/api/accounts/create?api-version=2024-06-20#create_account), [Account.update().$params](/api/accounts/update?api-version=2024-06-20#update_account), [Token.create().$params.account](/api/tokens/create_bank_account?api-version=2024-06-20#create_bank_account_token-account) |
| `statement_descriptor_prefix` | Removed | [Account.create().$params](/api/accounts/create?api-version=2024-06-20#create_account), [Account.update().$params](/api/accounts/update?api-version=2024-06-20#update_account) |
| `business_profile`, `requirements`, `settings` | Added | [Account](/api/accounts/object?api-version=2024-06-20#account_object-business_profile-requirements-settings) |
| `business_type`, `company`, `individual` | Added | [Account](/api/accounts/object?api-version=2024-06-20#account_object-business_type-company-individual), [Token.create().$params.account](/api/tokens/create_bank_account?api-version=2024-06-20#create_bank_account_token-account-business_type-company-individual) |
| `display_name`, `keys`, `statement_descriptor_kana`, `statement_descriptor_kanji`, `support_address`, `timezone`, `verification` | Removed | [Account](/api/accounts/object?api-version=2024-06-20#account_object) |
| `current_deadline`, `currently_due`, `eventually_due`, `past_due`, `pending_verification` | Added | [Account.additional_verifications.address.requirements](/api/accounts/object?api-version=2024-06-20#account_object-additional_verifications-address-requirements-current_deadline-currently_due-eventually_due-past_due-pending_verification), [Account.additional_verifications.document.requirements](/api/accounts/object?api-version=2024-06-20#account_object-additional_verifications-document-requirements-current_deadline-currently_due-eventually_due-past_due-pending_verification), [Account.additional_verifications.person_identity.requirements](/api/accounts/object?api-version=2024-06-20#account_object-additional_verifications-person_identity-requirements-current_deadline-currently_due-eventually_due-past_due-pending_verification), [Account.additional_verifications.tax_id.requirements](/api/accounts/object?api-version=2024-06-20#account_object-additional_verifications-tax_id-requirements-current_deadline-currently_due-eventually_due-past_due-pending_verification), [Account.additional_verifications.tax_reporting.requirements](/api/accounts/object?api-version=2024-06-20#account_object-additional_verifications-tax_reporting-requirements-current_deadline-currently_due-eventually_due-past_due-pending_verification), [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-current_deadline-currently_due-eventually_due-past_due-pending_verification), [Account.additional_verifications.vat_id.requirements](/api/accounts/object?api-version=2024-06-20#account_object-additional_verifications-vat_id-requirements-current_deadline-currently_due-eventually_due-past_due-pending_verification), [Account.future_requirements](/api/accounts/object?api-version=2024-06-20#account_object-future_requirements-current_deadline-currently_due-eventually_due-past_due-pending_verification) |
| `due_by`, `fields_needed` | 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) |

#### Java

| Parameters | Change | Resources or methods |
| --- | --- | --- |
| `businessLogo`, `businessLogoLarge`, `businessName`, `businessPrimaryColor`, `businessUrl`, `debitNegativeBalances`, `declineChargeOn`, `payoutSchedule`, `payoutStatementDescriptor`, `productDescription`, `statementDescriptor`, `statementDescriptorPrefixKana`, `statementDescriptorPrefixKanji`, `supportEmail`, `supportPhone`, `supportUrl` | Removed | [Account](/api/accounts/object?api-version=2024-06-20#account_object), [AccountCreateParams](/api/accounts/create?api-version=2024-06-20#create_account), [AccountUpdateParams](/api/accounts/update?api-version=2024-06-20#update_account) |
| `legalEntity` | Removed | [Account](/api/accounts/object?api-version=2024-06-20#account_object), [AccountCreateParams](/api/accounts/create?api-version=2024-06-20#create_account), [AccountUpdateParams](/api/accounts/update?api-version=2024-06-20#update_account), [TokenCreateParams.account](/api/tokens/create_bank_account?api-version=2024-06-20#create_bank_account_token-account) |
| `statementDescriptorPrefix` | Removed | [AccountCreateParams](/api/accounts/create?api-version=2024-06-20#create_account), [AccountUpdateParams](/api/accounts/update?api-version=2024-06-20#update_account) |
| `businessProfile`, `requirements`, `settings` | Added | [Account](/api/accounts/object?api-version=2024-06-20#account_object-business_profile-requirements-settings) |
| `businessType`, `company`, `individual` | Added | [Account](/api/accounts/object?api-version=2024-06-20#account_object-business_type-company-individual), [TokenCreateParams.account](/api/tokens/create_bank_account?api-version=2024-06-20#create_bank_account_token-account-business_type-company-individual) |
| `displayName`, `keys`, `statementDescriptorKana`, `statementDescriptorKanji`, `supportAddress`, `timezone`, `verification` | Removed | [Account](/api/accounts/object?api-version=2024-06-20#account_object) |
| `currentDeadline`, `currentlyDue`, `eventuallyDue`, `pastDue`, `pendingVerification` | Added | [Account.additional_verifications.address.requirements](/api/accounts/object?api-version=2024-06-20#account_object-additional_verifications-address-requirements-current_deadline-currently_due-eventually_due-past_due-pending_verification), [Account.additional_verifications.document.requirements](/api/accounts/object?api-version=2024-06-20#account_object-additional_verifications-document-requirements-current_deadline-currently_due-eventually_due-past_due-pending_verification), [Account.additional_verifications.person_identity.requirements](/api/accounts/object?api-version=2024-06-20#account_object-additional_verifications-person_identity-requirements-current_deadline-currently_due-eventually_due-past_due-pending_verification), [Account.additional_verifications.tax_id.requirements](/api/accounts/object?api-version=2024-06-20#account_object-additional_verifications-tax_id-requirements-current_deadline-currently_due-eventually_due-past_due-pending_verification), [Account.additional_verifications.tax_reporting.requirements](/api/accounts/object?api-version=2024-06-20#account_object-additional_verifications-tax_reporting-requirements-current_deadline-currently_due-eventually_due-past_due-pending_verification), [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-current_deadline-currently_due-eventually_due-past_due-pending_verification), [Account.additional_verifications.vat_id.requirements](/api/accounts/object?api-version=2024-06-20#account_object-additional_verifications-vat_id-requirements-current_deadline-currently_due-eventually_due-past_due-pending_verification), [Account.future_requirements](/api/accounts/object?api-version=2024-06-20#account_object-future_requirements-current_deadline-currently_due-eventually_due-past_due-pending_verification) |
| `dueBy`, `fieldsNeeded` | 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) |

#### Node.js

| Parameters | Change | Resources or methods |
| --- | --- | --- |
| `business_logo`, `business_logo_large`, `business_name`, `business_primary_color`, `business_url`, `debit_negative_balances`, `decline_charge_on`, `payout_schedule`, `payout_statement_descriptor`, `product_description`, `statement_descriptor`, `statement_descriptor_prefix_kana`, `statement_descriptor_prefix_kanji`, `support_email`, `support_phone`, `support_url` | Removed | [Account](/api/accounts/object?api-version=2024-06-20#account_object), [AccountCreateParams](/api/accounts/create?api-version=2024-06-20#create_account), [AccountUpdateParams](/api/accounts/update?api-version=2024-06-20#update_account) |
| `legal_entity` | Removed | [Account](/api/accounts/object?api-version=2024-06-20#account_object), [AccountCreateParams](/api/accounts/create?api-version=2024-06-20#create_account), [AccountUpdateParams](/api/accounts/update?api-version=2024-06-20#update_account), [TokenCreateParams.account](/api/tokens/create_bank_account?api-version=2024-06-20#create_bank_account_token-account) |
| `statement_descriptor_prefix` | Removed | [AccountCreateParams](/api/accounts/create?api-version=2024-06-20#create_account), [AccountUpdateParams](/api/accounts/update?api-version=2024-06-20#update_account) |
| `business_profile`, `requirements`, `settings` | Added | [Account](/api/accounts/object?api-version=2024-06-20#account_object-business_profile-requirements-settings) |
| `business_type`, `company`, `individual` | Added | [Account](/api/accounts/object?api-version=2024-06-20#account_object-business_type-company-individual), [TokenCreateParams.account](/api/tokens/create_bank_account?api-version=2024-06-20#create_bank_account_token-account-business_type-company-individual) |
| `display_name`, `keys`, `statement_descriptor_kana`, `statement_descriptor_kanji`, `support_address`, `timezone`, `verification` | Removed | [Account](/api/accounts/object?api-version=2024-06-20#account_object) |
| `current_deadline`, `currently_due`, `eventually_due`, `past_due`, `pending_verification` | Added | [Account.additional_verifications.address.requirements](/api/accounts/object?api-version=2024-06-20#account_object-additional_verifications-address-requirements-current_deadline-currently_due-eventually_due-past_due-pending_verification), [Account.additional_verifications.document.requirements](/api/accounts/object?api-version=2024-06-20#account_object-additional_verifications-document-requirements-current_deadline-currently_due-eventually_due-past_due-pending_verification), [Account.additional_verifications.person_identity.requirements](/api/accounts/object?api-version=2024-06-20#account_object-additional_verifications-person_identity-requirements-current_deadline-currently_due-eventually_due-past_due-pending_verification), [Account.additional_verifications.tax_id.requirements](/api/accounts/object?api-version=2024-06-20#account_object-additional_verifications-tax_id-requirements-current_deadline-currently_due-eventually_due-past_due-pending_verification), [Account.additional_verifications.tax_reporting.requirements](/api/accounts/object?api-version=2024-06-20#account_object-additional_verifications-tax_reporting-requirements-current_deadline-currently_due-eventually_due-past_due-pending_verification), [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-current_deadline-currently_due-eventually_due-past_due-pending_verification), [Account.additional_verifications.vat_id.requirements](/api/accounts/object?api-version=2024-06-20#account_object-additional_verifications-vat_id-requirements-current_deadline-currently_due-eventually_due-past_due-pending_verification), [Account.future_requirements](/api/accounts/object?api-version=2024-06-20#account_object-future_requirements-current_deadline-currently_due-eventually_due-past_due-pending_verification) |
| `due_by`, `fields_needed` | 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) |

#### Go

| Parameters | Change | Resources or methods |
| --- | --- | --- |
| `BusinessLogo`, `BusinessLogoLarge`, `BusinessName`, `BusinessPrimaryColor`, `BusinessURL`, `DebitNegativeBalances`, `DeclineChargeOn`, `PayoutSchedule`, `PayoutStatementDescriptor`, `ProductDescription`, `StatementDescriptor`, `StatementDescriptorPrefixKana`, `StatementDescriptorPrefixKanji`, `SupportEmail`, `SupportPhone`, `SupportURL` | Removed | [Account](/api/accounts/object?api-version=2024-06-20#account_object), [AccountParams](/api/accounts/update?api-version=2024-06-20#update_account) |
| `LegalEntity` | Removed | [Account](/api/accounts/object?api-version=2024-06-20#account_object), [AccountParams](/api/accounts/update?api-version=2024-06-20#update_account), [TokenAccountParams](/api/tokens/create_bank_account?api-version=2024-06-20#create_bank_account_token-account) |
| `StatementDescriptorPrefix` | Removed | [AccountParams](/api/accounts/update?api-version=2024-06-20#update_account) |
| `BusinessProfile`, `Requirements`, `Settings` | Added | [Account](/api/accounts/object?api-version=2024-06-20#account_object-business_profile-requirements-settings) |
| `BusinessType`, `Company`, `Individual` | Added | [Account](/api/accounts/object?api-version=2024-06-20#account_object-business_type-company-individual), [TokenAccountParams](/api/tokens/create_bank_account?api-version=2024-06-20#create_bank_account_token-account-business_type-company-individual) |
| `DisplayName`, `Keys`, `StatementDescriptorKana`, `StatementDescriptorKanji`, `SupportAddress`, `Timezone`, `Verification` | Removed | [Account](/api/accounts/object?api-version=2024-06-20#account_object) |
| `CurrentDeadline`, `CurrentlyDue`, `EventuallyDue`, `PastDue`, `PendingVerification` | Added | [AccountAdditionalVerificationsAddressRequirements](/api/accounts/object?api-version=2024-06-20#account_object-additional_verifications-address-requirements-current_deadline-currently_due-eventually_due-past_due-pending_verification), [AccountAdditionalVerificationsDocumentRequirements](/api/accounts/object?api-version=2024-06-20#account_object-additional_verifications-document-requirements-current_deadline-currently_due-eventually_due-past_due-pending_verification), [AccountAdditionalVerificationsPersonIdentityRequirements](/api/accounts/object?api-version=2024-06-20#account_object-additional_verifications-person_identity-requirements-current_deadline-currently_due-eventually_due-past_due-pending_verification), [AccountAdditionalVerificationsTaxIdRequirements](/api/accounts/object?api-version=2024-06-20#account_object-additional_verifications-tax_id-requirements-current_deadline-currently_due-eventually_due-past_due-pending_verification), [AccountAdditionalVerificationsTaxReportingRequirements](/api/accounts/object?api-version=2024-06-20#account_object-additional_verifications-tax_reporting-requirements-current_deadline-currently_due-eventually_due-past_due-pending_verification), [AccountAdditionalVerificationsUsW8OrW9Requirements](/api/accounts/object?api-version=2024-06-20#account_object-additional_verifications-us_w8_or_w9-requirements-current_deadline-currently_due-eventually_due-past_due-pending_verification), [AccountAdditionalVerificationsVatIdRequirements](/api/accounts/object?api-version=2024-06-20#account_object-additional_verifications-vat_id-requirements-current_deadline-currently_due-eventually_due-past_due-pending_verification), [AccountFutureRequirements](/api/accounts/object?api-version=2024-06-20#account_object-future_requirements-current_deadline-currently_due-eventually_due-past_due-pending_verification) |
| `DueBy`, `FieldsNeeded` | 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) |

#### .NET

| Parameters | Change | Resources or methods |
| --- | --- | --- |
| `BusinessLogo`, `BusinessLogoLarge`, `BusinessName`, `BusinessPrimaryColor`, `BusinessUrl`, `DebitNegativeBalances`, `DeclineChargeOn`, `PayoutSchedule`, `PayoutStatementDescriptor`, `ProductDescription`, `StatementDescriptor`, `StatementDescriptorPrefixKana`, `StatementDescriptorPrefixKanji`, `SupportEmail`, `SupportPhone`, `SupportUrl` | Removed | [Account](/api/accounts/object?api-version=2024-06-20#account_object), [AccountCreateOptions](/api/accounts/create?api-version=2024-06-20#create_account), [AccountUpdateOptions](/api/accounts/update?api-version=2024-06-20#update_account) |
| `LegalEntity` | Removed | [Account](/api/accounts/object?api-version=2024-06-20#account_object), [AccountCreateOptions](/api/accounts/create?api-version=2024-06-20#create_account), [AccountUpdateOptions](/api/accounts/update?api-version=2024-06-20#update_account), [TokenAccountOptions](/api/tokens/create_bank_account?api-version=2024-06-20#create_bank_account_token-account) |
| `StatementDescriptorPrefix` | Removed | [AccountCreateOptions](/api/accounts/create?api-version=2024-06-20#create_account), [AccountUpdateOptions](/api/accounts/update?api-version=2024-06-20#update_account) |
| `BusinessProfile`, `Requirements`, `Settings` | Added | [Account](/api/accounts/object?api-version=2024-06-20#account_object-business_profile-requirements-settings) |
| `BusinessType`, `Company`, `Individual` | Added | [Account](/api/accounts/object?api-version=2024-06-20#account_object-business_type-company-individual), [TokenAccountOptions](/api/tokens/create_bank_account?api-version=2024-06-20#create_bank_account_token-account-business_type-company-individual) |
| `DisplayName`, `Keys`, `StatementDescriptorKana`, `StatementDescriptorKanji`, `SupportAddress`, `Timezone`, `Verification` | Removed | [Account](/api/accounts/object?api-version=2024-06-20#account_object) |
| `CurrentDeadline`, `CurrentlyDue`, `EventuallyDue`, `PastDue`, `PendingVerification` | Added | [Account.AdditionalVerifications.Address.Requirements](/api/accounts/object?api-version=2024-06-20#account_object-additional_verifications-address-requirements-current_deadline-currently_due-eventually_due-past_due-pending_verification), [Account.AdditionalVerifications.Document.Requirements](/api/accounts/object?api-version=2024-06-20#account_object-additional_verifications-document-requirements-current_deadline-currently_due-eventually_due-past_due-pending_verification), [Account.AdditionalVerifications.PersonIdentity.Requirements](/api/accounts/object?api-version=2024-06-20#account_object-additional_verifications-person_identity-requirements-current_deadline-currently_due-eventually_due-past_due-pending_verification), [Account.AdditionalVerifications.TaxId.Requirements](/api/accounts/object?api-version=2024-06-20#account_object-additional_verifications-tax_id-requirements-current_deadline-currently_due-eventually_due-past_due-pending_verification), [Account.AdditionalVerifications.TaxReporting.Requirements](/api/accounts/object?api-version=2024-06-20#account_object-additional_verifications-tax_reporting-requirements-current_deadline-currently_due-eventually_due-past_due-pending_verification), [Account.AdditionalVerifications.UsW8OrW9.Requirements](/api/accounts/object?api-version=2024-06-20#account_object-additional_verifications-us_w8_or_w9-requirements-current_deadline-currently_due-eventually_due-past_due-pending_verification), [Account.AdditionalVerifications.VatId.Requirements](/api/accounts/object?api-version=2024-06-20#account_object-additional_verifications-vat_id-requirements-current_deadline-currently_due-eventually_due-past_due-pending_verification), [Account.FutureRequirements](/api/accounts/object?api-version=2024-06-20#account_object-future_requirements-current_deadline-currently_due-eventually_due-past_due-pending_verification) |
| `DueBy`, `FieldsNeeded` | 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) |

## 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: 2019-02-19`
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).