用户提交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******b@inbox.lv",
  "reject_reason": null,
  "kyc_status": "approved",
  "country": "Latvia"
}

200200

400400