---
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/posts/tax-summary-webhook-now-includes-merchant-business-entity-information
  md: >-
    https://shopify.dev/changelog/posts/tax-summary-webhook-now-includes-merchant-business-entity-information.md
metadata:
  effectiveApiVersion: 2026-04
  affectedApi:
    - displayName: Admin GraphQL API
      handle: admin-graphql
    - displayName: Events & webhooks
      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-08-14T16:26:03-04:00'
  effectiveAt: '2025-12-24T12:00:00-05:00'
---

April 1, 2026

# Tax summary webhook now includes merchant business entity information

DateApril 1, 2026

Version[2026-04](https://shopify.dev/changelog?api_version=2026-04)

FlagsNew

SurfacesAPI

Affected APIs[Admin GraphQL API](https://shopify.dev/changelog?api_type=admin-graphql)[Events & webhooks](https://shopify.dev/changelog?api_type=webhook)

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

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

## Version 2026-04 and later

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