post
https://sandboxapi.legendtrading.com/v2/app/kyc/individual/idv-share
复用用户已有的 Sumsub 身份验证结果
接口详情
提交一个 Sumsub 一次性 share token，把用户在其他平台已完成的身份验证（IDV）复用到 Legend，用户无需重复拍摄证件与人脸。
完整对接流程见 KYC 集成方案 - 方案三：Sumsub Token Sharing。
前置条件
- 需由 Legend 为您的接入方账号开启 Sumsub Token Sharing 开关，未开启时本接口返回未授权错误。
- 需先调用
POST /kyc/individual/pi创建用户，再提交 share token。 - 用户在 Sumsub 侧的核验等级需满足 Legend recipient level 的要求，否则返回
914023。
返回状态说明
响应外层的 status（success）表示接口调用成功；data[].status 与 data[].review_answer 才是 Sumsub 侧的验证进度与结果。
status | review_answer | 含义 | 对 KYC 流程的影响 |
|---|---|---|---|
init | 空 | 共享资料尚未提交到 Sumsub | 不视为已完成 IDV，用户仍需按常规流程完成身份验证 |
pending、prechecked、queued、awaitingService、onHold | 通常为空 | Sumsub 正在审核 | 视为已提交 IDV，无需重复采集证件；此时还不能通过 KYC |
completed | GREEN | IDV 已通过 | 进入 Legend 后续审批环节 |
completed | RED | IDV 已完成但未通过 | 不会自动批准 |
请以 status 作为流程判断依据；review_answer 仅在 status 为 completed 时才有确定含义，未出结果时可能为 "" 或 null。
GREEN不等于 KYC 通过。 Legend 仍会独立执行合规筛查并结合其余资料做最终审批。用户最终 KYC 结果请以kyc-statusWebhook 或POST /app/kyc-status为准。
幂等与重试
- share token 是一次性的，且有有效期，消费后即失效。
- 同一用户重复调用本接口是幂等的：若该用户已导入过 Sumsub 验证记录，接口直接返回已有结果，不会二次消费 token。
- 同一用户的并发请求会被串行处理，最长等待约 60 秒。请避免对同一
uid并发提交。
错误码
| 错误码 | 含义 | 建议动作 |
|---|---|---|
914020 | share token 无效或已过期 | 重新生成 share token 后重试 |
914023 | 共享的资料不满足 Legend 要求的核验等级 | 与 Legend 确认核验等级要求；该用户可改走其他 KYC 集成方案 |
914015 | Legend 侧调用 Sumsub 失败（网络异常、超时、Sumsub 服务异常等） | 稍后以相同 uid 重试 |