个人用户一键开通法币交易

我们提供灵活的集成方案，帮助您平台的用户快速完成 KYC 流程，快速开启法币与加密货币交易。

方案一：API 全流程同步（适用于资料齐全的用户）

如果您能够一次性收集用户所需的完整资料，可通过调用 Legend 的 API 直接完成 KYC 信息同步与提交。

API 调用流程：

1. 提交个人基本信息：调用 POST /kyc/individual/pi
2. 获取问卷题目：调用 GET /kyc/individual/qa
3. 提交问卷答案：调用 POST /kyc/individual/qa
4. 上传证明文件：调用 POST /kyc/individual/file
5. 提交 KYC 申请：调用 POST /kyc/individual/submit

方案二：API + SDK v2 集成（包含完整的 IDV + PoA 重试流程, 提升通过率）

这里优化了 IDV 与 PoA 的验证流程, 增加了基于 GPS 的 PoA 验证, 实时响应审核结果, 用户可以立刻重试.

API 调用流程：

1. 提交个人基本信息：调用 POST /kyc/individual/pi
   1. 必须传递参数 kyc_flow ，且kyc_flow=kyc_sdk_v2；
2. 【可选】上传 ID 证明文件：调用 POST /kyc/individual/file
   1. 如果这步跳过，那么我们会在下面的SDK中让用户上传ID 证明文件；
   2. 如果在这里上传了ID文件，我们会进行校验。如果校验通过，下面的 SDK就不会再让用户上传ID。只有校验失败，才会在下面的SDK中让用户重新上传ID 证明文件；
   3. 建议：优先上传 ID 证明文件，提前进入 IDV 审核流程，提升用户体验；
   4. 注意：上传完所有 ID 文件后，就会进入 IDV 审核流程，不再接受后续新上传的 ID 文件。
3. 获取问卷题目：调用 GET /kyc/individual/qa
4. 提交问卷答案：调用 POST /kyc/individual/qa
5. 续填SDK获取 KYC Connect SDK v2 URL：调用 POST /kyc/individual/sdk/url

   1. 在前端页面通过 iframe 打开获取的 URL；

      注意：建议在 iframe 配置 allow="camera; geolocation"。其中 camera 用于用户完成 IDV 证件拍摄和人脸验证，geolocation 用于 GPS PoA 地址验证。若未授权对应权限，浏览器会阻止 iframe 内的 SDK 调用摄像头或定位能力，用户可能无法完成 IDV 或 GPS PoA，并需要重新打开页面或改走文件 PoA 流程。

      HTML

      <iframe
        src="https://otc.legendtrading.com/v2/kyc/s/dyaWAV2H3KN9t4EiftMUixVeeUWzBY0s"
        allow="camera; geolocation"
      ></iframe>

   2. 用户完成剩余 KYC 流程， 完成后会自动 submit KYC；您不需要主动调用/app/submit API。用户 submit KYC后，我们会发送/kyc-status webhook通知您。

   3. 注意 URL 有效期是24小时， 过期需要重新申请。

   4. 我们在这里详细介绍了 SDK 事件与前端接入。 推荐前端同事阅读。

实时获取 KYC 审核状态

您可以通过以下方式实时追踪用户的 KYC 进度：

• 主动查询（轮询）：调用 POST /app/kyc-status API。
• 被动接收（推荐）：实现 kyc-status Webhook 回调接口。当用户的 KYC 状态变更时（例如：审核中→已通过），Legend 系统将自动推送通知至您配置的地址。

获取支持的国家/地区列表

在引导用户注册前，建议先调用 GET /countries API，获取 Legend 支持的服务区域及合规限制地区，以便进行前期地域筛选。

简洁要点：

• 全资料用户：API 同步
• 部分资料用户：API + SDK 混合
• 状态获取：支持轮询与 Webhook
• 地域合规：先查列表再引导