Stripe | Financial Infrastructure to Grow Your Revenue

Stripe | Financial Infrastructure to Grow Your Revenue

4466 articles

Customers now provide a tax_info object with their tax ID details


Breaking changes

Customers now provide a tax_info object with their tax ID details Breaking changes

What’s new

In both requests and responses, changes the Customer object business_vat_id attribute from a string to hash called tax_info, consisting of tax_id and type.

Impact

This change restructures the customer’s VAT information from a simple string to a more detailed hash structure. You can now provide and access more comprehensive tax information, including both the tax ID and its type. This modification requires updates to code that creates, updates, or retrieves customer tax information.

Changes

ParametersChangeResources or endpoints
business_vat_idRemovedCustomer Customer#create Customer#update
tax_infoAddedCustomer

Upgrade

  1. View your current API version 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 to include Stripe-Version: 2018-08-23
  1. Upgrade the API version used for webhook endpoints .
  2. Test your integration against the new version.
  3. If you use Connect, test your Connect integration .
  4. In Workbench, perform the upgrade . You can roll back the version for 72 hours.

Learn more about Stripe API upgrades.

Last verified 2026-09-24

Is this helpful?