post
https://sandboxapi.legendtrading.com/v2/app/kyc/individual/pi
Send the basic personal information of an individual user to Legend.用于提交或更新个人用户的基本信息。
Notes
-
This API can be called multiple times to update/edit user's information. However, once submit API is called successfully, user's infomation can't be updated/edited anymore.
-
The 'country_iso2_code' field is required, because our compliance system needs to check if the country is a sanctioned country, or a high-risk country. Please use ISO 3166-1 alpha-2 standard codes or response of countries API.
接口详情
- 提交个人基本信息
业务规则
- 信息更新：在最终 提交KYC申请 之前，可多次调用此接口以更新用户信息。
- 国家代码：
country_iso2_code为必填项，该字段是合规性筛查的关键依据。请使用 ISO 3166-1 alpha-2 标准代码，您也可通过 获取国家列表 API 查询。 mini pi类型特殊规则：对于此类型，仅uid和email,country_iso2_code为必填字段。其他字段为可选，但若传入则必须通过其对应的有效性校验。
UI参考
两种提交模式参数说明
1. 标准模式（普通KYC）
所有标记为"必填"的字段都必须提供，系统会进行严格验证。
2. 简化模式（Mini PI）
仅 uid 和 email , country_iso2_code 为必填字段，其他字段均为选填。适用于快速注册场景。
字段要求对比表
| 字段 | 标准模式 | 简化模式 | 格式要求 |
|---|---|---|---|
| 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） • 必须在有效国家列表内 |
| state | 必填 | 选填 | • 字符串 • 美国用户：必须正确州名，可以是iso2_code 或者英文全称，例如： NY 或者New York 都认为正确的州名。 |
| city | 必填 | 选填 | 字符串 |
| address | 必填 | 选填 | • 字符串 ，不能包含下划线和@符号 • 长度10-255字符 • 有效地址格式 |
| zipcode | 必填 | 选填 | • 最大20字符,只能包含：数字、字母和中划线 • 必须符合国家邮编格式不能单独一个0 |
| ssn | 条件必填 | 选填 | • 美国用户必填 • 必须为9位数字 |
| citizenship_iso2_codes | 必填 | 选填 | 有效国籍代码 |
| place_of_birth | 必填 | 选填 | 2位有效国家代码 |
| ip_address | 必填 | 选填 |
关键验证规则（两种模式通用）
1. 邮箱限制
- 禁止后缀：系统会拒绝
.ru等特定域名的邮箱 - 格式要求：必须是有效的邮箱地址格式
2. 国家/地区验证
国家代码：必须在国家接口范围内
- 美国特殊规则：
state字段必须为正确的州名（如：CA、NY、TX）- 必须提供9位数字的SSN（标准模式下）
3. 地址格式
- 标准模式：地址必须为有效格式，长度10-255字符
- 邮编验证：必须符合所在国家的正确格式
常见失败原因
标准模式常见问题：
必填字段缺失：未提供所有必填信息
邮箱被拒：使用了禁止的邮箱后缀（如 .ru）
国家无效：country_iso2_code 不在允许列表中
美国用户SSN错误：格式不是9位数字
地址格式错误：长度不足10字符或格式无效
邮编不匹配：与所选国家的格式不符
州名错误：美国州名拼写不正确
简化模式注意事项：
- 仅
uid和emailcountry_iso2_code为必填，其他字段缺失不会导致验证失败； - 但提供的字段如果传递了，仍需符合格式要求，包含不能为空校验和格式校验；
- 如果提供国家代码为US，建议同时提供正确的SSN和州名。