创建钱包账户接口

功能概述

用户申请开通该商户下的钱包账户。

接口地址

https://webox-api.5upay.com/webox/wallet/create

参数名称 参数中文名称 类型& 长度 参数说明 是否必填
merchantId 商户编号 varchar(9) 商户在首信易系统的唯一 id,可在商户后台查看 M
requestId 订单编号 varchar(50) 提交的订单号必须在账户交易中唯一;首信易数据支付系统中对于已创建的订单,商户端不能重复提交 M
merchantUserId 商户用户ID varchar(100) 用户在商户系统唯一标识号,由商户自行生成 M
idCardType 证件类型 固定值 IDCARD 身份证 M
name 姓名 varchar(50) 姓名 M
idCardNo 证件号码 varchar(18) 证件号码 M
mobile 注册手机号码 varchar(50) 注册手机号码 M
profession 职业 固定值 A:各类专业,技术人员 M
B:国家机关,党群组织,企事业单位的负责人
C:办事人员和有关人员
D:商业工作人员
E:服务性工作人员
F:农林牧渔劳动者
G:生产工作,运输工作和部分体力劳动者
ip IP varchar(50) 客户端的 IP M
mac MAC 地址 varchar(50) 客户端的 MAC 地址,字母之间用“:”连接如果 IOS 不能获取,请传默认值:00:00:00:00:00:00 M
nickName 用户昵称 varchar(50) 用户昵称 O
idCardFrontPath 证件国徽面 varchar(200) 需上传到 SFTP O
idCardBackPath 证件人像面 varchar(200) 需上传到 SFTP O
sex 性别 varchar(10) 传入身份证实际值 O
nation 民族 varchar(200) 传入身份证实际值 O
address 住址 varchar(200) 传入身份证实际值 O
issue 签发机关 varchar(200) 传入身份证实际值 O
period 出生日期 varchar(200) yyyymmdd O
hmac 参数签名 varchar(500) 商户生成的参数签名结果,获取hmac的方法请参考请求加密流程 M

参数示例

{ "merchantId": "890000595", "requestId": "202002251582614048062", " merchantUserId ": "12345678", " idCardType ":" IDCARD ", "name": "李四", "idCardNo": "1305533344197705043255", "mobile": ”13022950343”, "profession":"A", "ip": "172.10.23.123", "mac": ”AD:23:DS:3S:56:24”, "nickName":"Hello", "hmac": ZZ8ye4tFflaUyJ+FF6FAC7+2W1bsPI610x95C/KIz4pt9EZ+iiltSxQyf2UJledfcYR2WKDVY d/bTHrnaKx7630D7AjGhO/HCaJso4BDaKwfSHxNKVKd29Y4P8oq3B2HAKleNqsFOPAJ rBUxIewjSarQ0Od3QPB/FqYr1cMvWViThwxPrSMS40zAu2dDuxkg4lJS/H7KovBPVa5O 6/pqonuJ8VVcUY4ZZzcC1HfNUEbNnYs8G4Cp2LMj3XjC7MuGSPpg3nRZorVgcA2J5EL JgOgJO4axsGRKr4s358EFtXamaajYUA28UjwxgqDeN+OXX27KkDbriBoElABKfHlb0A== }

同步返回参数列表

参数名称 参数中文名称 参数说明
status 响应状态 SUCCESS 响应正常
FAIL 响应异常
walletStatus 钱包状态 ACTIVATE 激活
FAIL 失败
operatorRzStatus 运营商认证 SUCCESS 成功
FAIL 失败
merchantId 商户编号 同请求参数
requestId 订单号 同请求参数
merchantUserId 商户用户 ID 同请求参数
walletId 钱包ID 用户钱包在我司的唯一编号
idCardRzStatus 实名认证 SUCCESS 成功
FAIL 失败
riskScore 注册风险评分 返回是 0~100 正整数,数值越高风险越大
secretKey 证书授权码 用户开户后首次唤起 SDK 自动安装数字证书时使用,10 分钟内有效,secretKey 仅可唤起一次 SDK,可以在唤起 SDK 中完成,1、安装数字证书2、设置支付密码3、上传身份证照片(可跳过)
hmac 参数签名 商户生成的参数签名结果,获取hmac的方法请参考请求加密流程

示例

{ "status":"SUCCESS", "walletStatus":"ACTIVATE" "operatorRzStatus":"SUCCESS", "merchantId":"890000595", "requestId":"202002251582614048062", "merchantUserId":"89666819200402", "walletId":"33704400121811473", "idCardRzStatus":"SUCCESS", "riskScore":"0"; “secretKey”:”fe0cae48d97347fab5ff9764660ce431” "hmac":"ZZ8ye4tFflaUyJ+FF6FAC7+2W1bsPI610x95C/KIz4pt9EZ+iiltSxQyf2UJledfcYR2 WKDVYd/bTHrnaKx7630D7AjGhO/HCaJso4BDaKwfSHxNKVKd29Y4P8oq3B2HAKleNq sFOPAJrBUxIewjSarQ0Od3QPB/FqYr1cMvWViThwxPrSMS40zAu2dDuxkg4lJS/H7KovB PVa5O6/pqonuJ8VVcUY4ZZzcC1HfNUEbNnYs8G4Cp2LMj3XjC7MuGSPpg3nRZorVgc A2J5ELJgOgJO4axsGRKr4s358EFtXamaajYUA28UjwxgqDeN+OXX27KkDbriBoElABKf Hlb0A==", }