Tax summary webhook now includes merchant business entity information

As of API version 2026-04, the tax_summaries/create webhook for Tax Partner Apps now includes merchant business entity information. This addition provides details about the legal entity responsible for transactions, which is crucial for accurate tax calculation and cross-shop entity mapping.

What's new

The tax webhook payload now features a new merchant_business_entity field at the root level of the tax summary. This field includes the following details:

• id: The global ID of the business entity (format: gid://shopify/BusinessEntity/{id})
• legal_entity_id: The stable Central Legal Entity ID from the Organizations Platform, enabling consistent identification of the same legal entity across multiple shops and markets
• 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
  • company

This field is optional and will only be present when the merchant has configured a legal business entity for their shop. The legal_entity_id sub-field is also optional and will only be present when the business entity is linked to a Central Legal Entity.

Before (2026-04):

{
  "summary": {
    "idempotent_key": "abc123",
    "shop": { ... },
    "order_details": { ... }
  }
}

After (2026-04):

{
  "summary": {
    "idempotent_key": "abc123",
    "shop": { ... },
    "order_details": { ... },
    "merchant_business_entity": {
      "id": "gid://shopify/BusinessEntity/12345",
      "legal_entity_id": "223432432",
      "company_name": "Acme Corporation",
      "display_name": "Acme Corp",
      "address": {
        "country": "CA",
        "province": "ON",
        "address1": "123 Main St",
        "city": "Toronto",
        "zip": "M5V 2T6",
        "company": "Acme Corporation"
      }
    }
  }
}