Breaking changes
Adds new account requirement error codes to the Accounts API Breaking changes
What’s new
Adds the following error codes to the requirements.errors array in the Accounts API. To learn more, see Account requirements errors.
- invalid _ address _ highway _ contract _ box
- invalid _ address _ private _ mailbox
- invalid _ business _ profile _ name
- invalid _ business _ profile _ name _ denylisted
- invalid _ company _ name _ denylisted
- invalid _ dob _ age _ over _ maximum
- invalid _ dob _ age _ under _ minimum
- invalid _ product _ description _ length
- invalid _ product _ description _ url _ match
- invalid _ statement _ descriptor _ business _ mismatch
- invalid _ statement _ descriptor _ denylisted
- invalid _ statement _ descriptor _ length
- invalid _ statement _ descriptor _ prefix _ denylisted
- invalid _ statement _ descriptor _ prefix _ mismatch
- invalid _ tax _ id _ format
- invalid _ url _ denylisted
- invalid _ url _ format
- invalid _ url _ web _ presence _ detected
- invalid _ url _ website _ business _ information _ mismatch
- invalid _ url _ website _ empty
- invalid _ url _ website _ inaccessible
- invalid _ url _ website _ inaccessible _ geoblocked
- invalid _ url _ website _ inaccessible _ password _ protected
- invalid _ url _ website _ incomplete
- invalid _ url _ website _ incomplete _ cancellation _ policy
- invalid _ url _ website _ incomplete _ customer _ service _ details
- invalid _ url _ website _ incomplete _ legal _ restrictions
- invalid _ url _ website _ incomplete _ refund _ policy
- invalid _ url _ website _ incomplete _ return _ policy
- invalid _ url _ website _ incomplete _ terms _ and _ conditions
- invalid _ url _ website _ incomplete _ under _ construction
- invalid _ url _ website _ other
Impact
Lets you get detailed error messages for issues with addresses, business profiles, company names, dates of birth, product descriptions, statement descriptors, tax IDs, and URLs.
Changes
| Values | Change | Enums |
|---|---|---|
| invalid_address_highway_contract_box invalid_address_private_mailbox invalid_business_profile_name invalid_business_profile_name_denylisted invalid_company_name_denylisted invalid_dob_age_over_maximum invalid_dob_age_under_minimum invalid_product_description_length invalid_product_description_url_match invalid_statement_descriptor_business_mismatch invalid_statement_descriptor_denylisted invalid_statement_descriptor_length invalid_statement_descriptor_prefix_denylisted invalid_statement_descriptor_prefix_mismatch invalid_tax_id_format invalid_url_denylisted invalid_url_format invalid_url_web_presence_detected invalid_url_website_business_information_mismatch invalid_url_website_empty invalid_url_website_inaccessible invalid_url_website_inaccessible_geoblocked invalid_url_website_inaccessible_password_protected invalid_url_website_incomplete invalid_url_website_incomplete_cancellation_policy invalid_url_website_incomplete_customer_service_details invalid_url_website_incomplete_legal_restrictions invalid_url_website_incomplete_refund_policy invalid_url_website_incomplete_return_policy invalid_url_website_incomplete_terms_and_conditions invalid_url_website_incomplete_under_construction invalid_url_website_other | Added | Account. requirements. errors[]. code Account. future_requirements. errors[]. code |
Upgrade
- View your current API version in Workbench.
- 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 to include Stripe-Version: 2023-10-16
- Upgrade the API version used for webhook endpoints .
- Test your integration against the new version.
- If you use Connect, test your Connect integration .
Learn more about Stripe API upgrades.