Query Cardholder
Retrieve cardholder details by providing either a holder_id or a combination of id_no and id_type.
Request URI
POST
/issuing/holder/query
Request Body
Refer to : common
Biz_data :
holder_id
long
Cardholder ID.
id_no
string
ID number.
id_type
integer
ID type
Request Example
{
"app_id": "00000000000000000",
"partner_id": "00000000000000000",
"sub_partner_id": "",
"request_id": "766b69FD-2aEb-bf71-cee8-e8eBbBeb",
"timestamp": "2025-04-07 13:52:15",
"format": "JSON",
"version": "2.0",
"sign_type": "RSA",
"biz_data": {
"holder_id": "103006"
},
"random_key": "<generated_key>"
}
// The biz_data in this example needs to be encrypted!
Response
holder_id
long
Cardholder ID
mobile
string
Mobile
first_name
string
First name
last_name
string
Last name
id_no
string
ID number.
id_type
integer
ID type
issuance_date
string
Issuance date
expires_on
string
Expires on
string
birthday
string
Birthday
gender
integer
Gender
nationality_code
string
Nationality code
status
integer
Status : 0-initial 1-enabled 2-disabled
address.city_name
string
City Name
address.country_code
string
Country Code
address.postal_code
string
Postal Code
address.state
string
State
address.line
string
Line
address.line2
string
Line2
{
"code": "10000",
"msg": "Success",
"total": 1,
"random_key": "<random key used for decryption>",
"sign_type": "RSA",
"app_id": "00000000000000000",
"data": {
"holder_id": 103006,
"mobile": "+8618197431263",
"first_name": "Test",
"last_name": "User",
"id_no": "51f635df-d206-449c",
"id_type": 1,
"issuance_date": "2024-07-21",
"expires_on": "2030-07-24",
"email": "[email protected]",
"birthday": "1990-11-08",
"gender": 1,
"nationality_code": "BR",
"address": {
"address_id": 104342,
"city_id": null,
"city_name": "beijing",
"country_code": "BR",
"postal_code": "045675",
"state": "proident enim",
"line": "Wivjq Njutsfd Hiqouxlbs Uhdt Gtjpzy",
"line2": "Ebtorcbaq Enojuvm Ikw Xvlgum Wibq U"
},
"audit_status": 3,
"status": 0
}
}
// The data in this example has already been decrypted.
Last updated
Was this helpful?