/kyc/individual/pi

接口详情

提交个人基本信息

业务规则

信息更新：在最终提交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	选填	选填	字符串
email	必填	必填	• 有效邮箱地址 • 最大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位数字
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字符
邮编验证：必须符合所在国家的正确格式

常见失败原因

标准模式常见问题：

必填字段缺失：未提供所有必填信息

邮箱被拒：使用了禁止的邮箱后缀（如 .ru）

国家无效：country_iso2_code 不在允许列表中

美国用户SSN错误：格式不是9位数字

地址格式错误：长度不足10字符或格式无效

邮编不匹配：与所选国家的格式不符

州名错误：美国州名拼写不正确

简化模式注意事项：

仅 uid 和 email country_iso2_code 为必填，其他字段缺失不会导致验证失败；
但提供的字段如果传递了，仍需符合格式要求，包含不能为空校验和格式校验；
如果提供国家代码为US，建议同时提供正确的SSN和州名。