Documentation
Portal

Tenant Types

Joint accounts can have multiple tenants with associated authorizations, as described below:

Tenant TypesDefinition
IndividualA natural person who is granted authorizations to access the account
UTMA BeneficiaryThe minor child for whom the custodial account is held under the Uniform Transfers to Minors Act. The beneficiary is the legal owner of the funds, but has no control over the account until reaching the age of majority (18 or 21)
UTMA CustodianThe legally authorized adult who manages a UTMA account on behalf of the minor beneficiary
TrusteeThe person or institution legally responsible for managing the trust’s assets
Trust BeneficiaryThe individual or entity entitled to receive distributions or benefits from the Trust

Tenant Designations

Each multiple tenant account must have one Primary Participant, and at least one Secondary Participant.

Tenant DesignationsDefinition
PrimaryThe primary participant associated with the account creation
SecondaryThe secondary participant(s) associated with the account

Tenant Authorizations

Tenant authorizations define the level of access and control over an account. These authorizations are assigned based on the account type and tenant configuration.

AuthorizationPermissions
Full TradingThe ability to withdrawal funds, trade, and access statements & receipts
Limited TradingThe ability to trade and access statements & receipts. Cannot withdrawal funds
View OnlyThe ability to access statements & receipts. Cannot withdrawal funds or trade

Authorization Matrix

The below matrix represents the default authorizations for each Account Type and Tenant Type. Tenant authorizations can be updated after account creation.

Account Hierarchy

Steps for Setting Up Multiple Tenant Accounts and Tenants

  1. Create the primary and secondary participants using the participant creation zerohash methods;
    1. Individuals via;
      1. Onboarding SDK with KYCaaS
      2. POST /participants/customers/new endpoint.
    2. Entities through the POST /participants/entity/new endpoint.
  2. Create an account using POST /accounts
    1. Assign the primary participant participant_code: the primary participant's participant code
    2. Set account type bytype: the AccountTypeEnum
    3. Add the additional tenant(s) by tenants: the secondary participant(s)' participant codes

Updated about 1 hour ago

Did this page help you?