Tax summary webhook now includes merchant business entity information

As of API version 2026-04, the tax_summaries/create webhook sent to Tax Partner Apps includes merchant business entity information. This identifies the business entity responsible for the transactions represented by the tax summary.

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 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
  • company

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

Versions before 2026-04

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

Version 2026-04 and later

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