---
title: Tax summary webhook now includes merchant business entity information - Shopify developer changelog
description: Shopify’s developer changelog documents all changes to Shopify’s platform. Find the latest news and learn about new platform opportunities.
source_url:
  html: https://shopify.dev/changelog/tax-summary-webhook-now-includes-merchant-business-entity-information
  md: https://shopify.dev/changelog/tax-summary-webhook-now-includes-merchant-business-entity-information.md
---

[Back to Developer changelog](https://shopify.dev/changelog)

December 24, 2025

Tags:

* Admin GraphQL API
* Webhook
* 2026-01

# Tax summary webhook now includes merchant business entity information

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

**What's New**

The tax webhook payload now feature 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}`)

* `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
  * City
  * Zip code
  * Company name

This field is optional and will only be present when the merchant has configured a legal business entity for their shop.

**Structure**

**Before (2026-01):**

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

**After (2026-01):**

```json
{
  "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",
        "city": "Toronto",
        "zip": "M5V 2T6",
        "company": "Acme Corporation"
      }
    }
  }
}
```