post
https://sandboxapi.legendtrading.com/v2/app/kyc/individual/pi
接口详情
- 提交个人基本信息
业务规则
- 信息更新：在最终 提交KYC申请 之前，可多次调用此接口以更新用户信息。
- 国家代码：标准模式下
country_iso2_code为必填项，该字段是合规性筛查的关键依据。请使用 ISO 3166-1 alpha-2 标准代码，您也可通过 获取国家列表 API 查询。 mini pi类型特殊规则：Mini PI 模式由 Legend 按合作伙伴账户开通——请联系您的 Legend 对接人开启；开通后，您账户对/kyc/individual/pi的调用即按简化规则校验。该模式下仅uid和email为必填字段；其他字段（含country_iso2_code）均为可选，但若传入则必须通过其对应的有效性校验。
UI参考
两种提交模式参数说明
1. 标准模式（普通KYC）
所有标记为"必填"的字段都必须提供，系统会进行严格验证。
2. 简化模式（Mini PI）
仅 uid 和 email 为必填字段；其他字段（含 country_iso2_code）均为选填。适用于交易所仅掌握用户部分资料的快速注册场景。该模式由 Legend 按合作伙伴账户开通。
字段要求对比表
| 字段 | 标准模式 | 简化模式 | 格式要求 |
|---|---|---|---|
| uid | 必填 | 必填 | 字符串 |
| first_name | 必填 | 选填 | 字符串，符合姓名规则 |
| last_name | 必填 | 选填 | 字符串，符合姓名规则. 对于特殊的国家，例如马来西亚，没有last_name，可以firstname 和 last name都传成一样 |
| middle_name | 选填 | 选填 | 字符串 |
| 必填 | 必填 | • 有效邮箱地址 • 最大80字符 • 禁止 .ru 后缀邮箱 | |
| birthdate | 必填 | 选填 | • 格式：YYYY-MM-DD• 年满18周岁 |
| country_iso2_code | 必填 | 选填 | • 2位国家代码（如：US, GB） • 必须在有效国家列表内 注意：我们会根据 country_iso2_code 判断用户属于EU 还是Non-EU。这个字段一旦填写后，不可更改。 |
| state | 必填 | 选填 | • 字符串 • 美国用户：必须正确州名，可以是iso2_code 或者英文全称，例如： NY 或者New York 都认为正确的州名。 |
| city | 必填 | 选填 | 字符串 |
| address | 必填 | 选填 | • 字符串 ，不能包含下划线和@符号 • 长度10-255字符 • 有效地址格式 |
| zipcode | 必填 | 选填 | • 最大20字符,只能包含：数字、字母和中划线 • 必须符合国家邮编格式不能单独一个0 |
| ssn | 条件必填 | 选填 | • 美国用户必填 • 必须为9位数字 |
| tin | 条件必填 | 选填 | • 账户区域为 EU 的个人用户必填，且仅对这类用户收集 • 去除首尾空格后为 6–20 个字符的字符串，须保留前导零，不要当作数字传递 • 不接受星号（ *）字符• 本接口设为选填以支持分步保存；修改时须传新的完整值——把查询接口返回的掩码 ****** 原样回传不会改变已存值，且仅在税号已收集时才被接受（否则按缺少税号报错）• 已存值为只写：查询接口一律返回 ******。若需在 PI 之外收集或替换税号，见 POST /kyc/individual/tin |
| citizenship_iso2_codes | 必填 | 选填 | 有效国籍代码 |
| place_of_birth | 必填 | 选填 | 2位有效国家代码 |
| ip_address | 必填 | 选填 | |
| kyc_flow | 选填 | 选填 | 默认为 kyc_connect ， 适用于 KYC Connect 集成方案一 ，kyc_sdk_v2 适用于 KYC Connect 集成方案二 - SDK v2 |
| created_at_partner | 选填 | 选填 | 用户在交易所的创建时间 要求传符合 RFC 3339 标准的日期时间字符串 |
| kyc_finished_at_partner | 选填 | 选填 | 用户在交易所完成kyc的时间 要求传符合 RFC 3339 标准的日期时间字符串 |
关键验证规则（两种模式通用）
1. 邮箱限制
- 禁止后缀：系统会拒绝
.ru等特定域名的邮箱 - 格式要求：必须是有效的邮箱地址格式
2. 国家/地区验证
国家代码：必须在国家接口范围内
- 美国特殊规则：
state字段必须为正确的州名（如：CA、NY、TX）- 必须提供9位数字的SSN（标准模式下）
3. 地址格式
- 标准模式：地址必须为有效格式，长度10-255字符
- 邮编验证：必须符合所在国家的正确格式
4. 税号（TIN）
- 仅适用于账户区域为 EU 的个人账户——以账户本身所属区域为准，而非单次请求传入的
country_iso2_code。 - 本接口为选填，但 EU 个人账户未收集税号时无法完成 POST /kyc/individual/submit。
- 该字段为只写：回传
******（查询接口返回的掩码）会被视为"无变更"——仅在税号已收集时才被接受；账户尚未收集时会被判为缺少税号并报错，不会被保存。
常见失败原因
标准模式常见问题：
必填字段缺失：未提供所有必填信息
邮箱被拒：使用了禁止的邮箱后缀（如 .ru）
国家无效：country_iso2_code 不在允许列表中
美国用户SSN错误：格式不是9位数字
地址格式错误：长度不足10字符或格式无效
邮编不匹配：与所选国家的格式不符
州名错误：美国州名拼写不正确
简化模式注意事项：
- 仅
uid和email为必填，其他字段（含country_iso2_code）缺失不会导致验证失败； - 但提供的字段如果传递了，仍需符合格式要求，包含不能为空校验和格式校验。尤其注意：
country_iso2_code、state不要传显式的null——不传该字段即可； - 如果提供国家代码为US，建议同时提供正确的SSN和州名。