post
https://exchange.com/api/kyc-status
KYC状态通知
用户提交KYC表单，或者Legendtrading审批/拒绝用户时，都会调用这个API来通知交易所用户KYC状态。此API为可选，交易所可以选择是否希望收到用户KYC状态。
KYC 状态流转说明
| 阶段 | 用户/Legend 操作 | 系统状态 (KYC status) |
|---|---|---|
| 开始申请 | 用户输入邮箱，进入KYC流程 | Started（已开始） |
| 填写信息 | 用户填写完所有必填的KYC信息 | In Progress（填写中） |
| 提交申请 | 用户正式提交KYC申请表 | Submitted（已提交） |
| 自动审核 | 系统判断是否符合自动批准条件 | Approved（已审批） ⬅ (若自动审批) |
| 人工审核 | 未自动批准，转入Legend人工审核 （此过程中可能要求补充信息-RFI/EDD） | In Review（审核中） / Escalated （已升级） |
| 审核完成 | Legend 完成审核 | Approved（已批准） ⬅ (若人工批准) |
| 审核完成 | Legend 完成审核 | Rejected（已拒绝） ⬅ (若审核不通过) |
核心状态节点解释：
- Submitted（已提交）：用户已完成信息填写并提交，申请进入审核队列。
- In Review / Escalated（审核中/已升级）：审核员正在处理，必要时会触发 RFI（信息请求） 或 EDD（增强尽职调查）。
- Approved（已批准）：用户通过审核，可正常使用平台服务。
- Rejected（已拒绝）：用户未通过审核，账户权限将受到限制。
流程图如下：
请求参数说明
| 参数名 | 类型 | 必传 | 说明 |
|---|---|---|---|
user_id | string | 是 | 加密后的用户唯一标识符 |
first_name | string | 是 | 用户的名字 |
middle_name | string | 否 | 用户的中间名（可选） |
last_name | string | 是 | 用户的姓氏 |
email | string | 否 | 用户的邮箱地址 |
country | string | 否 | 用户所在国家 |
kyc_status | string | 是 | KYC 状态。可选值：not_started（未开始）started（已开始）in_progress（填写中）submitted（已提交）in_review（审核中）escalated（已升级）approved（已批准）rejected（已拒绝） |
reject_reason | string | 否 | 拒绝原因（仅在 KYC 状态为 rejected 时适用）。可选值：High risk user（高风险用户）High risk country / region / state（高风险国家/地区/州）Lack of important documents（缺少重要文件）Identity verification failed（身份验证失败）Invalid questionnaire information（问卷信息无效）Per user's request（应用户要求）Other（其他）Access IP Risk Prohibited（访问 IP 风险禁止）Resident Risk Prohibited（居民风险禁止）ID Country Risk Prohibited（证件国风险禁止）Age under 18（年龄未满 18 岁） |
推送数据示例
{
"user_id": "417ubQ==",
"first_name": "I******S",
"last_name": "B******S",
"email": "i******[email protected]",
"reject_reason": null,
"kyc_status": "approved",
"country": "Latvia"
}