/kyc/individual/fields

返回用户提交KYC需要完成的字段


接口详情

检查字段完成进度,获取Legend Trading要求的个人用户基本信息字段及其完成状态。

参数说明

country_iso2_codeuid 参数为二选一必填项,具体使用场景如下:

适用场景参数名说明
用户未开始注册country_iso2_code根据国家/地区代码,返回该地区用户需要填写的全部字段列表
用户已部分完成 KYCuid根据用户唯一标识,返回该用户尚未完成的必填字段清单

如果两个参数都传递了,则以country_iso2_code为准,但是同时也会检查uid是否有效。

API返回值中的特殊字段说明

字段名说明操作
questionnaire需要完成调查问卷。-
veriff_id完成人脸识别验证。如果有ID文件,则调用File 接口上传证件; 否则用 IDV 接口来获得人脸识别链接
proof_of_address上传地址证明文件。调用 File 接口上传证件

使用示例

// 场景一:新用户注册
{
  "country_iso2_code": "US"
}

// 场景二:已注册用户进度查询
{
  "uid": "12345"
}

注意事项

1. 居住国变更与字段重验证

当用户的居住国家country_iso2_code信息发生变更时,其必填字段集合可能会相应调整。在此情况下,必须重新调用本接口以获取最新的字段要求,并验证用户资料是否已填写完整。

提示:为确保资料符合最新规范,请在用户更新 country_iso2_code 后,触发本接口的重新调用与验证流程。

2. 手机号码字段结构

phone 参数为一个复合对象,包含以下两个子字段:

字段名类型必填说明
phone_isd_codeString国际区号(例如:86)
phone_numberString手机号码(不包含区号)

Query Params
string
Defaults to US

Required without uid. ISO 3166-1 alpha-2 standard codes or response of countries API

string

Required without country_iso2_code

Responses

Language
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json