Create Cardholder

Create a new individual cardholder that can issue cards.

Request URI

POST /issuing/holder/create

Request Body

Refer to : common

Biz_data :

Name
Type
Description

mobile*

string(16)

The whole mobile phone number.

Need to add an international area code

first_name*

string(50)

First name.

last_name*

string(50)

Last name.

id_no*

string(6-20)

ID number.

id_type*

integer

issuance_date

string

Issuance date.Format:yyyy-MM-dd

expires_on

string

Expires On. Format:yyyy-MM-dd

email*

string

Business emailEmails are validated against the rfc6530 standard.

birthday*

string

Date of Birth.Format:yyyy-MM-dd

gender

integer

nationality_code*

string(2)

Nationality Country.Refer to CountryCode

address.line*

string(12-128)

The first line of the address.

Format:CHARSETS_4

address.line2

string(128)

The second line of the address.

Format:CHARSETS_4

address.postal_code*

string(4-8)

The address zip code, or postal code.

address.city_name*

string(4-80)

The address city.Format:CHARSETS_6

address.state*

string(4-48)

The address state.Format:CHARSETS_6

address.country_code*

string(2)

The two-letter ISO country code of the address,

Refer to CountryCode

Request Example

{
    "app_id": "00000000000000000",
    "partner_id": "00000000000000000",
    "sub_partner_id": "",
    "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": "[email protected]",
        "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!

Response

Name
Type
Description

holder_id

long

Cardholder ID.

id_no

string

ID Number.

audit_status

integer

Audit Status.Refer to:CustomerAuditStatus

audit_msg

string

Audit Message

{
    "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.

Last updated

Was this helpful?