介绍

此接口用于提交用戶的KYC基本资料

接口说明

请求方式: POST

请求路径：/open/api/kyc/share/information

请求参数

Header 参数：

参数名	参数类型	是否必须	参数说明
appId	String	true	应用的唯一标识
timestamp	String	true	当前 UTC 13位时间戳, 5分钟内有效
sign	String	true	签名，签名方式可参考这里

Body参数：

参数名	必选	类型	长度	说明
requestNo	是	string	64	请求号(必须唯一)
email	是	string	64	邮箱(必须唯一)
kycPlatform	是	string	32	kyc平台:sumsub
holderType	是	string	1	1:个人
individualInfo	是	object		个人信息
firstName	是	string	35	姓
lastName	是	string	35	名
dob	是	string		生日，格式：YYYY-MM-DD
country	是	string	8	国家
gender	是	Integer	1	性别 1:男 2:女
idDocType	是	string	1	证件类型 1=ID Card、2=Passport、3=RESIDENCE_PERMIT、4=DRIVERS
number	是	string	64	证件号
validUntil	是	string		证件过期日期，格式：YYYY-MM-DD，如果永久有效，传2099-01-01
ipAddress	是	string	64	IP地址
address	是	object		地址信息
country	是	string	8	国家
state	是	string	32	州
city	是	string	64	城市
address	是	string	256	地址
zipCode	是	string	16	邮编
ssn	否	string	16	如果国家是美国，ssn必填

返回参数：

参数名	类型	说明
success	boolean	成功标志
error	boolean	失败标志
msg	string	返回处理消息
code	integer	返回代码
model	Object	返回数据
traceId	string	traceId

示例

请求参数：

{
  "requestNo": "222222",
  "email": "22222@123.com",
  "kycPlatform": "123",
  "holderType": "1",
  "individualInfo": {
    "firstName": "213",
    "lastName": "213",
    "dob": "2023-01-01",
    "country": "US",
    "gender": "1",
    "idDocType": "1",
    "number": "123",
    "validUntil": "2023-01-02",
    "ipAddress": "123",
    "address": {
      "country": "USA",
      "state": "213",
      "city": "213",
      "address": "123",
      "zipCode": "123",
      "ssn": "123"
    }
  }
}

返回参数：

{
    "code": "0",
    "msg": "操作成功",
    "model": null,
    "traceId": "652366764a52596446c629939e486913",
    "success": true,
    "error": false
}

备注

更多返回错误代码请看首页的错误代码描述