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

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.

Upgrade