客户认证信息更新
需要验证签名
接口描述
客户认证KYC信息修改
提示
- KYC审核失败时，用户可用该接口更新KYC材料触发重新审核
- 公司注册或个人所在地,客户类型，不允许更新且更新时需和提交时一致，接口进行一致性验证
- 只有审核拒绝状态才允许更新材料
请求头
| Parameter | Type | Required | Description |
|---|---|---|---|
| Authorization | string | M | access_token |
| Content-Type | string | M | application/json |
请求参数
Request:
| Parameter | Type | Required | Description |
|---|---|---|---|
| client_id | string(64) | M | PP用户唯一ID |
| customer_location | enum | M | 公司注册或个人所在地 【取值请见附录】 |
| customer_type | enum | M | 客户类型 【取值请见附录】 |
| name | string(255) | M | 客户或公司名称 |
| certificate_info_list | array | M | 证件信息列表 |
| handheld_id | string(64) | C | 手持证件照片file_id(和认证结果二选一,客户类型为企业时填法人手持证件照片,个人类型时填个人手持证件照片) |
| face_identification | enum | C | 认证结果(和手持证件照片二选一,客户类型为企业时填法人认证结果,个人类型时填个人认证结果) 目前只支持PASS 【取值请见附录】 |
| legal_person_info | object | C | 法人信息 (客户类型为企业必填) |
| ubo_info_list | array | C | ubo信息（客户类型为企业必填, 需填写持股比例大于等于25%的最终受益人信息） |
| agent_info | object | O | 代理人信息 (客户类型为企业可选填，个人类型无需填写) |
| business_type_list | array | M | 业务类型【取值请见附录】 个人类型只能为ECOMMERCE_PLATFORM |
| extra_info | string(2048) | C | json拓展字段，业务类型为B2B_COMMERCE或SELF_STATION时必填 |
certificate_info_list:
| Parameter | Type | Required | Description |
|---|---|---|---|
| id_front | string(64) | M | 证件人像页file_id或企业证件正面照 |
| id_back | string(64) | C | 证件国徽页file_id(大陆身份证必填) |
| id_type | enum | M | 证件类型【取值请见附录】 |
| id_number | string(64) | M | 证件号码 |
legal_person_info:
| Parameter | Type | Required | Description |
|---|---|---|---|
| nation | enum | M | 国籍(CN:中国大陆 HK:香港等) |
| name | string(255) | M | 法人姓名 |
| id_front | string(64) | M | 证件人像页file_id |
| id_back | string(64) | C | 证件国徽页file_id(大陆身份证必填) |
| id_type | enum | M | 证件类型【取值请见附录】 |
| id_number | string(64) | M | 证件号码 |
ubo_info_list:
| Parameter | Type | Required | Description |
|---|---|---|---|
| nation | enum | M | 国籍(CN:中国大陆 HK:香港等) |
| name | string(255) | M | 受益人姓名 |
| id_front | string(64) | M | 证件人像页file_id |
| id_back | string(64) | C | 证件国徽页file_id(大陆身份证必填) |
| id_type | enum | M | 证件类型【取值请见附录】 |
| id_number | string(64) | M | 证件号码 |
| order_index | Integer(max=4) | M | 股东信息排列序号,从0开始编号递增，不允许重复 |
agent_info:
| Parameter | Type | Required | Description |
|---|---|---|---|
| nation | enum | M | 国籍(CN:中国大陆 HK:香港等) |
| name | string(255) | M | 代理人姓名 |
| id_front | string(64) | M | 证件人像页file_id |
| id_back | string(64) | C | 证件国徽页file_id(大陆身份证必填) |
| id_type | enum | M | 证件类型【取值请见附录】 |
| id_number | string(64) | M | 证件号码 |
| loa | string(64) | M | 企业代理人授权书(先调用上传接口上传授权书) |
extra_info:
| Parameter | Type | Required | Description |
|---|---|---|---|
| main_product | string(64) | M | 主营产品 |
| export_country_list | array | M | 出口国家例如 点击获取 |
| company_url | string(128) | M | 公司网址 |
返回响应
| Parameter | Type | Required | Description |
|---|---|---|---|
| kyc_status | string | M | KYC状态(见附录4) |
返回示例
- 成功
- 失败
{
"code": 200,
"message": "SUCCESS",
"data": {
"kyc_status": "PENDING"
}
}
{
"code": 901010,
"message": "user not exist",
"data": null
}
错误码
| 返回码 | 描述 | 解决方案 |
|---|---|---|
| 900000 | system error | 系统错误，请联系PingPong技术人员核查 |
| 900002 | illegal param | 参数有误，请根据提示更正信息 |
| 911004 | kyc not exist | 该客户无KYC提交记录，请先提交KYC信息 |
| 911005 | material auditing can not submit | 材料审核中不允许提交 |
附录
card_type【证件类型】
| 值 | 描述 | 个人/企业 |
|---|---|---|
| CN_IDENTITY_CARD | 大陆身份证 | 个人 |
| HK_ID_CARD | 香港身份证 | 个人 |
| PASSPORT | 护照 | 个人 |
| RESIDENCE_PERMIT | 港澳台居住证 | 个人 |
| MAINLAND_TRAVEL_PERMIT | 大陆通行证 | 个人 |
| HK_BUSINESS_LICENCE | 商业登记证 | 香港企业必填 |
| COI | 公司注册说明书 | 香港企业必填 |
| BUSINESS_LICENCE | 营业执照影印件 | 大陆企业必填 |
customer_location【客户所在地】
| 值 | 描述 |
|---|---|
| CN | 中国大陆 |
| HK | 香港 |
customer_type【客户类型】
| 值 | 描述 |
|---|---|
| ENTERPRISE | 企业 |
| INDIVIDUAL | 个人 |
kyc_status【审核状态】
| 值 | 描述 |
|---|---|
| PENDING | 待审核 |
| APPROVED | 审核通过 |
| DECLINED | 审核拒绝 |
business_type【业务类型】
| 值 | 描述 |
|---|---|
| B2B_COMMERCE | 一般贸易 |
| ECOMMERCE_PLATFORM | 电商平台 |
| SELF_STATION | 独立站 |
face_identification【认证结果】
| 值 | 描述 |
|---|---|
| PASS | 通过 |