# Card holder

## Restricted Countries/Regions

{% hint style="info" %}
Cuba; North Korea; Egypt; Iran; Myanmar; Nigeria; Russia; Belarus; South Africa; Syria; Ukraine; Venezuela; Sudan; South Sudan; Libya; Crimea; Crimea (Ukraine); Burundi; Central African Republic; Somalia; Zimbabwe; Afghanistan
{% endhint %}

## Supported ID Types by Country/Region

* **Hong Kong**
  * PASSPORT
  * HK\_HKID
* **Other Countries/Regions**
  * PASSPORT
  * DLN (Driver's license)
  * GOVERNMENT\_ISSUED\_ID\_CARD (ID card)

## Cardholder-Occupation

```
POST /merchant/core/mcb/card/holder/occupations
```

**Request**

<table><thead><tr><th width="162.89935302734375">Param</th><th width="78">Type</th><th width="94">Required</th><th>Remark</th></tr></thead><tbody><tr><td></td><td></td><td></td><td></td></tr></tbody></table>

**Response**

<table><thead><tr><th width="197">Param</th><th width="135">Type</th><th width="115">Required</th><th>Remark</th></tr></thead><tbody><tr><td>occupationCode</td><td>String</td><td>True</td><td>Occupation code</td></tr><tr><td>description</td><td>String</td><td>True</td><td>Occupation</td></tr></tbody></table>

**Example Response**

```json
{
    "success": true,
    "code": 200,
    "msg": "Success",
    "data":
    [
        {
            "occupationCode": "11-1011",
            "description": "Chief Executives"
        }
    ]
}
```

## ~~Cardholder-Create-v1-Deprecated~~

```
POST /merchant/core/mcb/card/holder/create
```

**Request**

<table><thead><tr><th width="166.233154296875">Param</th><th width="81">Type</th><th width="112.2890625">Required</th><th>Remark</th></tr></thead><tbody><tr><td>merchantOrderNo</td><td>String</td><td>true</td><td>Client transaction id. length[20...40]</td></tr><tr><td>cardTypeId</td><td>Long</td><td>true</td><td>Card type ID</td></tr><tr><td>areaCode</td><td>String</td><td>true</td><td><p>Mobile phone area code. length[2...5].</p><p>Get <a href="../cards#supported-card-bin">Support Card Bin</a> Interface Parameter  supportHolderAreaCode</p></td></tr><tr><td>mobile</td><td>String</td><td>true</td><td>Mobile phone number. length[5...20] </td></tr><tr><td>email</td><td>String</td><td>true</td><td>Email. <strong>Receive verification code</strong>. length[5...50]</td></tr><tr><td>firstName</td><td>String</td><td>true</td><td>First Name. Only English characters are supported. length[2...32]<br>The total length of firstName and lastName cannot exceed 32 characters (including spaces)</td></tr><tr><td>lastName</td><td>String</td><td>true</td><td>Last name. Only English characters are supported. length[2...32].<br>The total length of firstName and lastName cannot exceed 32 characters (including spaces)</td></tr><tr><td>birthday</td><td>String</td><td>true</td><td>Date of birth. yyyy-MM-dd</td></tr><tr><td>nationality</td><td>String</td><td>true</td><td>Nationality Code. ISO 3166-1 alpha-2<br>Get <a href="../cards#supported-card-bin">Support Card Bin</a> Interface Parameter supportHolderRegin</td></tr><tr><td>country</td><td>String</td><td>true</td><td>Country/Region Code for bill address. ISO 3166-1 alpha-2<br>Get <a href="../cards#supported-card-bin">Support Card Bin</a> Interface Parameter supportHolderRegin</td></tr><tr><td>town</td><td>String</td><td>true</td><td>City Code for bill address. Get <a href="../../common#city-list">City List</a> Interface Parameter  code</td></tr><tr><td>address</td><td>String</td><td>true</td><td>Address for bill. length[2...40].<br>Can only contain letters, numbers, hyphens and spaces. regex: ^[A-Za-z0-9\- ]+$</td></tr><tr><td>postCode</td><td>String</td><td>true</td><td>Postal code for bill. length[2...15]. <br>regex: ^[a-zA-Z0-9]{1,15}$</td></tr></tbody></table>

**Response**

<table><thead><tr><th width="179.66162109375">Param</th><th width="98">Type</th><th width="115">Required</th><th>Remark</th></tr></thead><tbody><tr><td>holderId</td><td>Long</td><td>true</td><td>Cardholder id</td></tr><tr><td>merchantOrderNo</td><td>String</td><td>false</td><td>Client transaction id</td></tr><tr><td>cardTypeId</td><td>Long</td><td>true</td><td>Card type id</td></tr><tr><td>statusFlowLocation</td><td>String</td><td>true</td><td>Review flow location. <br>Process: Platform review first, then bank review. Update cardholders are supported only when statusFlowLocation=admin and status=reject<br><code>admin</code>: platform review;<br><code>channel</code>: bank review</td></tr><tr><td>status</td><td>String</td><td>true</td><td>Status. <br><code>wait_audit</code>: Pending; <br><code>pass_audit</code>: Approved; <br><code>under_review</code>: In review;<br><code>reject</code>: Rejected</td></tr><tr><td>description</td><td>String</td><td>false</td><td>Description</td></tr><tr><td>respMsg</td><td>String</td><td>false</td><td>remark, equal description. will remove</td></tr></tbody></table>

**Example Response**

```json
{
    "success": true,
    "code": 200,
    "msg": "Success",
    "data":
    {
        "holderId": 124024,
        "merchantOrderNo": "114242059249029235245352442",
        "cardTypeId": 124024,
        "statusFlowLocation": "admin",
        "status": "pass_audit",
        "description": "SUCCESS",
        "respMsg": "SUCCESS"
    }
}
```

## ~~Cardholder-Update-v1-Deprecated~~

```
POST /merchant/core/mcb/card/holder/update
```

**Request**

<table><thead><tr><th width="166.233154296875">Param</th><th width="81">Type</th><th width="112.2890625">Required</th><th>Remark</th></tr></thead><tbody><tr><td>holderId</td><td>Long</td><td>true</td><td>Holder id</td></tr><tr><td>areaCode</td><td>String</td><td>true</td><td><p>Mobile phone area code. length[2...5].</p><p>Get <a href="../cards#supported-card-bin">Support Card Bin</a> Interface Parameter  supportHolderAreaCode</p></td></tr><tr><td>mobile</td><td>String</td><td>true</td><td>Mobile phone number. length[5...20] </td></tr><tr><td>email</td><td>String</td><td>true</td><td>Email. <strong>Receive verification code</strong>. length[5...50]</td></tr><tr><td>firstName</td><td>String</td><td>true</td><td>First Name. Only English characters are supported. length[2...32]<br>The total length of firstName and lastName cannot exceed 32 characters (including spaces)</td></tr><tr><td>lastName</td><td>String</td><td>true</td><td>Last name. Only English characters are supported. length[2...32].<br>The total length of firstName and lastName cannot exceed 32 characters (including spaces)</td></tr><tr><td>birthday</td><td>String</td><td>true</td><td>Date of birth. yyyy-MM-dd</td></tr><tr><td>nationality</td><td>String</td><td>true</td><td>Nationality Code. ISO 3166-1 alpha-2<br>Get <a href="../cards#supported-card-bin">Support Card Bin</a> Interface Parameter supportHolderRegin</td></tr><tr><td>country</td><td>String</td><td>true</td><td>Country/Region Code for bill address. ISO 3166-1 alpha-2<br>Get <a href="../cards#supported-card-bin">Support Card Bin</a> Interface Parameter supportHolderRegin</td></tr><tr><td>town</td><td>String</td><td>true</td><td>City Code for bill address. Get <a href="../../common#city-list">City List</a> Interface Parameter  code</td></tr><tr><td>address</td><td>String</td><td>true</td><td>Address for bill. length[2...40].<br>Can only contain letters, numbers, hyphens and spaces. regex: ^[A-Za-z0-9\- ]+$</td></tr><tr><td>postCode</td><td>String</td><td>true</td><td>Postal code for bill. length[2...15]. <br>regex: ^[a-zA-Z0-9]{1,15}$</td></tr></tbody></table>

**Response**

<table><thead><tr><th width="179.66162109375">Param</th><th width="98">Type</th><th width="115">Required</th><th>Remark</th></tr></thead><tbody><tr><td>holderId</td><td>Long</td><td>true</td><td>Cardholder id</td></tr><tr><td>merchantOrderNo</td><td>String</td><td>false</td><td>Client transaction id</td></tr><tr><td>cardTypeId</td><td>Long</td><td>true</td><td>Card type id</td></tr><tr><td>statusFlowLocation</td><td>String</td><td>true</td><td>Review flow location. <br>Process: Platform review first, then bank review. Update cardholders are supported only when statusFlowLocation=admin and status=reject<br><code>admin</code>: platform review;<br><code>channel</code>: bank review</td></tr><tr><td>status</td><td>String</td><td>true</td><td>Status. <br><code>wait_audit</code>: Pending; <br><code>pass_audit</code>: Approved; <br><code>under_review</code>: In review;<br><code>reject</code>: Rejected</td></tr><tr><td>description</td><td>String</td><td>false</td><td>Description</td></tr><tr><td>respMsg</td><td>String</td><td>false</td><td>remark, equal description. will remove</td></tr></tbody></table>

**Example Response**

```json
{
    "success": true,
    "code": 200,
    "msg": "Success",
    "data":
    {
        "holderId": 124024,
        "merchantOrderNo": "114242059249029235245352442",
        "cardTypeId": 124024,
        "statusFlowLocation": "admin",
        "status": "pass_audit",
        "description": "SUCCESS",
        "respMsg": "SUCCESS"
    }
}
```

## Cardholder-Create-v2

{% hint style="info" %}
Please fill in the cardholder information truthfully. The cardholder cannot modify any information after submitting it to the bank. And the email address and ID number are globally unique under the same card type (cardTypeId). For example, if a user submits the email address <test@gmail.com> from channel A, the same email address will be rejected when submitted from channel B.
{% endhint %}

```
POST /merchant/core/mcb/card/holder/v2/create
```

**Request**

<details>

<summary>cardHolderModel = B2B</summary>

<table><thead><tr><th width="166.233154296875">Param</th><th width="81">Type</th><th width="112.2890625">Required</th><th>Remark</th></tr></thead><tbody><tr><td>cardHolderModel</td><td>String</td><td>true</td><td>Cardholder business model.<br><code>B2B</code></td></tr><tr><td>merchantOrderNo</td><td>String</td><td>true</td><td>Client transaction id. length[20...40]</td></tr><tr><td>cardTypeId</td><td>Long</td><td>true</td><td>Card type id</td></tr><tr><td>areaCode</td><td>String</td><td>true</td><td><p>Mobile area code. length[2...5].</p><p>Get <a href="../cards#support-bins">Support Bins</a> Interface Parameter  <code>supportHolderAreaCode</code>.</p></td></tr><tr><td>mobile</td><td>String</td><td>true</td><td>Mobile phone number. length[5...20] </td></tr><tr><td>email</td><td>String</td><td>true</td><td>Email. <strong>Receive verification code</strong>. length[5...50]</td></tr><tr><td>firstName</td><td>String</td><td>true</td><td>First Name. Only English characters are supported. length[2...32]<br>The total length of firstName and lastName cannot exceed 32 characters (including spaces)</td></tr><tr><td>lastName</td><td>String</td><td>true</td><td>Last name. Only English characters are supported. length[2...32].<br>The total length of firstName and lastName cannot exceed 32 characters (including spaces)</td></tr><tr><td>birthday</td><td>String</td><td>true</td><td>Date of birth. yyyy-MM-dd</td></tr><tr><td>country</td><td>String</td><td>true</td><td>Country/Region Code for bill address. ISO 3166-1 alpha-2<br>Get <a href="../cards#supported-card-bin">Support Bin</a> Interface Parameter <code>supportHolderRegin</code></td></tr><tr><td>town</td><td>String</td><td>true</td><td>City Code for bill address. Get <a href="../../common#city-list">City List</a> Interface Parameter <code>code</code></td></tr><tr><td>address</td><td>String</td><td>true</td><td>Address for bill. length[2...40].<br>Can only contain letters, numbers, hyphens and spaces. <br>regex: ^[A-Za-z0-9\- ]+$</td></tr><tr><td>postCode</td><td>String</td><td>true</td><td>Postal code for bill. length[2...15]. <br>regex: ^[a-zA-Z0-9]{1,15}$</td></tr></tbody></table>

</details>

<details>

<summary>cardHolderModel = B2C</summary>

<table><thead><tr><th width="166.233154296875">Param</th><th width="81">Type</th><th width="112.2890625">Required</th><th>Remark</th></tr></thead><tbody><tr><td>cardHolderModel</td><td>String</td><td>true</td><td>Cardholder business model.<br><code>B2C</code></td></tr><tr><td>merchantOrderNo</td><td>String</td><td>true</td><td>Client transaction id. length[20...40]</td></tr><tr><td>cardTypeId</td><td>Long</td><td>true</td><td>Card type id</td></tr><tr><td>areaCode</td><td>String</td><td>true</td><td><p>Mobile phone area code. length[2...5].</p><p>Get <a href="../cards#supported-card-bin">Support Bin</a> Interface Parameter  <code>supportHolderAreaCode</code></p></td></tr><tr><td>mobile</td><td>String</td><td>true</td><td>Mobile phone number. length[5...20] </td></tr><tr><td>email</td><td>String</td><td>true</td><td>Email. <strong>Receive verification code</strong>. length[5...50]</td></tr><tr><td>firstName</td><td>String</td><td>true</td><td>First Name. Only English characters are supported. length[2...32]<br>The total length of firstName and lastName cannot exceed 32 characters (including spaces)</td></tr><tr><td>lastName</td><td>String</td><td>true</td><td>Last name. Only English characters are supported. length[2...32].<br>The total length of firstName and lastName cannot exceed 32 characters (including spaces)</td></tr><tr><td>birthday</td><td>String</td><td>true</td><td>Date of birth. yyyy-MM-dd</td></tr><tr><td>nationality</td><td>String</td><td>true</td><td>Nationality Code. ISO 3166-1 alpha-2<br>Get <a href="../cards#support-bins">Support Bins</a> Interface Parameter <code>supportHolderRegin</code></td></tr><tr><td>country</td><td>String</td><td>true</td><td>Country/Region Code for bill address. ISO 3166-1 alpha-2<br>Get <a href="../cards#support-bins">Support Bins</a> Interface Parameter <code>supportHolderRegin</code></td></tr><tr><td>town</td><td>String</td><td>true</td><td>City Code for bill address. Get <a href="../../common#city-list">City List</a> Interface Parameter  code</td></tr><tr><td>address</td><td>String</td><td>true</td><td>Address for bill. length[2...40].<br>Can only contain letters, numbers, hyphens and spaces. <br>regex: ^[A-Za-z0-9\- ]+$</td></tr><tr><td>postCode</td><td>String</td><td>true</td><td>Postal code for bill. length[2...15]. <br>regex: ^[a-zA-Z0-9]{1,15}$</td></tr><tr><td>gender</td><td>String</td><td>true</td><td>Gender.<br><code>M</code>: male; <br><code>F</code>: female</td></tr><tr><td>occupation</td><td>String</td><td>true</td><td>Occupation. Get <a href="#cardholder-occupation">cardholder's occupation</a> Interface parameter <code>occupationCode</code> </td></tr><tr><td>annualSalary</td><td>String</td><td>true</td><td>Annual salary. example: 100000 USD</td></tr><tr><td>accountPurpose</td><td>String</td><td>true</td><td>Account purpose. Only supports English. example: Living Expense</td></tr><tr><td>expectedMonthlyVolume</td><td>String</td><td>true</td><td>Expected monthly trading volume. example: 10000 USD</td></tr><tr><td>idType</td><td>String</td><td>true</td><td>Id type.<br><code>PASSPORT</code>: Passport<br><code>HK_HKID</code>: Hong Kong Identity Card<br><code>DLN</code>: Driver's license<br><code>GOVERNMENT_ISSUED_ID_CARD</code>: ID Card</td></tr><tr><td>idNumber</td><td>String</td><td>true</td><td>Id number. length[2...50]</td></tr><tr><td>issueDate</td><td>String</td><td>true</td><td>ID document issuance date. format: yyyy-MM-dd</td></tr><tr><td>idNoExpiryDate</td><td>String</td><td>true</td><td>The certificate expiration date. format: yyyy-MM-dd</td></tr><tr><td>idFrontId</td><td>String</td><td>true</td><td>Front photo of ID card File id. Call <a href="../../common#upload-file">upload file</a> interface to get</td></tr><tr><td>idBackId</td><td>String</td><td>true</td><td>Back photo of ID card File id. Call <a href="../../common#upload-file">upload file</a> interface to get</td></tr><tr><td>idHoldId</td><td>String</td><td>true</td><td>User face photo File id. Call the <a href="../../common#upload-file">upload file</a> interface to obtain</td></tr><tr><td>ipAddress</td><td>String</td><td>true</td><td>IPV4 address.</td></tr></tbody></table>

</details>

**Response**

<table><thead><tr><th width="179.66162109375">Param</th><th width="98">Type</th><th width="115">Required</th><th>Remark</th></tr></thead><tbody><tr><td>holderId</td><td>Long</td><td>true</td><td>Cardholder id</td></tr><tr><td>merchantOrderNo</td><td>String</td><td>false</td><td>Client transaction id</td></tr><tr><td>cardTypeId</td><td>Long</td><td>true</td><td>Card type id</td></tr><tr><td>statusFlowLocation</td><td>String</td><td>true</td><td>Review flow location. <br>Process: Platform review first, then bank review. Update cardholders are supported only when statusFlowLocation=admin and status=reject<br><code>admin</code>: platform review;<br><code>channel</code>: bank review</td></tr><tr><td>status</td><td>String</td><td>true</td><td>Status. <br><code>wait_audit</code>: Pending; <br><code>pass_audit</code>: Approved; <br><code>under_review</code>: In review;<br><code>reject</code>: Rejected</td></tr><tr><td>description</td><td>String</td><td>false</td><td>Description</td></tr><tr><td>respMsg</td><td>String</td><td>false</td><td>remark, equal description. Deprecated will remove</td></tr></tbody></table>

**Example Response**

```json
{
    "success": true,
    "code": 200,
    "msg": "Success",
    "data":
    {
        "holderId": 124024,
        "merchantOrderNo": "114242059249029235245352442",
        "cardTypeId": 124024,
        "statusFlowLocation": "admin",
        "status": "pass_audit",
        "description": "SUCCESS",
        "respMsg": "SUCCESS"
    }
}
```

## Cardholder-Update-v2

{% hint style="info" %}
Updating the cardholder is supported only when status=reject
{% endhint %}

```
POST /merchant/core/mcb/card/holder/v2/update
```

**Request**

<details>

<summary>cardHolderModel = B2B</summary>

<table><thead><tr><th width="166.233154296875">Param</th><th width="81">Type</th><th width="112.2890625">Required</th><th>Remark</th></tr></thead><tbody><tr><td>cardHolderModel</td><td>String</td><td>true</td><td>Cardholder business model.<br><code>B2B</code></td></tr><tr><td>holderId</td><td>Long</td><td>true</td><td>Holder id</td></tr><tr><td>areaCode</td><td>String</td><td>true</td><td><p>Mobile phone area code. length[2...5].</p><p>Get <a href="../cards#supported-card-bin">Support Card Bin</a> Interface Parameter  supportHolderAreaCode</p></td></tr><tr><td>mobile</td><td>String</td><td>true</td><td>Mobile phone number. length[5...20] </td></tr><tr><td>email</td><td>String</td><td>true</td><td>Email. <strong>Receive verification code</strong>. length[5...50]</td></tr><tr><td>firstName</td><td>String</td><td>true</td><td>First Name. Only English characters are supported. length[2...32]<br>The total length of firstName and lastName cannot exceed 32 characters (including spaces)</td></tr><tr><td>lastName</td><td>String</td><td>true</td><td>Last name. Only English characters are supported. length[2...32].<br>The total length of firstName and lastName cannot exceed 32 characters (including spaces)</td></tr><tr><td>birthday</td><td>String</td><td>true</td><td>Date of birth. yyyy-MM-dd</td></tr><tr><td>country</td><td>String</td><td>true</td><td>Country/Region Code for bill address. ISO 3166-1 alpha-2<br>Get <a href="../cards#supported-card-bin">Support Card Bin</a> Interface Parameter supportHolderRegin</td></tr><tr><td>town</td><td>String</td><td>true</td><td>City Code for bill address. Get <a href="../../common#city-list">City List</a> Interface Parameter  code</td></tr><tr><td>address</td><td>String</td><td>true</td><td>Address for bill. length[2...40].<br>Can only contain letters, numbers, hyphens and spaces. regex: ^[A-Za-z0-9\- ]+$</td></tr><tr><td>postCode</td><td>String</td><td>true</td><td>Postal code for bill. length[2...15]. <br>regex: ^[a-zA-Z0-9]{1,15}$</td></tr></tbody></table>

</details>

<details>

<summary>cardHolderModel = B2C</summary>

<table><thead><tr><th width="166.233154296875">Param</th><th width="81">Type</th><th width="112.2890625">Required</th><th>Remark</th></tr></thead><tbody><tr><td>cardHolderModel</td><td>String</td><td>true</td><td>Cardholder business model.<br><code>B2C</code></td></tr><tr><td>holderId</td><td>Long</td><td>true</td><td>Holder id</td></tr><tr><td>areaCode</td><td>String</td><td>true</td><td><p>Mobile phone area code. length[2...5].</p><p>Get <a href="../cards#supported-card-bin">Support Card Bin</a> Interface Parameter  supportHolderAreaCode</p></td></tr><tr><td>mobile</td><td>String</td><td>true</td><td>Mobile phone number. length[5...20] </td></tr><tr><td>email</td><td>String</td><td>true</td><td>Email. <strong>Receive verification code</strong>. length[5...50]</td></tr><tr><td>firstName</td><td>String</td><td>true</td><td>First Name. Only English characters are supported. length[2...32]<br>The total length of firstName and lastName cannot exceed 32 characters (including spaces)</td></tr><tr><td>lastName</td><td>String</td><td>true</td><td>Last name. Only English characters are supported. length[2...32].<br>The total length of firstName and lastName cannot exceed 32 characters (including spaces)</td></tr><tr><td>birthday</td><td>String</td><td>true</td><td>Date of birth. yyyy-MM-dd</td></tr><tr><td>nationality</td><td>String</td><td>true</td><td>Nationality Code. ISO 3166-1 alpha-2<br>Get <a href="../cards#supported-card-bin">Support Card Bin</a> Interface Parameter supportHolderRegin</td></tr><tr><td>country</td><td>String</td><td>true</td><td>Country/Region Code for bill address. ISO 3166-1 alpha-2<br>Get <a href="../cards#supported-card-bin">Support Card Bin</a> Interface Parameter supportHolderRegin</td></tr><tr><td>town</td><td>String</td><td>true</td><td>City Code for bill address. Get <a href="../../common#city-list">City List</a> Interface Parameter  code</td></tr><tr><td>address</td><td>String</td><td>true</td><td>Address for bill. length[2...40].<br>Can only contain letters, numbers, hyphens and spaces. regex: ^[A-Za-z0-9\- ]+$</td></tr><tr><td>postCode</td><td>String</td><td>true</td><td>Postal code for bill. length[2...15]. <br>regex: ^[a-zA-Z0-9]{1,15}$</td></tr><tr><td>gender</td><td>String</td><td>true</td><td>Gender. M: male; F: female</td></tr><tr><td>occupation</td><td>String</td><td>true</td><td>Occupation. Get <a href="#cardholder-occupation">cardholder's occupation</a> parameter occupationCode </td></tr><tr><td>annualSalary</td><td>String</td><td>true</td><td>Annual salary. eg: 10000000 USD</td></tr><tr><td>accountPurpose</td><td>String</td><td>true</td><td>Account purpose. Only supports English. eg: Living Expense</td></tr><tr><td>expectedMonthlyVolume</td><td>String</td><td>true</td><td>Expected monthly trading volume. eg: 100000 USD</td></tr><tr><td>idType</td><td>String</td><td>true</td><td>Id type.<br><code>PASSPORT</code>: Passport<br><code>HK_HKID</code>: Hong Kong Identity Card<br><code>DLN</code>: DLN<br><code>GOVERNMENT_ISSUED_ID_CARD</code>: Government-issued ID Card</td></tr><tr><td>idNumber</td><td>String</td><td>true</td><td>Id number. length[2...50]</td></tr><tr><td>issueDate</td><td>String</td><td>true</td><td>ID document issuance date. format: yyyy-MM-dd</td></tr><tr><td>idNoExpiryDate</td><td>String</td><td>true</td><td>The certificate expiration date. format: yyyy-MM-dd</td></tr><tr><td>idFrontId</td><td>String</td><td>true</td><td>Front photo of ID card File ID. Call <a href="../../common#upload-file">upload file</a> interface to get</td></tr><tr><td>idBackId</td><td>String</td><td>true</td><td>Back photo of ID card File ID. Call <a href="../../common#upload-file">upload file</a> interface to get</td></tr><tr><td>idHoldId</td><td>String</td><td>true</td><td>User selfie photo File ID. Call the <a href="../../common#upload-file">upload file</a> interface to obtain</td></tr><tr><td>ipAddress</td><td>String</td><td>true</td><td>IPV4 address.</td></tr></tbody></table>

</details>

**Response**

<table><thead><tr><th width="179.66162109375">Param</th><th width="98">Type</th><th width="115">Required</th><th>Remark</th></tr></thead><tbody><tr><td>holderId</td><td>Long</td><td>true</td><td>Cardholder id</td></tr><tr><td>merchantOrderNo</td><td>String</td><td>false</td><td>Client transaction id</td></tr><tr><td>cardTypeId</td><td>Long</td><td>true</td><td>Card type id</td></tr><tr><td>statusFlowLocation</td><td>String</td><td>true</td><td>Review flow location. <br>Process: Platform review first, then bank review. Update cardholders are supported only when statusFlowLocation=admin and status=reject<br><code>admin</code>: platform review;<br><code>channel</code>: bank review</td></tr><tr><td>status</td><td>String</td><td>true</td><td>Status. <br><code>wait_audit</code>: Pending; <br><code>pass_audit</code>: Approved; <br><code>under_review</code>: In review;<br><code>reject</code>: Rejected</td></tr><tr><td>description</td><td>String</td><td>false</td><td>Description</td></tr><tr><td>respMsg</td><td>String</td><td>false</td><td>remark, equal description. Deprecated will remove</td></tr></tbody></table>

**Example Response**

```json
{
    "success": true,
    "code": 200,
    "msg": "Success",
    "data":
    {
        "holderId": 124024,
        "merchantOrderNo": "114242059249029235245352442",
        "cardTypeId": 124024,
        "statusFlowLocation": "admin",
        "status": "pass_audit",
        "description": "SUCCESS",
        "respMsg": "SUCCESS"
    }
}
```

## Cardholder-List

```
POST /merchant/core/mcb/card/holder/query
```

**Request**

<table><thead><tr><th width="168.48968505859375">Param</th><th width="89">Type</th><th width="88">Required</th><th>Remark</th></tr></thead><tbody><tr><td>pageNum</td><td>Integer</td><td>true</td><td>Current page. Default is 1</td></tr><tr><td>pageSize</td><td>Integer</td><td>true</td><td>Number of pages per page. <br>Maximum 100, default 10</td></tr><tr><td>holderId</td><td>Long</td><td>false</td><td>Holder id</td></tr><tr><td>areaCode</td><td>String</td><td>false</td><td>Mobile area code<br>areaCode and mobile are passed at the same time or not. example: +1</td></tr><tr><td>mobile</td><td>String</td><td>false</td><td>Mobile phone number</td></tr><tr><td>email</td><td>String</td><td>false</td><td>Email</td></tr><tr><td>merchantOrderNo</td><td>String</td><td>false</td><td>Client transaction id</td></tr></tbody></table>

**Response**

<table><thead><tr><th width="172.7122802734375">Param</th><th width="85">Type</th><th width="98">Required</th><th>Remark</th></tr></thead><tbody><tr><td>holderId</td><td>Long</td><td>true</td><td>Cardholder id</td></tr><tr><td>merchantOrderNo</td><td>String</td><td>false</td><td>Client transaction id</td></tr><tr><td>cardTypeId</td><td>Long</td><td>true</td><td>Card type id</td></tr><tr><td>areaCode</td><td>String</td><td>true</td><td>Mobile area code</td></tr><tr><td>mobile</td><td>String</td><td>true</td><td>Mobile number</td></tr><tr><td>email</td><td>String</td><td>true</td><td>Email</td></tr><tr><td>firstName</td><td>String</td><td>true</td><td>First Name</td></tr><tr><td>lastName</td><td>String</td><td>true</td><td>Last name</td></tr><tr><td>birthday</td><td>String</td><td>true</td><td>Date of birth. YYYY-MM-dd</td></tr><tr><td>country</td><td>String</td><td>true</td><td>Country/Region Code. ISO 3166-1 alpha-2</td></tr><tr><td>town</td><td>String</td><td>true</td><td>City code</td></tr><tr><td>address</td><td>String</td><td>true</td><td>address</td></tr><tr><td>postCode</td><td>String</td><td>true</td><td>Postal code</td></tr><tr><td>statusFlowLocation</td><td>String</td><td>true</td><td>Review flow location. Update cardholders are supported only when statusFlowLocation=admin and status=reject<br><code>admin</code>: Wasabi review;<br><code>channel</code>: Bank review</td></tr><tr><td>status</td><td>String</td><td>true</td><td>Status. <br><code>wait_audit</code>: Pending; <br><code>pass_audit</code>: Approved; <br><code>under_review</code>: In review;<br><code>reject</code>: Rejected</td></tr><tr><td>description</td><td>String</td><td>true</td><td>Description</td></tr><tr><td>respMsg</td><td>String</td><td>false</td><td>remark, equal description. Deprecated will remove</td></tr><tr><td>createTime</td><td>Long</td><td>true</td><td>Creation time. Milliseconds</td></tr><tr><td>updateTime</td><td>Long</td><td>true</td><td>Update time. Millisecond timestamp</td></tr></tbody></table>

**Example Response**

```json
{
    "success": true,
    "code": 200,
    "msg": "Success",
    "data":
    {
        "total": 11,
        "records":
        [
            {
                "holderId": 102424,
                "merchantOrderNo": "24353647ksglsan3535",
                "cardTypeId": 102424,
                "areaCode": "+852",
                "mobile": "875692311",
                "email": "test@test.com",
                "firstName": "elly",
                "lastName": "tom",
                "birthday": "1990-10-10",
                "country": "HK",
                "countryStr": "Hong Kong",
                "town": "HK_KKC_1",
                "townStr": "九龙城区",
                "address": "To Kwa Wan, Kowloon, Hong Kong",
                "postCode": "999077",
                "statusFlowLocation": "admin",
                "status": "pass_audit",
                "description": "SUCCESS"
                "respMsg": null,
                "createTime": 232413142131,
                "updateTime": 232413142131
            }
        ]
    }
}
```

<br>