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 :

Name	Type	Description
holder_id	long	Cardholder ID.
id_no	string	ID number.
id_type	integer	ID type

Choose one of field holder_id and field (id_no,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

Name	Type	Description
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
email	string	Email
birthday	string	Birthday
gender	integer	Gender
nationality_code	string	Nationality code
status	integer	Status : 0-initial 1-enabled 2-disabled
audit_status	integer	Audit Status.Refer toCustomerAuditStatus
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

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,
        "mobile": "[phone]",
        "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": "[e-mail]",
        "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.

400: invalid-signature

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