/kyc-status/id-verification

这是用于向合作伙伴发送身份验证状态的回调接口(Webhook)。

状态枚举 (Status)

状态码说明
Created已创建:用户已创建验证会话,但尚未提交信息或完成验证流程。
Expired已过期:验证会话已超时且未完成,用户需要重新发起验证。
Completed已完成:用户已成功完成全部验证流程。

请求示例

所有成功响应均采用统一的JSON结构,并通过 data.status 字段区分具体状态。

1. 状态:已创建 (Created)

{
  "success": true,
  "code": "100000",
  "message": "",
  "data": {
    "status": "Created",
    "uid": "11151"
  }
}

2. 状态:已过期 (Expired)

{
  "success": true,
  "code": "100000",
  "message": "",
  "data": {
    "status": "Expired",
    "uid": "11151"
  }
}

3. 状态:已完成 (Completed)

{
  "success": true,
  "code": "100000",
  "message": "",
  "data": {
    "status": "Completed",
    "uid": "11151"
  }
}

响应字段说明

  • success: 请求是否成功,始终为 true
  • code: 业务状态码,100000 代表成功
  • message: 附加信息,成功时通常为空
  • data.status: 会话的当前状态
  • data.uid: 用户的唯一标识符

提示:当状态为 Expired 时,前端应引导用户重新开始验证流程。

Response
200
Language
LoadingLoading…
Response
Click Try It! to start a request and see the response here!