Tax calculation requests now include merchant business entity information

As of API version 2026-04, tax calculation requests sent to Tax Partner Apps include merchant business entity information. This provides details about the business entity responsible for a transaction, enabling tax partners to apply the appropriate tax rules.

What's new

Tax calculation requests now feature a new merchant_business_entity field at the root level of the request. This field includes the following details:

• id: The business entity Global ID, in the format gid://shopify/BusinessEntity/{id}
• company_name: The legal name of the business entity
• display_name: The display name of the business entity
• address: The business entity's address, including:
  • country
  • province
  • Address lines (address1, address2)
  • city
  • zip

The field is present only when the merchant has configured a business entity for the shop.

Versions before 2026-04

{
  "shop": { "...": "..." },
  "cart": { "...": "..." },
  "currency_code": "USD",
  "session_id": "session_123"
}

Version 2026-04 and later

{
  "shop": { "...": "..." },
  "cart": { "...": "..." },
  "currency_code": "USD",
  "session_id": "session_123",
  "merchant_business_entity": {
    "id": "gid://shopify/BusinessEntity/456",
    "company_name": "Test Company",
    "display_name": "Test Display",
    "address": {
      "country": "US",
      "province": "CA",
      "address1": "123 Main St",
      "address2": "Suite 100",
      "city": "San Francisco",
      "zip": "94102"
    }
  }
}