客户认证信息查询
需要验证签名
接口描述
客户认证信息查询。
提示
- 该接口用于用户主动查询KYC审核状态
请求头
| Parameter | Type | Required | Description |
|---|---|---|---|
| Authorization | string | M | access_token |
| Content-Type | string | M | application/json |
请求参数
| Parameter | Type | Required | Description |
|---|---|---|---|
| client_id | string(64) | M | pp用户唯一标志 |
返回响应
| Parameter | Type | Required | Description |
|---|---|---|---|
| client_id | string | M | 用户id |
| string | M | 邮箱 | |
| user_status | string | M | 用户状态(见附录1) |
| create_time | long | M | 注册时间(时间戳) |
| kyc_status | string | M | KYC状态(见附录2) |
| approve_start_time | long | M | 认证开始时间(时间戳) |
| approve_end_time | long | C | 认证结束时间(时间戳,KYC审核通过存在) |
| name | string | M | 企业或个人中文名称 |
| full_name_en | string | C | 企业或个人英文名称(KYC审核通过存在) |
| legal_person_info | object | C | 法人信息(客户类型为企业存在) |
| ubo_info_list | array | C | ubo信息(客户类型为企业存在) |
legal_person_info:
| Parameter | Type | Required | Description |
|---|---|---|---|
| name | string | M | 法人中文名称 |
| full_name_en | string | C | 法人英文名称(KYC审核通过存在) |
ubo_info_list:
| Parameter | Type | Required | Description |
|---|---|---|---|
| name | string | M | 股东中文名称 |
| full_name_en | string | C | 股东英文名称(KYC审核通过存在) |
返回示例
- 成功
- 失败
{
"success": true,
"code": 200,
"message": "SUCCESS",
"data": {
"email": "412339993@qq.com",
"name": "x进出口有限公司",
"client_id": "IT8623122906790717412",
"user_status": "AVAILABLE",
"create_time": "1703833125000",
"kyc_status": "APPROVED",
"approve_start_time": "1703833510000",
"approve_end_time": "1703834653000",
"full_name_en": "Trading Co., Ltd.",
"legal_person_info": {
"name": "张三",
"full_name_en": "Zhang San"
},
"ubo_info_list": [
{
"name": "李四",
"full_name_en": "Li Si"
}
]
}
}
{
"code": 901010,
"message": "user not exist",
"data": null
}
错误码
| 返回码 | 描述 | 解决方案 |
|---|---|---|
| 900000 | system error | 系统错误，请联系PingPong技术人员核查 |
| 900002 | illegal param | 参数有误，请根据提示更正信息 |
| 910001 | user not exist | 检查client_id |
附录
1、用户注册状态
| 值 | 描述 |
|---|---|
| AVAILABLE | 正常 |
2、kyc状态
| 值 | 描述 |
|---|---|
| PENDING | 待审核 |
| APPROVED | 审核通过 |
| DECLINED | 审核拒绝 |