---
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
metadata:
  effectiveApiVersion: 2026-04
  affectedApi:
    - displayName: Admin GraphQL API
      handle: admin-graphql
    - displayName: Webhook
      handle: webhook
  primaryTag:
    displayName: API
    handle: api
  secondaryTag:
    displayName: New
    handle: new
  indicatesActionRequired: false
  createdAt: '2025-12-23T16:29:47-05:00'
  postedAt: '2026-04-01T12:00:00-04:00'
  updatedAt: '2026-04-08T09:28:51-04:00'
  effectiveAt: '2025-12-24T12:00:00-05:00'
---

April 1, 2026

Tags:

* Admin GraphQL API
* Webhook
* 2026-04

# 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):

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

### After (2026-04):

```json
{
  "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"
      }
    }
  }
}
```