post
https://exchange.com/api/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: 请求是否成功,始终为truecode: 业务状态码,100000代表成功message: 附加信息,成功时通常为空data.status: 会话的当前状态data.uid: 用户的唯一标识符
提示:当状态为
Expired时,前端应引导用户重新开始验证流程。
200