KYC Connect 一键开通账号

个人用户一键开通法币交易的整体流程：

flowchart TD
    A[检查用户KYC状态] --> B{用户已完成KYC?}
    B -- 是 --> C[用户可直接交易]
    B -- 否 --> D[KYC Connect]
    D --> E{信息是否完整?}
    E -- 否 --> F[加载KYC续填SDK<br>用户补充信息]
    F --> E
    E -- 是 --> G[提交KYC表单]
    G --> H[KYC审批流程]
    H --> I[审批通过]
    H --> J[等待审批]
    H --> K[无法提供服务]

KYC Connect

如果交易所能够收集到用户的全部资料，可以直接调用 API 与 Legend 同步用户信息：

1. 调用 /kyc/individual/pi 提交用户基本信息
2. 调用 GET /kyc/individual/qa 获取问卷内容
3. 调用 POST /kyc/individual/qa 提交问卷
4. 调用 /kyc/individual/file 提交所需文件
5. 调用 /kyc/individual/submit 提交 KYC 表单

对于 EU 个人账户，还需提供下文的税号——可在调用 /kyc/individual/pi 时一并传入，也可通过其独立接口提交。

加载 KYC 续填 SDK

如果交易所只能收集到用户的部分资料，可以先通过 KYC Connect API 传递已有字段，再加载 KYC 续填 SDK，让用户直接在 Legend 侧补充剩余信息。

获取 SDK URL 见 /kyc/individual/sdk/url；前端接入细节见 SDK 事件与前端接入。

简化提交模式（Mini PI）

当您的平台只掌握极少量用户资料时，Legend 可以为您的账户开通一种简化提交模式——接口与文档中称为 Mini PI（mini pi）。开通后，您对 /kyc/individual/pi 的调用会从标准规则切换为简化规则：

• 仅 uid 与 email 为必填；其余字段（含 country_iso2_code）全部变为选填。
• 选填字段一旦传入仍会校验，因此格式错误的值照样会被拒绝，而不传该字段没有问题。请整体省略字段，不要传显式的 null。
• 剩余信息随后通过 KYC 续填 SDK 向用户收集，见上一节。

标准模式与简化模式的逐字段对照，见 /kyc/individual/pi 页面的参数表。

收集税号（TIN）

Legend 会向账户区域为 EU 的个人用户收集税号（TIN）。这是税务报送要求，判定依据是账户本身而非单次请求传入的国家，因此 EU 区域的账户无论传入哪个国家都必须提供。

• 适用对象：仅 EU 个人账户。Non-EU 账户与企业（KYB）账户不会被要求提供税号。
• 收集入口：共四个——/kyc/individual/pi（选填字段）、独立的 /kyc/individual/tin 接口、RFI 流程（见 RFI 集成），以及 KYC 续填 SDK。四个入口读写同一份数据。
• 格式：6–20 个字符的字符串；须保留前导零，不要当作数字传递。
• 只写：任何查询接口都不会返回明文税号，一律以 ****** 返回。
• 提交限制：EU 个人账户没有税号时，/kyc/individual/submit 会拒绝提交并在 uncompleted_fields 中列出 tin。
• 已通过 KYC 的账户可通过 /kyc/individual/tin（或 SDK 的税号步骤）补交，不会重置 KYC 审核。

复用已有的 Sumsub 身份验证

如果用户已经在使用 Sumsub 的平台完成过身份验证（IDV），交易所可以生成一次性 share token 并调用 /kyc/individual/idv-share 把结果共享给 Legend，用户无需重复拍摄证件与人脸。

前置配置与完整调用顺序见 KYC 集成方案 的方案三。

如何获得用户 KYC 状态

• 方案 1（主动查询）：调用 /kyc-status API 查看用户在 Legend 的 KYC 状态。
• 方案 2（被动接收）：实现 kyc-status webhook，Legend 会在用户 KYC 状态变更时主动推送。

获得 Legend 支持的国家列表

调用 /countries API 获取 Legend 支持或禁止的国家列表。

相关文档

• KYC 流程说明
• KYC 集成方案
• SDK 事件与前端接入