跳转到内容

查询用户 KYC 状态 ​

GET /openapi/v2/users/kyc/status
项内容
请求方法GET
请求路径/openapi/v2/users/kyc/status
请求类型query

请求参数:

字段类型必填说明
emailstring是用户邮箱。
cardTypeIdstring是卡类型 ID。

响应 data:同提交用户 KYC。

本接口查询审核状态。修改资料并补件前,请先查询 KYC 补件信息,获取 allowed、originalRecordNo、expectedVersion 和锁定字段;不能仅凭审核状态组装补件请求。

各渠道认证状态 ​

除提交响应中的字段外,仅本查询增加 channelKycStatuses。

字段类型说明
channelKycStatusesarray各渠道本地认证状态,不触发实时渠道同步。
channelKycStatuses[].providerNamestringCPS、PHY;未配置别名时为 UNKNOWN。不依赖数组顺序。
channelKycStatuses[].channelStatusstringNOT_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 公共响应。