Update Cardholder

Updates the specified individual cardholder by setting the values of the parameters passed.

Request URI

POST /issuing/holder/update

Request Body

Refer to : common

Biz_data ：

Name	Type	Description
holder_id	long	Cardholder ID.
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	Type of certificate.
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	Gender.
nationality_code*	string(2)	Nationality. Country code.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": "dcB88bc9-b6bc-26B8-b4c9-AF9cED1B",
    "timestamp": "2025-04-07 13:52:14",
    "format": "JSON",
    "version": "2.0",
    "sign_type": "RSA",
    "biz_data": {
        "holder_id": 103006,
        "mobile": "[phone]",
        "first_name": "Test",
        "last_name": "User",
        "id_no": "51f635df-d206-449c",
        "id_type": 1,
        "email": "[e-mail]",
        "birthday": "1990-11-08",
        "gender": 1,
        "issuance_date": "2024-07-21",
        "expires_on": "2030-07-24",
        "nationality_code": "BR",
        "address": {
            "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"
        }
    },
    "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.
id_type	string	Type of certificate.
audit_status	integer	Audit status, refer to:CustomerAuditStatus

200:OK

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

400: invalid-signature

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