账户查询接口

功能概述

商户通过该接口可以查询钱包账户信息。

接口地址

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

参数名称 参数中文名称 类型& 长度 参数说明 是否必填
merchantId 商户编号 varchar(9) 商户在首信易系统的唯一身份标识,商户完成首信易系统注册后可登录商户后台商户服务查看。 M
walletId 钱包 ID varchar(19) 用户钱包在我司的唯一编号 M
hmac 参数签名 varchar(500) 商户生成的参数签名结果,获取hmac的方法请参考请求加密流程 M

参数示例

{ "merchantId": "890000595", "walletId": "11111111", "hmac": ZZ8ye4tFflaUyJ+FF6FAC7+2W1bsPI610x95C/KIz4pt9EZ+iiltSxQyf2UJledfcYR2WKDVY d/bTHrnaKx7630D7AjGhO/HCaJso4BDaKwfSHxNKVKd29Y4P8oq3B2HAKleNqsFOPAJ rBUxIewjSarQ0Od3QPB/FqYr1cMvWViThwxPrSMS40zAu2dDuxkg4lJS/H7KovBPVa5O 6/pqonuJ8VVcUY4ZZzcC1HfNUEbNnYs8G4Cp2LMj3XjC7MuGSPpg3nRZorVgcA2J5EL JgOgJO4axsGRKr4s358EFtXamaajYUA28UjwxgqDeN+OXX27KkDbriBoElABKfHlb0A== }

同步返回参数列表

参数名称 参数中文名称 参数说明
status 响应状态 SUCCESS 响应正常
FAIL 响应异常
idCardRzStatus 实名认证 SUCCESS 成功
FAIL 失败
operatorRzStatus 运营商认证 SUCCESS 成功
FAIL 失败
personRzStatus 人像认证 INIT 没有校验过
SUCCESS 成功
FAIL 失败
merchantId 商户编号 同请求参数
requestId 订单号 开户的订单号
merchantUserId 商户用户 ID 商户用户 ID
walletId 钱包 ID 同请求参数
setUpPasswrod 是否设置支付密码 true 是
false 否
idCardType 证件类型 IDCARD 身份证
idCardNoDesc 身份证号码 身份证掩码
mobileDesc 注册手机 手机掩码
nameDesc 姓名 姓名掩码
profession 职业 同请求参数
nickName 用户昵称 用户昵称
riskScore 注册风险评分 返回是 0~100 正整数,数值越高风险越大
accountType 账户类型 钱包账户类别(共有 3 类)
I 类账户:自账户开立起,使用余额支付累计不可超过 1000元(包括支付账户向客户本人同名银行账户转账)认证次数1-2 次
II 类账户:使用余额支付年累计不可超过 10 万元 (不包括支付账户向客户本人同名银行账户转账)认证次数 3-4 次
III 类账户:使用余额支付年累计不可超过 20 万元 (不包括支付账户向客户本人同名银行账户转账)认证次数 5 次以上
authTimes 认证次数 实名认证,运营商认证,人脸识别,银行卡鉴权(非同一银行),累加计数
balance 钱包余额 单位为分
createDateTime 创建时间 格式:yyyy-MM-dd HH:mm:ss
walletStatus 钱包状态 INIT 初始化
ACTIVATE 激活
FREEZED 冻结
FAIL 失败
DESTROY 销户
hmac 参数签名 商户生成的参数签名结果,获取hmac的方法请参考请求加密流程

参数示例

{ "profession":"A", "walletId":"33704400121831123", "idCardRzStatus":"SUCCESS", "nickName":"Hello", "accountType":"ONE", "authTimes":"2", "createDateTime":"2020-01-09 20:45:27", "nameDesc":"张*三", "idCardType":"IDCARD", "balance":"0", "setUpPasswrod":"false", "merchantId":"890000595", "requestId":"202002251582614048062", "hmac":"wwUdSQPJyAwrUt6zxqESN/z6XK//H5sq3PaF3WanCSIObPUtEnfs6RpQCd3Cw+CLY vNvcK9PEpK10gFelRq8b3WUX6idOxBhTFtoVcNjCrBHdAUgTBwzOOTrzpVEoMroakGEQge uGvaKKTLOVbiothNjxImtYyBS8Bnfyc6Pg/cZlSb+1I7bHflqhy2zHVYEwVQcC7WUmVooF4b 3IhCJj4zdn43kVi3IpBiAwwHSgi16GnzNjZQZEGP67JXfrsypYJh1FUaAfSBVePpGF/pMqzSa+L wzvyZFazaB8tIQEQPt5Jc3oy1ikN9nlgpxB8NkRExTG/HiAyo2NLl7Az3HvQ==", "idCardNoDesc":"2308***312", "walletStatus":"ACTIVATE", "operatorRzStatus":"SUCCESS", "merchantUserId":"88974455", "riskScore":"65", "mobileDesc":"130***9559", "status":"SUCCESS" }