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.
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
address.postal_code*
string(4-8)
The address zip code, or postal code.
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_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?