Skip to main content
object

A legal entity through which a merchant operates. Each business entity contains its own BusinessEntityAddress, company information, and can be associated with its own ShopifyPaymentsAccount. Market objects can be assigned to a business entity to determine payment processing and Order attribution.

Every shop must have one primary business entity. Additional entities enable international operations by establishing legal presence in multiple countries.

Learn more about managing multiple legal entities.

BusinessEntityAddress!
non-null

The address of the merchant's Business Entity.

Boolean!
non-null

Whether the Business Entity is archived from the shop.

String

The name of the company associated with the merchant's Business Entity.

String!
non-null

The display name of the merchant's Business Entity.

ID!
non-null

A globally-unique ID.

Boolean!
non-null

Whether it's the merchant's primary Business Entity.

Anchor to shopifyPaymentsAccountshopifyPaymentsAccount
ShopifyPaymentsAccount

Returns the Shopify Payments account information for the shop. Includes current balances across all currencies, payout schedules, and bank account configurations.

The account includes ShopifyPaymentsBalanceTransaction records showing charges, refunds, and adjustments that affect your balance. Also includes ShopifyPaymentsDispute records and ShopifyPaymentsPayout history between the account and connected ShopifyPaymentsBankAccount configurations.


Was this section helpful?

query

Returns the list of business entities associated with the shop. Use this query to retrieve business entities for assigning to markets, managing payment providers per entity, or viewing entity attribution on orders.

Each shop can have multiple business entities with one designated as primary. To identify the primary entity in the query results, set the primary field to true.

Learn more about managing multiple legal entities.

query

Returns a Business Entity by ID.


Was this section helpful?

interface

Was this section helpful?