获取用户信息

请求路径

/open/api/user/core/queryUserInfo

请求方式

POST

参数说明

参数名必选类型描述长度示例
userNumstring用户号64100516923407528221713
merchantNostring商户号64NFT0001
subMerchantNostring子商户号64a01a123
businessSubcategoriesstring业务子分类32VSR

请求示例

{
    "userNum":"100516923407528221713",
    "merchantNo":"NFT0001",
    "subMerchantNo":"a01a123",
    "businessSubcategories":"VSR"
}

返回参数

参数名类型描述
userNumList用户编号
documentInfoListList用户证件列表
addressInfoListList用户地址列表
nameHistoryInfoListList用户名称记录列表
extendInfoListList用户扩展信息

用户证件List[UserDocumentInfoResponse]

参数名类型描述示例
firstNamestring首部名称文学
lastNamestring尾部名称
idDocTypestring证件类型 1=ID Card、2=Passport、3=RESIDENCE_PERMIT、4=DRIVERS1
validUntilstring有效期至2025-06-04
dobstring出生日期2000-06-04
numberstring身份证号/许可证号码/护照号130929199003016238
additionalNumberstring附加证件号码null
facePhotostring人脸照片链接http://*.com/*.pmg
documentPhotostring证件照片链接http://*.com/*.pmg
documentBackPhotostring证件反面链接http://*.com/*.pmg
sourcePlatformstring来源 1:Sumsub 2:Jumio 3:Persona1

用户地址List[UserAddressInfoResponse]

参数名类型描述示例
countrystring国家美国
streetstring街道null
citystringnull
statestringnull
zipCodestring邮编null
addressstring地址null
sourcePlatformstring来源 1:Sumsub 2:Jumio 3:Persona1
createTimestring创建时间2023-08-18T06:39:12.000+0000

用户名称记录List[UserHistoryInfoResponse]

参数名类型描述示例
firstNamestring首部名称文学
lastNamestring尾部名称
genderstring性别null
createTimestring创建时间2023-08-18T06:39:13.000+0000

用户扩展信息List[UserExtendInfoResponse]

参数名类型描述示例
extendKeystring扩展keyname
extendValuestring扩展value张三
describesstring描述名称

响应示例

{
  "code": "0",
  "msg": "成功",
  "model": {
    "userNum": "100516923407528221713",
    "documentInfoList": [
      {
        "firstName": "文学",
        "lastName": "杨",
        "idDocType": "1",
        "validUntil": "2025-06-04",
        "dob":"2000-06-04",
        "number": "130929199003016238",
        "additionalNumber": null,
        "facePhoto": null,
        "documentPhoto": null,
        "documentBackPhoto": null,
        "sourcePlatform": "1"
      }
    ],
    "addressInfoList": [
      {
        "country": "美国",
        "street": "",
        "city": null,
        "state": null,
        "zipCode": null,
        "sourcePlatform": "1",
        "createTime": "2023-08-18T06:39:12.000+0000"
      }
    ],
    "nameHistoryInfoList": [
      {
        "firstName": "文学",
        "lastName": "杨",
        "gender": null,
        "createTime": "2023-08-18T06:39:13.000+0000"
      },
      {
        "firstName": "wen xue",
        "lastName": "yang",
        "gender": null,
        "createTime": "2023-08-18T08:25:41.000+0000"
      },
      {
        "firstName": "泱",
        "lastName": "张",
        "gender": null,
        "createTime": "2023-08-18T10:14:46.000+0000"
      }
    ],
    "extendInfoList": [
      {
        "extendKey": "name",
        "extendValue": "1",
        "describes": "名称"
      },
      {
        "extendKey": "age",
        "extendValue": "1",
        "describes": "年龄"
      }
    ]
  },
  "traceId": "64e879ab20d696d4461b0c222f09fa1d",
  "success": true,
  "error": false
}