2.1.28 Binding KYC
Path:/openapi/card/binding/kyc
Method:POST
Content-Type:application/json
Response Content-Type:application/json
Description:
Example Request:
{
"mc_trade_no": "48d2741747a4493223feb22",
"base_info": {
"email": "example@gmail.com",
"first_name": "pan",
"last_name": "gao",
"mobile": "1888888888",
"mobile_code": "86",
"user_ip": "40.77.166.66"
},
"kyc_info": {
"address": "maizidianjie28hao",
"back_doc": "",
"birthday": "1990-01-01",
"city": "beijing",
"country_id": "CN",
"doc_no": 12345678,
"doc_type": 1,
"emergency_contact": "John",
"front_doc": "",
"gender": 1,
"mix_doc": "",
"nationality_id": "CN",
"sign_img": "",
"state": "beijing",
"zip_code": "100100",
"poa_doc": "",
"poa_type": "1"
}
}
Request Parameter:
Parameter Name | Type | Required | Description |
---|---|---|---|
mc_trade_no | string | true | The Transaction number passed when calling the card binding interface. |
base_info | object | true | User Base Info |
string | true | Email;Maximum 64 characters. | |
first_name | string | true | First name;Maximum 50 characters |
last_name | string | true | Last name;Maximum 50 characters |
mobile | string | true | Mobile no;Minimum 6 characters and Maximum 11 characters |
mobile_code | string | true | Mobile no country code;Maximum 5 characters |
user_ip | string | false | User IP Address |
kyc_info | object | true | User KYC Info |
address | string | true | Mailing address,Card will sending to this address;Maximum 256 characters; By default, the regular expression must be met:323_address_regex's Default regex . If card_type_id is in the range [71000003,71000002], the regular expression must be met: 323_address_regex's 71000003,71000002 regex |
back_doc | string | false | Photo of back document;Encoded into bas64 format. The size of this field should be less than 2MB. Support:jpg,jpeg,png |
birthday | string | true | Date of birth, format: yyyy-MM-dd |
city | string | true | City;Maximum 100 characters |
country_id | string | true | Country ID,Refer to the appendix【3.2 Mobile Phone Area Code and Country Code】-【ISO 3166 alpha2】for the range of values;If Retrive merchant card list response kyc_country_limit_short column is not empty, Then the value of this field must be within thekyc_country_limit_short field range |
doc_no | string | true | Document no;Maximum 128 characters |
doc_type | integer | true | Document type;1 Passport 2 Identity no (Currently we only support Passport) |
emergency_contact | string | true | Emergency contact person;Maximum 255 characters |
front_doc | string | true | Photo of front document;Encoded into base64 format. The size of this field should be less than 2MB. Support:jpg,jpeg,png |
gender | integer | true | Gender:1 Male; 2 Female |
mix_doc | string | true | Photo of user with holding the ID/Passport;Encoded into base64 format. The size of this field should be less than 2MB. Support:jpg,jpeg,png |
nationality_id | string | true | Nationality ID,Refer to the appendix【3.2 Mobile Phone Area Code and Country Code】-【ISO 3166 alpha2】for the range of values |
sign_img | string | true | Photo of signature;Encoded into base64 format. The size of this field should be less than 1 MB. Support:jpg,jpeg,png |
state | string | true | State;Maximum 100 characters |
zip_code | string | true | Postal Code;Maximum 20 characters Same set as mobile no country code |
poa_doc | string | false | Proof of address doc;Encoded into base64 format. The size of this field should be less than 2MB. Support:jpg,jpeg,png,pdf;If the 2.1.37 Retrive merchant card list-v5 api need_poa is 1, you can use this field supply poa doc |
poa_type | integer | false | Proof of address type;1 Self-service provision 2 Assist with certification;If this value is 1, the poa_doc must not empty |
API Response:
Parameter Name | Type | Description |
---|---|---|
code | string | Error code |
msg | string | Error message |
Example Response:
{
"code": "00000",
"msg": "ok"
}