On This Page
Organizations enable you to build a hierarchy of accounts that represents your business
structure. The organization information is contained in the
organizationInformation
object of the API request. Figure:
Hierarchy
Understanding Organization Identifiers
Three kinds of unique identifiers identify organizations and their positions in your
business hierarchy.
Identifier | Description |
|---|---|
organizationId | Unique value that identifies every organization. If you do not assign one in
the POST request, it is generated and included in the response. |
parentOrganizationId | All organizations except the root organization in the hierarchy must also be
assigned a parentOrganizationId value. It is a relative value that
refers to the parent organization in the hierarchy, thus establishing the
organization’s position in the hierarchy of your business. |
childOrganizations | This array is returned in the response and specifies all child organizations
relative to the organization created by the POST request. All organizations have
child organizations except transacting organizations. |
When you create a merchant organization, a corresponding transacting organization is created
and its information is returned in the response. The parent organization ID of
the transacting organization is the merchant organization’s organization ID.
Figure:
Parent-Child Relationships
