> For the complete documentation index, see [llms.txt](https://pivot-payment.gitbook.io/pivot-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://pivot-payment.gitbook.io/pivot-docs/api-references/api-lists/account-and-balance/sub-account-management/sub-accounts-object.md).

# Sub-accounts Object

Sub-accounts Object is a business entity that you can manage when you need additional account for transparency and accountability in your transactions

```json
{
  "uuid": "d8361719-290b-4b80-8e75-8329321a4000",
  "name": "Reforza Corporation",
  "shortName": "RCI",
  "description": "Whale Technology Company",
  "website": "pivot-payment.com",
  "address": "H Rasuna Said, Jakarta",
  "postCode": "60541",
  "logo": "https://acme.inc/assets/logo.png",
  "merchantEmail": "admin@corp.inc",
  "merchantPhone": "081217003600",
  "picEmail": "admin@corp.inc",
  "picPhone": "081217003600",
  "picName": "Reforza",
  "picJobTitle": "owner",
  "businessType": "COMPANY",
  "businessStructure": "PERSEROAN TERBATAS",
  "businessCountry": "ID",
  "parentIndustry": "Airlines",
  "childIndustry": "Airlines, Air Carriers",
  "mcc": "4511",
  "countryOfEntity": "ID",
  "digitalStatus": "Digital",
  "parentId": "e485e01b-ff59-4a47-bb7d-9b39064f3388",
  "autoWithdrawal": "ON",
  "bankAccount": {
    "channelCode": "JENIUS",
    "bankName": "PT BANK BTPN TBK",
    "accountNumber": "90016666001",
    "accountName": "Sdr. Dummy Account Success"
  },
  "subAccountStatus": "CREATED",
  "subAccountType": "KYC",
  "subAccountKycStatus": "WAITING_FOR_DOCUMENT"
}
```

**Detail Sub-accounts Object**

<table data-full-width="false"><thead><tr><th width="275">Parameter</th><th width="116.9149169921875">Data Type</th><th width="134.8228759765625">Requirement</th><th>Description</th></tr></thead><tbody><tr><td>uuid</td><td>String</td><td>M</td><td>Object Unique Identifier</td></tr><tr><td>name</td><td>String</td><td>M</td><td>Name of the Sub-account</td></tr><tr><td>shortName</td><td>String</td><td>M</td><td>Short Name of the Sub-account, used as the transaction statement descriptor</td></tr><tr><td>description</td><td>String</td><td>O</td><td>Description of the Sub-account</td></tr><tr><td>website</td><td>String</td><td>M</td><td>Website URL of the Sub-account</td></tr><tr><td>address</td><td>String</td><td>O</td><td>Full address of the Sub-account company</td></tr><tr><td>postCode</td><td>String</td><td>O</td><td>Postal code of the Sub-account company address</td></tr><tr><td>logo</td><td>String</td><td>O</td><td>cloud storage URL of the Sub-account logo</td></tr><tr><td>merchantEmail</td><td>String</td><td>M</td><td>Email Address of the Sub-account</td></tr><tr><td>merchantPhone</td><td>String</td><td>M</td><td>Phone Number of the Sub-account</td></tr><tr><td>picEmail</td><td>String</td><td>M</td><td>PIC email address</td></tr><tr><td>picPhone</td><td>String</td><td>M</td><td>PIC phone number</td></tr><tr><td>picName</td><td>String</td><td>M</td><td>PIC Full Name</td></tr><tr><td>picJobTitle</td><td>String</td><td>O</td><td>PIC Job Title</td></tr><tr><td>businessType</td><td>String</td><td>M</td><td>Type of the business of Sub-account, one of <mark style="color:orange;"><code>INDVIDUAL</code></mark> or <mark style="color:orange;"><code>COMPANY</code></mark>. </td></tr><tr><td>businessStructure</td><td>String</td><td>M</td><td><p>Business structure of the Sub-account. e.g. CV, PT, etc. </p><p></p><p>Business structure is regulated differently in each Country.</p></td></tr><tr><td>businessCountry</td><td>String</td><td>M</td><td>Two letter digits country code based on <a href="https://en.wikipedia.org/wiki/ISO_3166-1">ISO 3166-1 alpha-2</a> where the business resides</td></tr><tr><td>parentIndustry</td><td>String</td><td>O</td><td>Industry in general<br><a href="https://docs.google.com/spreadsheets/d/1xl2f8e7CjxU-r4XHFcVP3Mnvqp8-vSV3x9St4s5044I/edit?usp=sharing">Merchant Industry List</a></td></tr><tr><td>childIndustry</td><td>String</td><td>O</td><td>Industry in specific<br><a href="https://docs.google.com/spreadsheets/d/1xl2f8e7CjxU-r4XHFcVP3Mnvqp8-vSV3x9St4s5044I/edit?usp=sharing">Merchant Industry List</a></td></tr><tr><td>mcc</td><td>String</td><td>O</td><td>Merchant Category Code<br><a href="https://docs.google.com/spreadsheets/d/1xl2f8e7CjxU-r4XHFcVP3Mnvqp8-vSV3x9St4s5044I/edit?usp=sharing">MCC Code List</a></td></tr><tr><td>countryOfEntity</td><td>String</td><td>O</td><td>Merchant's operational Country<br><a href="https://en.wikipedia.org/wiki/ISO_3166-1">ISO 3166-1 alpha-2</a></td></tr><tr><td>digitalStatus</td><td>String</td><td>O</td><td>Selling Digital Product / Non Digital Product, possible values are <mark style="color:orange;"><code>Digital</code></mark> or <mark style="color:orange;"><code>Non-digital</code></mark></td></tr><tr><td>parentId</td><td>String</td><td>M</td><td>Parent Merchant's UUID</td></tr><tr><td>autoWithdrawal</td><td>String</td><td>O</td><td>Auto-withdrawal options for Sub-account, default value is ON</td></tr><tr><td>bankAccount</td><td>Object</td><td>O</td><td></td></tr><tr><td><ul><li>channelCode</li></ul></td><td>String</td><td>M</td><td><p>Channel code for Withdrawal destination such as Bank, E wallet or other channels</p><p></p><p>List of Channel code can be accessed <a data-mention href="/pages/VLaKKcjXG5xkE8l7BiiC">/pages/VLaKKcjXG5xkE8l7BiiC</a></p></td></tr><tr><td><ul><li>bankName</li></ul></td><td>String</td><td>M</td><td><p>Bank name for Withdrawal destination such as Bank, E wallet or other channels</p><p></p><p>List of Channel code can be accessed <a data-mention href="/pages/VLaKKcjXG5xkE8l7BiiC">/pages/VLaKKcjXG5xkE8l7BiiC</a></p></td></tr><tr><td><ul><li>accountNumber</li></ul></td><td>String</td><td>M</td><td>Account Number of Withdrawal destination</td></tr><tr><td><ul><li>accountName</li></ul></td><td>String</td><td>M</td><td>Account Name of Withdrawal destination</td></tr><tr><td>subAccountStatus</td><td>String</td><td>M</td><td><a data-mention href="/pages/qVeICHIrovSaMmO8IjMJ">/pages/qVeICHIrovSaMmO8IjMJ</a></td></tr><tr><td>subAccountType</td><td>String</td><td>M</td><td><p>Possible values are:</p><ol><li>KYC</li><li>NON_KYC</li></ol><p></p><p>The default value is <mark style="color:orange;"><code>NON_KYC</code></mark></p></td></tr><tr><td>subAccountKycStatus</td><td>String</td><td>M</td><td><a data-mention href="/pages/qVeICHIrovSaMmO8IjMJ">/pages/qVeICHIrovSaMmO8IjMJ</a></td></tr></tbody></table>