查询用户 KYC 状态
GET/openapi/v2/users/kyc/status| 项 | 内容 |
|---|---|
| 请求方法 | GET |
| 请求路径 | /openapi/v2/users/kyc/status |
| 请求类型 | query |
请求参数:
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
email | string | 是 | 用户邮箱。 |
cardTypeId | string | 是 | 卡类型 ID。 |
响应 data:同提交用户 KYC。
本接口查询审核状态。修改资料并补件前,请先查询 KYC 补件信息,获取 allowed、originalRecordNo、expectedVersion 和锁定字段;不能仅凭审核状态组装补件请求。
各渠道认证状态
除提交响应中的字段外,仅本查询增加 channelKycStatuses。
| 字段 | 类型 | 说明 |
|---|---|---|
channelKycStatuses | array | 各渠道本地认证状态,不触发实时渠道同步。 |
channelKycStatuses[].providerName | string | CPS、PHY;未配置别名时为 UNKNOWN。不依赖数组顺序。 |
channelKycStatuses[].channelStatus | string | NOT_SUBMITTED、PENDING_APPROVAL、APPROVED、REJECTED、MODIFY、CERT_REQUIRED。 |
status 是用户总体状态;channelStatus / subStatus 对应 cardTypeId 所属渠道。各渠道必须独立判断,总体通过不代表所有渠道通过。未受理或受理未知的尝试不覆盖更早已确认的状态;数组内历史 PENDING 归一为 PENDING_APPROVAL。V2 提交和 V1 响应不返回此数组。
json
{
"status": "APPROVED",
"channelStatus": "PENDING_APPROVAL",
"submissionStatus": null,
"channelKycStatuses": [
{
"providerName": "CPS",
"channelStatus": "APPROVED"
},
{
"providerName": "PHY",
"channelStatus": "PENDING_APPROVAL"
}
]
}参数校验错误见 V2 公共响应。
