Business Entity
A legal entity through which a merchant operates. Each business entity contains its own , company information, and can be associated with its own . 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.
Anchor to FieldsFields
- Anchor to addressaddress•Business
Entity Address! non-null The address of the merchant's Business Entity.
- Anchor to archivedarchived•Boolean!non-null
Whether the Business Entity is archived from the shop.
- Anchor to companyNamecompany•String
Name The name of the company associated with the merchant's Business Entity.
- Anchor to displayNamedisplay•String!
Name non-null The display name of the merchant's Business Entity.
- •ID!non-null
A globally-unique ID.
- Anchor to primaryprimary•Boolean!non-null
Whether it's the merchant's primary Business Entity.
- Anchor to shopifyPaymentsAccountshopify•Shopify
Payments Account Payments Account Returns the Shopify Payments account information for the shop. Includes current balances across all currencies, payout schedules, and bank account configurations.
The account includes
records showing charges, refunds, and adjustments that affect your balance. Also includesrecords andhistory between the account and connectedconfigurations.
Anchor to QueriesQueries
- •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
primaryfield totrue.Learn more about managing multiple legal entities.
- •query
Returns a Business Entity by ID.