Upload Supporting Documents

Upon successful creation of an individual cardholder, submit the following KYC materials:

• Valid government ID (Passport/Driver's License/National ID) • Current Proof of Address document

Request URI

POST /issuing/holder/upload-document

Request Body

Refer to : common

Biz_data :

Name	Type	Description
holder_id*	long	holder ID
file_type*	integer	file type,refer to: fileType, Tip: ID and address are required
file_name*	string(5-80)	file name, Supported formats：pdf、jpg、jpeg、png、doc、docx for example:xxx.pdf
file_content*	string	File content .Base64 encoding. Max size: 2M
file_desc	string(128)	file description

Request Example

{
    "app_id": "00000000000000000",
    "partner_id": "00000000000000000",
    "sub_partner_id": "",
    "request_id": "4955b462-EEb3-Ed48-9d66-49346B4C",
    "timestamp": "2025-04-07 13:52:17",
    "format": "JSON",
    "version": "2.0",
    "sign_type": "RSA",
    "biz_data": {
        "holder_id": "103006",
        "file_type": 1,
        "file_name": "test.png",
        "file_content": "iVBORw0KGgoAAAAN......UVORK5CYII=",
        "file_desc": ""
    },
    "random_key": "<generated_key>"
}
// The biz_data in this example needs to be encrypted!

Response

Name	Type	Description
id	long	Document ID

200:OK

{
    "code": "10000",
    "msg": "Success",
    "total": 1,
    "random_key": "<random key used for decryption>",
    "sign_type": "RSA",
    "app_id": "00000000000000000",
    "data": {
        "id": 100666
    }
}
// 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"
}