# 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 transaction

```json
{
  "uuid": "d8361719-290b-4b80-8e75-8329321a4000",
  "name": "Reforza Corporation",
  "shortName": "RCI",
  "description": "Whale Technology Company",
  "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"
  }
}
```

### Sub-account Object Schema

<table data-full-width="true"><thead><tr><th width="275">Schema Path</th><th width="188">Specs and Validation</th><th>Description</th></tr></thead><tbody><tr><td><strong>uuid</strong></td><td><ul><li>String</li></ul></td><td>Object Unique Identifier</td></tr><tr><td><strong>name</strong></td><td><ul><li>String</li><li>Required</li></ul></td><td>Name of the sub-merchant</td></tr><tr><td><strong>shortName</strong></td><td><ul><li>String</li><li>Required</li></ul></td><td>Short Name of the sub-merchant, used as the transaction statement descriptor</td></tr><tr><td><strong>description</strong></td><td><ul><li>String</li><li>Optional</li></ul></td><td>Description of the sub-merchant</td></tr><tr><td><strong>address</strong></td><td><ul><li>String</li><li>Optional</li></ul></td><td>Full address of the sub-merchant company</td></tr><tr><td><strong>postCode</strong></td><td><ul><li>String</li><li>Optional</li></ul></td><td>Postal code of the sub-merchant company address</td></tr><tr><td><strong>logo</strong></td><td><ul><li>String</li><li>Optional</li></ul></td><td>cloud storage URL of the sub-merchant logo</td></tr><tr><td><strong>merchantEmail</strong></td><td><ul><li>String</li><li>Required</li><li>Unique</li></ul></td><td>Email Address of the sub-merchant</td></tr><tr><td><strong>merchantPhone</strong></td><td><ul><li>String</li><li>Required</li></ul></td><td>Phone Number of the sub-merchant</td></tr><tr><td><strong>picEmail</strong></td><td><ul><li>String</li><li>Required</li></ul></td><td>PIC email address</td></tr><tr><td><strong>picPhone</strong></td><td><ul><li>String</li><li>Required</li></ul></td><td>PIC phone number</td></tr><tr><td><strong>picName</strong></td><td><ul><li>String</li><li>Required</li></ul></td><td>PIC Full Name</td></tr><tr><td><strong>picJobTitle</strong></td><td><ul><li>String</li><li>Optional</li></ul></td><td>PIC Job Title</td></tr><tr><td><strong>businessType</strong></td><td><ul><li>String</li><li>Required</li></ul></td><td>Type of the business of sub-merchant, one of <mark style="color:orange;"><code>INDVIDUAL</code></mark> or <mark style="color:orange;"><code>COMPANY</code></mark>. </td></tr><tr><td><strong>businessStructure</strong></td><td><ul><li>String</li><li>Required</li></ul></td><td><p>Business structure of the sub-merchants. e.g. CV, PT, etc. </p><p></p><p>Business structure is regulated differently in each Country.</p></td></tr><tr><td><strong>businessCountry</strong></td><td><ul><li>String</li><li>Required</li></ul></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><strong>parentIndustry</strong></td><td><ul><li>String</li></ul></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><strong>childIndustry</strong></td><td><ul><li>String</li></ul></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><strong>mcc</strong></td><td><ul><li>String</li></ul></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><strong>countryOfEntity</strong></td><td><ul><li>String</li></ul></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><strong>digitalStatus</strong></td><td><ul><li>String</li></ul></td><td>Selling Digital Product / Non Digital Product, possible values are <code>Digital</code> or <code>Non-digital</code></td></tr><tr><td><strong>parentId</strong></td><td><ul><li>String</li></ul></td><td>Parent Merchant's UUID</td></tr><tr><td><strong>autoWithdrawal</strong></td><td><ul><li>String</li></ul></td><td>Auto-withdrawal options for sub-merchant, default value is ON</td></tr><tr><td><ul><li><strong>channelCode</strong></li></ul></td><td><ul><li>String</li></ul></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="../../payout-local/channel-codes">channel-codes</a></p></td></tr><tr><td><ul><li><strong>bankName</strong></li></ul></td><td><ul><li>String</li></ul></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="../../payout-local/channel-codes">channel-codes</a></p></td></tr><tr><td><ul><li><strong>accountNumber</strong></li></ul></td><td><ul><li>String</li></ul></td><td>Account Number of Withdrawal destination</td></tr><tr><td><ul><li><strong>accountName</strong></li></ul></td><td><ul><li>String</li></ul></td><td>Account Name of Withdrawal destination</td></tr></tbody></table>
