生成用户钱包接口

1. 场景描述
实名注册:个人用户实名信息通过平台签名的方式提交到薄盒进行注册。
2. 场景交互图
注意:
1、注册时需要提交用户的二要素信息必须为真实有效信息,否则注册将失败。
2、用户在使用taskId获取时必须要与提供的secretId一致。
流程:
1. 调用开通钱包接口(平台签名)提交实名信息,返回用户任务Id。
2. 用户通过任务Id定时的方式再次调用接口获取钱包信息。此时钱包生成完成。
3. 相关接口
1)开通钱包
说明:根据企业/商户提供的用户信息创建钱包
接口:api/v1/user/register
请求方式:post
请求参数:
字段名称 类型 是否必填 描述
merchantId int64 商户id,由薄盒分配
personName string 真实姓名
email string 用户邮箱
mobile string 手机
idCard string 证件号码
cardType int 证件类型 1-身份证 2-护照 3-港澳通行证 4-台湾通行证 5-外国人永居身份证 6-港澳台居民居住证 7-其他
signData string 签名:md5(personName_mobile_idCard_cardType_secretKey)
响应参数:
字段名 类型 是否必填 描述
code int

正确:200

错误:500

msg string

正确:成功

错误:错误原因

data string {"taskId":"任务编号"}
2)查询接口
说明:任务Id查询钱包信息
接口:api/v1/user/query
例如:api/v1/user/query/12809
请求方式:get
请求参数:
字段名 类型 是否必填 描述
taskId string 任务编号
响应参数:
字段名 类型 是否必填 描述
code int

正确:200

错误:500

msg string

正确:成功

错误:错误原因

data string json array-listData address地址
listData说明
字段名 类型 是否必填 描述
type int

1树图链

userId int64

用户编号

address string 地址
status int

1绑定中

2已绑定

3绑定失败

4未发起过绑定(未查询到)

3)查询接口
说明:手机号查询钱包信息
接口:api/v1/user/querybytel/{mobile}
例如:api/v1/user/querybytel/1500000000
请求方式:get
请求参数:
字段名 类型 是否必填 描述
mobile string 手机号
响应参数:
字段名 类型 是否必填 描述
code int

正确:200

错误:500

msg string

正确:成功

错误:错误原因

data string json array-listData address地址
listData说明
字段名 类型 是否必填 描述
type int

1树图链

userId int64

用户编号

address string 地址
status int

1绑定中

2已绑定

3绑定失败

4未发起过绑定(未查询到)

3. 错误码
错误码 描述
150001 重复请求
150002 商户不存在
150003 当前用户已存在
150004 创建用户异常
150005 未找到用户