# Create Cardholder

### **Request URI** <a href="#payin-by-creditcard" id="payin-by-creditcard"></a>

`POST` `/issuing/holder/create`

### **Request Body**

&#x20;**Refer to :** [**common**](https://docs.pagsmile.com/issuing-card-api/common)

&#x20;**Biz\_data :**

<table><thead><tr><th width="225.94140625">Name</th><th width="133.1875">Type</th><th>Description</th></tr></thead><tbody><tr><td>mobile<mark style="color:red;">*</mark></td><td>string(16)</td><td><p>The whole mobile phone number.</p><p>Need to add an international area code</p></td></tr><tr><td>first_name<mark style="color:red;">*</mark></td><td>string(50)</td><td>First name.</td></tr><tr><td>last_name<mark style="color:red;">*</mark></td><td>string(50)</td><td>Last name.</td></tr><tr><td>id_no<mark style="color:red;">*</mark></td><td>string(6-20)</td><td>ID number.</td></tr><tr><td>id_type<mark style="color:red;">*</mark></td><td>integer</td><td><a href="../../data/dictionary-item/idtype">Type of certificate.</a></td></tr><tr><td>issuance_date</td><td>string</td><td>Issuance date.Format:yyyy-MM-dd</td></tr><tr><td>expires_on</td><td>string</td><td>Expires On. Format:yyyy-MM-dd</td></tr><tr><td>email<mark style="color:red;">*</mark></td><td>string</td><td>Business emailEmails are validated against the rfc6530 standard.</td></tr><tr><td>birthday<mark style="color:red;">*</mark></td><td>string</td><td>Date of Birth.Format:yyyy-MM-dd</td></tr><tr><td>gender</td><td>integer</td><td><a href="../../data/dictionary-item/gender">Gender</a></td></tr><tr><td>nationality_code<mark style="color:red;">*</mark></td><td><p>string(2)</p><p></p></td><td>Nationality Country.Refer  to <a href="../../data/dictionary-item/countrycode">CountryCode</a></td></tr><tr><td>address.line<mark style="color:red;">*</mark></td><td>string(12-128)</td><td><p>The first line of the address.</p><p>Format:<a href="../../data/dictionary-item/charsets">CHARSETS_4</a></p></td></tr><tr><td>address.line2</td><td>string(128)</td><td><p>The second line of the address.</p><p>Format:<a href="../../data/dictionary-item/charsets">CHARSETS_4</a></p></td></tr><tr><td>address.postal_code<mark style="color:red;">*</mark></td><td>string(4-8)</td><td>The address zip code, or postal code.</td></tr><tr><td>address.city_name<mark style="color:red;">*</mark></td><td>string(4-80)</td><td>The address city.Format:<a href="../../data/dictionary-item/charsets">CHARSETS_</a><a href="../../data/dictionary-item/charsets">6</a></td></tr><tr><td>address.state<mark style="color:red;">*</mark></td><td>string(4-48)</td><td>The address state.Format:<a href="../../data/dictionary-item/charsets">CHARSETS_</a><a href="../../data/dictionary-item/charsets">6</a></td></tr><tr><td>address.country_code<mark style="color:red;">*</mark></td><td>string(2)</td><td><p>The two-letter ISO country code of the address,</p><p>Refer  to <a href="../../data/dictionary-item/countrycode">CountryCode</a></p></td></tr></tbody></table>

### **Request** Example <a href="#example" id="example"></a>

{% code fullWidth="true" %}

```
{
    "app_id": "00000000000000000",
    "partner_id": "00000000000000000",
    "request_id": "D27c4C4b-96AC-BefF-A860-64297d9e",
    "timestamp": "2025-04-07 13:52:13",
    "format": "JSON",
    "version": "2.0",
    "sign_type": "RSA",
    "biz_data": {
        "mobile": "+86111111111111",
        "first_name": "Test",
        "last_name": "User",
        "id_no": "9acaa4ab-04db-46da",
        "id_type": 1,
        "email": "o.tqsruvf@laotepzuui.ro",
        "birthday": "1990-11-08",
        "gender": 1,
        "issuance_date": "2024-07-21",
        "expires_on": "2030-07-24",
        "nationality_code": "HK",
        "address": {
            "city_name": "hongkong",
            "country_code": "HK",
            "postal_code": "867742",
            "state": "proident enim",
            "line": "Nfxkudtt Rqvxaobt Zhzx Nfpmnekw Xqb",
            "line2": "Daystnd Eptudtvwbn Ogvr Cqdld Yypod"
        }
    },
    "random_key": "<generated_key>"
}
// The biz_data in this example needs to be encrypted!
```

{% endcode %}

### Response <a href="#example" id="example"></a>

<table><thead><tr><th width="177.16015625">Name</th><th width="187.25390625">Type</th><th>Description</th></tr></thead><tbody><tr><td>holder_id</td><td>long</td><td>Cardholder ID.</td></tr><tr><td>id_no</td><td>string</td><td>ID Number.</td></tr><tr><td>id_type</td><td>string</td><td><a href="../../data/dictionary-item/idtype">Type of certificate.</a></td></tr><tr><td>audit_status</td><td>integer</td><td>Audit Status.Refer to:<a href="../../data/dictionary-item/customerauditstatus">CustomerAuditStatus</a></td></tr><tr><td>audit_msg</td><td>string</td><td>Audit Message</td></tr></tbody></table>

{% tabs %}
{% tab title="200:OK" %}

```
{
    "code": "10000",
    "msg": "Success",
    "total": 1,
    "random_key": "<random key used for decryption>",
    "sign_type": "RSA",
    "app_id": "00000000000000000",
    "data": {
        "holder_id": 103006,
        "id_no": "9acaa4ab-04db-46da",
        "id_type": 1,
        "audit_status": 3,
        "audit_msg": null
    }
}
// The data in this example has already been decrypted.
```

{% endtab %}

{% tab title="400: invalid-signature" %}

```
{
    "code": "40002",
    "msg": "Business Failed",
    "sub_code": "invalid-signature",
    "sub_msg": "invalid signature"
}
```

{% endtab %}
{% endtabs %}