云钱包Server API

账户管理

1 开通钱包

url:/api/v1/standardWallet/openWallet.shtml

请求类型:post

参数:

参数名 含义 长度 可为空 说明
custUid 渠道用户唯一标识 40 必填 渠道用户的唯一编号
custMobile 渠道用户手机号 20 非必填

返回值:参考公共返回值

2 用户概览

url:/api/v1/standardWallet/myAccount.shtml

请求类型:post

参数:

参数名 含义 长度 可为空 说明
custUid 渠道用户唯一标识 40 必填 渠道用户的唯一编号

返回值:

参数名 含义 长度 可为空 说明
totalAmount 账户余额 20 必填 账户余额
authStatus 是否实名认证 必填 0未认证,1已认证
bindCardStatus 是否绑定银行卡 必填 0未绑定,1已绑定
realName 用户姓名 非必填
userIDno 身份证号 非必填

银行卡设置

1 银行卡设置

url:/api/v1/standardWallet/myCardList.shtml

请求类型:post

参数:

参数名 含义 长度 可为空 说明
custUid 渠道用户唯一标识 40 必填 渠道用户的唯一编号

返回值:

参数名 含义 长度 可为空 说明
cardList 银行卡列表 【列表对象开始】
bankName 银行名称 必填
cardType 卡类型 必填
cardNo 卡号 必填
bankLogo 银行logo图片URL 必填
bindStatus 绑定状态 必填 0绑定失败,1绑定成功
cardList 银行卡列表 【列表对象结束】

2 用户绑定银行卡可选银行列表

url:/api/v1/standardWallet/bankCardList.shtml

请求类型:post

参数:无

返回值:

参数名 含义 长度 可为空 说明
cardList 银行卡列表 【列表对象开始】
bankName 银行名称 必填
bankLogo 银行logo图片URL 必填
dayLimit 单日限额 必填
singleLimit 单笔限额 必填
cardList 银行卡列表 【列表对象结束】

3 获取绑卡验证码

url:/api/v1/standardWallet/bindCardValiCode.shtml

请求类型:post

参数:

参数名 含义 长度 可为空 说明
custUid 渠道用户唯一标识 40 必填 渠道用户的唯一编号
userName 用户姓名 非必填 用户未实名认证时必填
userIDno 身份证号 非必填 用户未实名认证时必填
cardNo 银行卡号 必填
mobileNo 银行预留手机号 必填

返回值:

参数名 含义 长度 可为空 说明
mobileToken 验卡token(令牌) 40 必填

4 用户绑卡

url:/api/v1/standardWallet/bindCard.shtml

请求类型:post

参数:

参数名 含义 长度 可为空 说明
custUid 渠道用户唯一标识 40 必填 渠道用户的唯一编号
mobileToken 验卡token 40 必填
valiCode 短信验证码 必填

返回值:参考公共返回参数

交易管理

1 提现

url:/api/v1/standardWallet/transferOutInfo.shtml

请求类型:post

参数:

参数名 含义 长度 可为空 说明
custUid 渠道用户唯一标识 40 必填 渠道用户的唯一编号

返回值:

参数名 含义 长度 可为空 说明
totalAmount 账户余额 必填
infoList 信息列表(列表开始) 【列表对象开始】
cardNo 银行卡号 必填
outMoney 最大可转出金额 非必填
bankName 银行名称 必填
bankLogo 银行logo图片URL 必填
infoList 信息列表(列表结束) 【列表对象结束】

2 用户提现

url:/api/v1/standardWallet/transferOut.shtml

请求类型:post

参数:

参数名 含义 长度 可为空 说明
custUid 渠道用户唯一标识 40 必填 渠道用户的唯一编号
outMoney 提现金额 必填
valiCode 短信验证码 必填
cardNo 银行卡号 必填
custOrderno 渠道订单号 40 必填 订单号唯一

返回值:

参数名 含义 长度 可为空 说明
jrmfOrderno 金融魔方订单号 必填
outMoney 提现金额 必填
outDate 提现日期 必填
arriveDate 预计到账日期
arriveBankName 到账银行 必填
arrivecardNo 到账卡号 必填

3 充值

url:/api/v1/standardWallet/transferInInfo.shtml

请求类型:post

参数:

参数名 含义 长度 可为空 说明
custUid 渠道用户唯一标识 40 必填 渠道用户的唯一编号

返回值:

参数名 含义 长度 可为空 说明
infoList 信息列表(列表开始) 【列表对象开始】
cardNo 银行卡号 必填
bankName 银行名称 必填
bankLogo 银行logo图片URL 必填
infoList 信息列表(列表结束) 【列表对象结束】

4 用户充值

url:/api/v1/standardWallet/transferIn.shtml

请求类型:post

参数:

参数名 含义 长度 可为空 说明
custUid 渠道用户唯一标识 40 必填 渠道用户的唯一编号
inMoney 充值金额 必填
valiCode 短信验证码 必填
cardNo 银行卡号 必填
custOrderno 渠道订单号 40 必填 订单号唯一

返回值:

参数名 含义 长度 可为空 说明
jrmfOrderno 金融魔方订单号 必填

5 交易明细

url:/api/v1/standardWallet/tradeDetail.shtml

请求类型:post

参数:

参数名 含义 长度 可为空 说明
custUid 渠道用户唯一标识 40 必填 渠道用户的唯一编号
tradeType 交易类型 非必填 0全部,1收入,2支出,3交易成功,4交易失败,默认全部
pageNum 起始页 非必填 默认第一页
pageSize 页大小 非必填 默认每页十条数据

返回值:

参数名 含义 长度 可为空 说明
iListSize 总记录数 必填
tradeList 交易列表 【列表对象开始】
tradeName 交易名称 必填
tradeAmount 交易金额 必填
tradeType 交易类型 必填 1收入,2支出
tradeDate 交易日期 必填 yyyy-MM-dd HH:mm:ss
tradeStatus 交易状态 必填 3交易成功,4交易失败
outBankName 提现银行 非必填 交易类型为提现时必填
outCardNo 提现银行卡号 非必填 交易类型为提现时必填
inBankName 充值银行 非必填 交易类型为充值时必填
inCardNo 充值银行卡号 非必填 交易类型为充值时必填
tradeList 交易列表 【列表对象结束】

获取验证码

url:/api/v1/standardWallet/valiCode.shtml

请求类型:post

参数:

参数名 含义 长度 可为空 说明
custUid 渠道用户唯一标识 40 必填 渠道用户的唯一编号
mobileNo 用户手机号 非必填 为空时将短信验证码发送至开通钱包时的手机号
type 验证码类型 必填 0充值,1提现

返回值:参考公共返回参数

修改用户信息

url:/api/v1/standardWallet/updateCustUser.shtml

请求类型:post

参数:

参数名 含义 长度 可为空 说明
custUid 渠道用户唯一标识 40 必填 渠道用户的唯一编号
custMobile 渠道用户手机号 20 必填
custNickname 渠道用户昵称 40 非必填
custImg 渠道用户头像URL 120 非必填 Base64 编码

返回值:参考公共返回参数

渠道转账至个人帐户

url:/api/v1/standardWallet/transferToUser.shtml

请求类型:post

参数:

参数名 含义 长度 可为空 说明
custUid 渠道用户唯一标识 40 必填 渠道用户的唯一编号
transferAmount 转账金额 20 必填 单位元
custOrderno 渠道订单号 40 必填 订单号唯一
transferDesc 转账说明 100 非必填 备注
custMobile 渠道用户手机号 20 非必填
custNickname 渠道用户昵称 40 非必填
custImg 渠道用户头像URL 120 非必填 Base64 编码

返回值:

参数名 含义 长度 可为空 说明
jrmfOrderno 金融魔方订单号 必填

安全设置

1 设置交易密码

url:/api/v1/standardWallet/setTransPwd.shtml

请求类型:post

参数:

参数名 含义 长度 可为空 说明
custUid 渠道用户唯一标识 40 必填 渠道用户的唯一编号
tranPassword 交易密码 40 必填 加密后的密码

2 重置交易密码

url:/api/v1/standardWallet/reSetTransPwd.shtml

请求类型:post

参数:

参数名 含义 长度 可为空 说明
custUid 渠道用户唯一标识 40 必填 渠道用户的唯一编号
tranPassword 交易密码 40 必填 加密后的密码
newPassword 新交易密码 40 必填 加密后的新密码

3 用户按密码提现

url:/api/v1/standardWallet/transferOutByPwd.shtml

请求类型:post

参数:

参数名 含义 长度 可为空 说明
custUid 渠道用户唯一标识 40 必填 渠道用户的唯一编号
outMoney 提现金额 必填
tranPassword 交易密码 40 必填 加密后的密码
cardNo 银行卡号 必填
custOrderno 渠道订单号 40 必填 订单号唯一

返回值:

参数名 含义 长度 可为空 说明
jrmfOrderno 金融魔方订单号 必填
outMoney 提现金额 必填
outDate 提现日期 必填
arriveDate 预计到账日期 必填
arriveBankName 到账银行 必填
arrivecardNo 到账卡号 必填

个人用户余额支付

url:/api/v1/standardWallet/payUseBalance.shtml

请求类型:post

参数:

参数名 含义 长度 可为空 说明
custUid 渠道用户唯一标识 40 必填 付款用户
amount 付款金额 20 必填 付款金额
custOrderno 渠道订单号 40 必填 渠道唯一订单号
tranPassword 交易密码 40 必填 加密后的交易密码
orderDesc 转账说明 100 非必填 备注

返回值:

参数名 含义 长度 可为空 说明
jrmfOrderno 金融魔方订单号 必填

企业钱包Server API

创建银行个人账户

1 创建账户

url:/wallet/v1/custom/users/actions/batchRegister.shtml

请求类型:post

参数:

名称 类型 是否必填 说明
userNo String 用户编号(长度 10)
merchantId String 渠道编号(长度 10)
mobilePhone String 用户手机号(长度 11)
companyNo String 用户所属公司(渠道方式接入时,必填)

返回值:

名称 类型 说明
state String 返回状态
respmsg String 返回信息

2 查询用户状态

url:/wallet/v1/custom/users/status.shtml

请求类型:post

参数:

名称 类型 是否必填 说明
userNo String 用户编号(长度 10)
merchantId String 渠道编号(长度 10)

返回值:

名称 类型 说明
state String 返回状态
respmsg String 返回信息
user Object int id;//主键userId String userNo;// 渠道用户id String userName;//姓名 String certId;//用户身份证号码 String mobilePhone;//用户手机号 String creatTime;//注册时间 String merchantId;//渠道id String transPassword;//交易密码状态 String channelBankNo;//商户业务对应的银行 String companyUserNo;//用户所在企业对应的编号 String companyName;//用户所在企业名称 int userType;// 用户类型,1普通 , 2商户, 0禁用, -1 待激活 11 待补全信息 -2待激活商户

3 补全用户信息

url:/wallet/v1/custom/users/addInfo.shtml

请求类型:post

参数:

名称 类型 是否必填 说明
userNo String 用户编号(长度 10)
merchantId String 渠道编号(长度 10)
userName String 用户姓名(长度 30)
certId String 身份证号(长度 18)
bankCardNo String 银行卡号(长度 20)

返回值:

名称 类型 说明
state String 返回状态
respmsg String 返回信息

4 变更所属公司

url:/wallet/v1/custom/users/actions/changeCompany.shtml

请求类型:post

参数:

名称 类型 是否必填 说明
merchantId String 渠道编号(长度 10)
userNo String 用户编号(长度 10)
newCompanyUserNo String 变更后的企业编号(长度 10)

返回值:

名称 类型 说明
state String 返回状态
respmsg String 返回信息
token String 登陆token

提现

url:/wallet/v1/custom/transfers/actions/withdraw.shtml

请求类型:post

参数:

名称 类型 是否必填 说明
amount String 提现金额(单位元,精确到两位小数,单笔小于50000元)
userNo String 员工编号或者公司编号(长度10)
merchantId String 渠道编号(长度10)
withDrawTransUrl String 商户页面地址(长度50)
customOrderNo String 订单号(长度20)
withDrawBackNotify String 商户后台通知 url(长度50)

返回值:

名称 类型 说明
state String 返回状态
respmsg String 返回信息
withdrawUrl String 提现跳转银行页面

查询交易记录与交易详情

url:/wallet/v1/custom/transfers.shtml

请求类型:post

参数:

名称 类型 是否必填 说明
merchantId String 渠道编号(长度10)
userNo String 员工编号或者公司编号(长度10)
pageIndex String 页码(默认1)
pageSize String 每页显示条数(默认10)
tradeType String 0.全部 1.个人报销 2.个人提现 3.企业充值 4.企业转账,5.个人余额收益 6.企业余额收益 7.企业报销 10.企业批量报销

返回值:

名称 类型 说明
state String 返回状态
respmsg String 返回信息
hasNext 布尔 是否有下一页
transferHistoryList List String transferRequestNo;//交易订单号 String amount; //金额 int tradeType; //交易类型 String tradeName; //交易名称 String creatTime; //创建时间 String creatMonth; //创建月份 String tradeCharge; //手续费 String tradeChargeRate; //手续费百分比 int status; //交易状态(1成功,0失败 2待确认) String statusDesc; // 交易状态描述 String bankCardNo; // 银行卡号 String bankName; // 银行名 int type; // 1.收入,2,支出

安全设置

1 设置支付密码

url:/wallet/v1/custom/actions/url.shtml

请求类型:post

参数:

名称 类型 是否必填 说明
merchantId String 渠道编号(长度10)
userNo String 员工编号或者公司编号(长度10)
urlType String 1,设置密码
returnSuccUrl String 跳转成功页面(长度50)
returnFailUrl String 跳转失败页面(长度50)
notityUrl String 通知url(长度50)

返回值:

名称 类型 说明
state String 返回状态
respmsg String 返回信息
passwordUrl String 跳转银行设置密码页面

2 修改支付密码

url:/wallet/v1/custom/actions/url.shtml

请求类型:post

参数:

名称 类型 是否必填 说明
merchantId String 渠道编号(长度10)
userNo String 员工编号或者公司编号(长度10)
urlType String 1,设置密码
modPwdRedirectUrl String 跳转页面(长度50)
notityUrl String 通知url(长度50)

返回值:

名称 类型 说明
state String 返回状态
respmsg String 返回信息
passwordUrl String 跳转银行设置密码页面

3 忘记支付密码

url:/wallet/v1/custom/actions/url.shtml

请求类型:post

参数:

名称 类型 是否必填 说明
merchantId String 渠道编号(长度10)
userNo String 员工编号或者公司编号(长度10)
urlType String 1,设置密码
resetPwdRedirectUrl String 跳转页面(长度50)
notityUrl String 通知url(长度50)

返回值:

名称 类型 说明
state String 返回状态
respmsg String 返回信息
passwordUrl String 跳转银行设置密码页面

查询账户信息

1 查询余额信息

url:/wallet/v1/custom/users/actions/queryUserBalance.shtml

请求类型:post

参数:

名称 类型 是否必填 说明
userNo String 员工编号(长度10)
merchantId String 渠道编号(长度10)

返回值:

名称 类型 说明
state String 返回状态
respmsg String 返回信息
avail_bal String 余额

2 查询用户账户信息

url:/wallet/v1/custom/users/actions/queryUserInfos.shtml

请求类型:post

参数:

名称 类型 是否必填 说明
userNo String 员工编号(长度10)
merchantId String 渠道编号(长度10)

返回值:

名称 类型 说明
state String 返回状态
respmsg String 返回信息
userName String 姓名
phoneNo String 手机号
certNo String 身份证
passwdStatus String 密码设置状态 0,未设置 1,已设置
userStatus String 用户状态 正常-AVAILABLY 冻结-FREEZED 注销-CANCAEL
availBalance String 可用余额
accountingTime String 到账时间
maxTranfer String 一次最多提现金额 单位元

查询银行卡

1 查询提现银行卡

url:/wallet/v1/custom/users/actions/queryBindCardList.shtml

请求类型:post

参数:

名称 类型 是否必填 说明
userNo String 员工编号(长度10)
merchantId String 企业编号(长度10)

返回值:

名称 类型 说明
state String 返回状态
respmsg String 返回信息
banklist List bankCardNo银行卡号 bankName 银行名 logo 银行图标

2 更换提现银行卡

url:/wallet/v1/custom/users/actions/changeBankCard.shtml

请求类型:post

参数:

名称 类型 是否必填 说明
userNo String 员工编号(长度10)
merchantId String 企业编号(长度10)
bankCardNo String 新的银行卡号(长度20)
bankCardPhoneNo String 新的银行卡预留手机号(长度15)

返回值:

名称 类型 说明
state String 返回状态
respmsg String 返回信息

3 绑定新提现银行卡

url:/wallet/v1/custom/users/actions/bindBankCard.shtml

请求类型:post

参数:

名称 类型 是否必填 说明
userNo String 员工编号(长度10)
merchantId String 企业编号(长度10)
bankCardNo String 新的银行卡号(长度20)
bankCardPhoneNo String 新的银行卡预留手机号(长度15)

返回值:

名称 类型 说明
state String 返回状态
respmsg String 返回信息

4 支持的银行列表

url:/wallet/v1/custom/banks.shtml

请求类型:post

返回值:

名称 类型 说明
state String 返回状态
respmsg String 返回信息
bankList Object String bankBrhName; 银行名称 String bankno; 银行编号 String bankpic; 银行图标

创建银行企业账户

1 企业开户

url:/wallet/v1/custom/merchants/actions/register.shtml

请求类型:post

参数:

名称 类型 是否必填 说明
merchantId String 渠道唯一标识编号(长度10)
userNo String 企业渠道id(长度10)
companyName String 公司名称(长度50)
egalPerson String 公司法人(长度50)
egalPersonCertNo String 公司法人身份证号(长度18)
contactor String 联系人(长度50)
contactorMobile String 联系人手机号(长度11)
email String 邮箱(长度50)
socialCreditCode String 统一社会信用号(长度50)
expiresEnd String 证件有效期(营业执照)(长度50)
certOrganization String 发证机关(长度50)
contactorAddress String 联系人地址(长度100)
taxRegisterNo String 税务登记号(长度50)
businessLicenseNo String 营业执照号(长度50)
cardNo String 对公账号银行卡号(长度50)
bankCardPhoneNO String 银行预留手机号(长度11)
bankCardProvince String 银行卡开户省(长度20)
bankCardCity String 银行卡开户市(长度20)
bankCardName String 银行卡开户银行名称(长度40)

返回值:

名称 类型 说明
state String 返回状态
respmsg String 返回信息

2 上传扫描信息

url:/wallet/v1/custom/merchants/actions/register/pictures.shtml

请求类型:post

参数:

名称 类型 是否必填 说明
merchantId String 渠道唯一标识(长度10)
userNo String 企业渠道id(长度10)
businessLicenceImg String 营业执照扫描件(base64编码)
identityImg String 公司法人身份证扫描件(base64编码)
openingPermitsImg String 开户许可证扫描件(base64编码)
letterOfAuthorization String 合作企业开户授权委托书扫描件(base64编码)
proxyIdentityImg String 被授权人身份证扫描件(base64编码)

返回值:

名称 类型 说明
state String 返回状态
respmsg String 返回信息

企业账户管理

1 企业余额查询

url:/wallet/v1/custom/users/actions/queryUserBalance.shtml

请求类型:post

参数:

名称 类型 是否必填 说明
merchantId String 渠道编号(长度10)
userNo String 企业编号(长度10)

返回值:

名称 类型 说明
state String 返回状态
respmsg String 返回信息
avail_bal String 余额(元)

2 企业充值

url:/wallet/v1/custom/users/actions/merchantRecharge.shtml

请求类型:post

参数:

名称 类型 是否必填 说明
merchantId String 渠道编号(长度10)
userNo String 企业编号(长度10)
amount String 充值金额(单位:元)
pageRetUrl String 前台回调地址
bgRetUrl String 后台回调地址
orderNo String 订单编号

返回值:

名称 类型 说明
state String 返回状态
respmsg String 返回信息
bankUrl String 返回URL

3 企业提现

url: /wallet/v1/custom/transfers/actions/withdraw.shtml

请求类型:post

参数:

名称 类型 是否必填 说明
merchantId String 渠道编号(长度10)
userNo String 企业编号(长度10)
amount String 提现金额(单位:元)
withDrawTransUrl String 前台回调地址
customOrderNo String 订单号
withDrawBackNotify String 后台通知回调地址

返回值:

名称 类型 说明
state String 返回状态
respmsg String 返回信息
withdrawUrl String 提现链接

4 安全设置

4.1 设置支付密码

url:/wallet/v1/custom/actions/url.shtml

请求类型:post

参数:

名称 类型 是否必填 说明
merchantId String 渠道编号(长度10)
userNo String 企业编号(长度10)
urlType String 1,设置密码
returnSuccUrl String return url(跳转成功页面,长度50)
returnFailUrl String return url(跳转失败页面,长度50)
notityUrl String 后台通知url(长度50)

返回值:

名称 类型 说明
state String 返回状态
respmsg String 返回信息
passwordUrl String 跳转银行设置密码页面

4.2 修改支付密码

url:/wallet/v1/custom/actions/url.shtml

请求类型:post

参数:

名称 类型 是否必填 说明
merchantId String 渠道编号(长度10)
userNo String 企业编号(长度10)
urlType String 2,修改密码
modPwdRedirectUrl String 修改操作完成后跳转页面(长度50)
notityUrl String 后台通知url(长度50)

返回值:

名称 类型 说明
state String 返回状态
respmsg String 返回信息
passwordUrl String 跳转银行设置密码页面

4.3 忘记支付密码

url:/wallet/v1/custom/actions/url.shtml

请求类型:post

参数:

名称 类型 是否必填 说明
merchantId String 渠道编号(长度10)
userNo String 企业编号(长度10)
urlType String 3,重置密码
resetPwdRedirectUrl String 重置操作完成后跳转页面(长度50)
notityUrl String 后台通知url(长度50)

返回值:

名称 类型 说明
state String 返回状态
respmsg String 返回信息
passwordUrl String 跳转银行设置密码页面

6 变更企业电子账户预留手机号

url:/wallet/v1/custom/users/actions/changeCompanyBankPhone.shtml

请求类型:post

参数:

名称 类型 是否必填 说明
merchantId String 渠道编号(长度10)
userNo String 用户编号(长度10)
phoneNo String 新的预留手机号(长度11)

返回值:

名称 类型 说明
state String 返回状态
respmsg String 返回信息

企业转账

1 用户状态查询

url:/wallet/v1/custom/users/status.shtml

请求类型:post

参数:

名称 类型 是否必填 说明
merchantId String 渠道编号(长度10)
userNo String 用户编号(长度10)

返回值:

名称 类型 说明
state String 返回状态
respmsg String 返回信息
userType String 用户类型: 1普通,2商户, 0禁用,-1 待激活,11补全信息,-2商户待激活

2 企业对员工单笔报销

url:/wallet/v1/custom/actions/transfer/singleOut.shtml

请求类型:post

参数:

名称 类型 是否必填 说明
merchantId String 渠道编号(长度10)
userNo String 公司编号(长度10)
targetUserNo String 员工编号(长度10)
amount String 金额(元,精确到两位小数)
forgetpwd_url String 忘记密码链接(长度50)
transaction_url String 失败后返回交易页面链接(长度50)
reback_url String 后台通知(长度50)
successResult_url String 成功后跳转链接(长度50)
orderNo String 订单号(长度20)

返回值:

名称 类型 说明
state String 返回状态
respmsg String 返回信息
bankUrl String 跳转银行页面

2.1 企业对员工单笔报销

url:/wallet/v1/custom/actions/transfer/singleOut/status.shtml

请求类型:post

参数:

名称 类型 是否必填 说明
merchantId String 渠道编号(长度10)
userNo String 公司编号(长度10)
orderNo String 订单号(长度20)

返回值:

名称 类型 说明
state String 返回状态
respmsg String 返回信息
history Object transferRequestNo //魔方订单号 amount //金额(元) creatTime //时间 status//交易状态 statusDesc//状态描述 customOrderNo//渠道订单号

3 企业对员工批量报销

url:/wallet/v1/custom/actions/transfer/batchOut.shtml

请求类型:post

参数:

名称 类型 是否必填 说明
merchantId String 渠道编号(长度10)
userNo String 公司编号(长度10)
orderNo String 订单号(长度20)
batchJson Json 批量资金发放json字符串

返回值:

名称 类型 说明
state String 返回状态
respmsg String 返回信息
successCount Object 成功的条数

4 企业对员工批量报销结果查询

url:/wallet/v1/custom/actions/transfer/batchOut/status.shtml

请求类型:post

参数:

名称 类型 是否必填 说明
merchantId String 渠道编号(长度10)
userNo String 公司编号(长度10)
orderNo String 订单号(长度20)
pageIndex String 页码
pageSize String 每页条数

返回值:

名称 类型 说明
state String 返回状态
respmsg String 返回信息
statusList Object int status //交易状态 1成功,0失败 2待确认 String statusDesc //交易状态描述 String userNo//员工编号
hasNext 布尔 是否有下一页

后台数据接口

1 交易记录

url:/wallet/v1/custom/actions/transfers/histories.shtml

请求类型:post

参数:

名称 类型 是否必填 说明
merchantId String 渠道编号(长度10)
pageIndex String 页码
pageSize String 每页条数

返回值:

名称 类型 说明
historyList List String transferRequestNo,//魔方订单号 String amount,//金额(元) String creatTime,//创建时间 String statusDesc,//状态描述 String scustomOrderNo,//渠道订单号 String tradeName,//交易名称 String userName,//发起方姓名 String targetUserName//接收方姓名
hasNext 布尔 是否有下一页
state String 返回状态
respmsg String 返回信息

接入理财

1 接入理财获取URL

url:/wallet/v1/custom/users/actions/financial/h5url.shtml

请求类型:post

参数:

名称 类型 是否必填 说明
merchantId String 渠道编号(长度10)
userNo String 用户编号(长度10)
pageIndex String 页码
pageSize String 每页条数

返回值:

名称 类型 说明
p2pUrl String 接入固收h5Url(接入会显示)
insuranceUrl String 接入保险h5Url(接入会显示)
fundUrl String 接入基金h5Url(接入会显示)
state String 返回状态
respmsg String 返回信息

电商钱包Server API

账户管理

1 开通钱包

url:/api/v1/standardWallet/openWallet.shtml

请求类型:post

参数:

参数名 含义 长度 可为空 说明
custUid 渠道用户唯一标识 40 必填 渠道用户的唯一编号
custMobile 渠道用户手机号 20 非必填

返回值:参考公共返回值

2 用户概览

url:/api/v1/standardWallet/myAccount.shtml

请求类型:post

参数:

参数名 含义 长度 可为空 说明
custUid 渠道用户唯一标识 40 必填 渠道用户的唯一编号

返回值:

参数名 含义 长度 可为空 说明
totalAmount 账户余额 20 必填 账户余额
autdStatus 是否实名认证 必填 0未认证,1已认证
bindCardStatus 是否绑定银行卡 必填 0未绑定,1已绑定
realName 用户姓名 非必填
userIDno 身份证号 非必填

银行卡设置

1 银行卡设置

url:/api/v1/standardWallet/myCardList.shtml

请求类型:post

参数:

参数名 含义 长度 可为空 说明
custUid 渠道用户唯一标识 40 必填 渠道用户的唯一编号

返回值:

参数名 含义 长度 可为空 说明
cardList 银行卡列表 【列表对象开始】
bankName 银行名称 必填
cardType 卡类型 必填
cardNo 卡号 必填
bankLogo 银行logo图片URL 必填
bindStatus 绑定状态 必填 0绑定失败,1绑定成功
cardList 银行卡列表 【列表对象结束】

2 用户绑定银行卡可选银行列表

url:/api/v1/standardWallet/bankCardList.shtml

请求类型:post

参数:无

返回值:

参数名 含义 长度 可为空 说明
cardList 银行卡列表 【列表对象开始】
bankName 银行名称 必填
bankLogo 银行logo图片URL 必填
dayLimit 单日限额 必填
singleLimit 单笔限额 必填
cardList 银行卡列表 【列表对象结束】

3 获取绑卡验证码

url:/api/v1/standardWallet/bindCardValiCode.shtml

请求类型:post

参数:

参数名 含义 长度 可为空 说明
custUid 渠道用户唯一标识 40 必填 渠道用户的唯一编号
userName 用户姓名 非必填 用户未实名认证时必填
userIDno 身份证号 非必填 用户未实名认证时必填
cardNo 银行卡号 必填
mobileNo 银行预留手机号 必填

返回值:

参数名 含义 长度 可为空 说明
mobileToken 验卡token(令牌) 40 必填

4 用户绑卡

url:/api/v1/standardWallet/bindCard.shtml

请求类型:post

参数:

参数名 含义 长度 可为空 说明
custUid 渠道用户唯一标识 40 必填 渠道用户的唯一编号
mobileToken 验卡token 40 必填
valiCode 短信验证码 必填

返回值:参考公共返回参数

交易管理

1 提现

url:/api/v1/standardWallet/transferOutInfo.shtml

请求类型:post

参数:

参数名 含义 长度 可为空 说明
custUid 渠道用户唯一标识 40 必填 渠道用户的唯一编号

返回值:

参数名 含义 长度 可为空 说明
totalAmount 账户余额 必填
infoList 信息列表(列表开始) 【列表对象开始】
cardNo 银行卡号 必填
outMoney 最大可转出金额 非必填
bankName 银行名称 必填
bankLogo 银行logo图片URL 必填
infoList 信息列表(列表结束) 【列表对象结束】

2 用户提现

url:/api/v1/standardWallet/transferOut.shtml

请求类型:post

参数:

参数名 含义 长度 可为空 说明
custUid 渠道用户唯一标识 40 必填 渠道用户的唯一编号
outMoney 提现金额 必填
valiCode 短信验证码 必填
cardNo 银行卡号 必填
custOrderno 渠道订单号 40 必填 订单号唯一

返回值:

参数名 含义 长度 可为空 说明
jrmfOrderno 金融魔方订单号 必填
outMoney 提现金额 必填
outDate 提现日期 必填
arriveDate 预计到账日期
arriveBankName 到账银行 必填
arrivecardNo 到账卡号 必填

3 充值

url:/api/v1/standardWallet/transferInInfo.shtml

请求类型:post

参数:

参数名 含义 长度 可为空 说明
custUid 渠道用户唯一标识 40 必填 渠道用户的唯一编号

返回值:

参数名 含义 长度 可为空 说明
infoList 信息列表(列表开始) 【列表对象开始】
cardNo 银行卡号 必填
bankName 银行名称 必填
bankLogo 银行logo图片URL 必填
infoList 信息列表(列表结束) 【列表对象结束】

4 用户充值

url:/api/v1/standardWallet/transferIn.shtml

请求类型:post

参数:

参数名 含义 长度 可为空 说明
custUid 渠道用户唯一标识 40 必填 渠道用户的唯一编号
inMoney 充值金额 必填
valiCode 短信验证码 必填
cardNo 银行卡号 必填
custOrderno 渠道订单号 40 必填 订单号唯一

返回值:

参数名 含义 长度 可为空 说明
jrmfOrderno 金融魔方订单号 必填

5 交易明细

url:/api/v1/standardWallet/tradeDetail.shtml

请求类型:post

参数:

参数名 含义 长度 可为空 说明
custUid 渠道用户唯一标识 40 必填 渠道用户的唯一编号
tradeType 交易类型 非必填 0全部,1收入,2支出,3交易成功,4交易失败,默认全部
pageNum 起始页 非必填 默认第一页
pageSize 页大小 非必填 默认每页十条数据

返回值:

参数名 含义 长度 可为空 说明
iListSize 总记录数 必填
tradeList 交易列表 【列表对象开始】
tradeName 交易名称 必填
tradeAmount 交易金额 必填
tradeType 交易类型 必填 1收入,2支出
tradeDate 交易日期 必填 yyyy-MM-dd HH:mm:ss
tradeStatus 交易状态 必填 3交易成功,4交易失败
outBankName 提现银行 非必填 交易类型为提现时必填
outCardNo 提现银行卡号 非必填 交易类型为提现时必填
inBankName 充值银行 非必填 交易类型为充值时必填
inCardNo 充值银行卡号 非必填 交易类型为充值时必填
tradeList 交易列表 【列表对象结束】

获取验证码

url:/api/v1/standardWallet/valiCode.shtml

请求类型:post

参数:

参数名 含义 长度 可为空 说明
custUid 渠道用户唯一标识 40 必填 渠道用户的唯一编号
mobileNo 用户手机号 非必填 为空时将短信验证码发送至开通钱包时的手机号
type 验证码类型 必填 0充值,1提现

返回值:参考公共返回参数

修改用户信息

url:/api/v1/standardWallet/updateCustUser.shtml

请求类型:post

参数:

参数名 含义 长度 可为空 说明
custUid 渠道用户唯一标识 40 必填 渠道用户的唯一编号
custMobile 渠道用户手机号 20 必填
custNickname 渠道用户昵称 40 非必填
custImg 渠道用户头像URL 120 非必填 Base64 编码

返回值:参考公共返回参数

渠道转账至个人帐户

url:/api/v1/standardWallet/transferToUser.shtml

请求类型:post

参数:

参数名 含义 长度 可为空 说明
custUid 渠道用户唯一标识 40 必填 渠道用户的唯一编号
transferAmount 转账金额 20 必填 单位元
custOrderno 渠道订单号 40 必填 订单号唯一
transferDesc 转账说明 100 非必填 备注
custMobile 渠道用户手机号 20 非必填
custNickname 渠道用户昵称 40 非必填
custImg 渠道用户头像URL 120 非必填 Base64 编码

返回值:

参数名 含义 长度 可为空 说明
jrmfOrderno 金融魔方订单号 必填

安全设置

1 设置交易密码

url:/api/v1/standardWallet/setTransPwd.shtml

请求类型:post

参数:

参数名 含义 长度 可为空 说明
custUid 渠道用户唯一标识 40 必填 渠道用户的唯一编号
tranPassword 交易密码 40 必填 加密后的密码

2 重置交易密码

url:/api/v1/standardWallet/reSetTransPwd.shtml

请求类型:post

参数:

参数名 含义 长度 可为空 说明
custUid 渠道用户唯一标识 40 必填 渠道用户的唯一编号
tranPassword 交易密码 40 必填 加密后的密码
newPassword 新交易密码 40 必填 加密后的新密码

3 用户按密码提现

url:/api/v1/standardWallet/transferOutByPwd.shtml

请求类型:post

参数:

参数名 含义 长度 可为空 说明
custUid 渠道用户唯一标识 40 必填 渠道用户的唯一编号
outMoney 提现金额 必填
tranPassword 交易密码 40 必填 加密后的密码
cardNo 银行卡号 必填
custOrderno 渠道订单号 40 必填 订单号唯一

返回值:

参数名 含义 长度 可为空 说明
jrmfOrderno 金融魔方订单号 必填
outMoney 提现金额 必填
outDate 提现日期 必填
arriveDate 预计到账日期 必填
arriveBankName 到账银行 必填
arrivecardNo 到账卡号 必填

个人用户余额支付

url:/api/v1/standardWallet/payUseBalance.shtml

请求类型:post

参数:

参数名 含义 长度 可为空 说明
custUid 渠道用户唯一标识 40 必填 付款用户
amount 付款金额 20 必填 付款金额
custOrderno 渠道订单号 40 必填 渠道唯一订单号
tranPassword 交易密码 40 必填 加密后的交易密码
orderDesc 转账说明 100 非必填 备注

返回值:

参数名 含义 长度 可为空 说明
jrmfOrderno 金融魔方订单号 必填

企业开通钱包

1 开通钱包

url:/api/v1/standardWallet/openMBWallet.shtml

请求类型:post

参数:

参数名 含义 长度 可为空 说明
custUid 渠道企业注册号 40 必填
businessName 渠道企业昵称 40 必填

返回值:参考公共返回参数

2 设置关联手机号

url:/api/v1/standardWallet/setMicroBMobileSendCode.shtml

请求类型:post

参数:

参数名 含义 长度 可为空 说明
custUid 渠道企业注册号 40 必填
mobileNo 手机号 必填

返回值:

参数名 含义 长度 可为空 说明
mobileToken 手机令牌 必填

3 设置关联手机号验证验证码

url:/api/v1/standardWallet/setMicroBMobileValiCode.shtml

请求类型:post

参数:

参数名 含义 长度 可为空 说明
mobileToken 手机令牌 必填
code 验证码 必填
custUid 渠道企业注册号

返回值:参考公共返回信息

企业基本信息

url:/api/v1/standardWallet/microBBaseInfo.shtml

请求类型:post

参数:

参数名 含义 长度 可为空 说明
custUid 渠道企业注册号 40 必填

返回值:

参数名 含义 长度 可为空 说明
balance 账户余额
businessName 企业名称 必填
registrationNo 注册号 必填
mobileNo 手机号 必填
isValiMobile 是否校验手机号 必填
isHasTranPwd 是否设置交易密码 必填

企业账户设置

1 企业账户列表

url:/api/v1/standardWallet/microBAccountList.shtml

请求类型:post

参数:

参数名 含义 长度 可为空 说明
custUid 渠道企业注册号 40 必填

返回值:

参数名 含义 长度 可为空 说明
cardList 银行卡列表 【列表对象开始】
bankName 银行名称 必填
subBranch 支行名称 必填
accountId 账户id 必填
province
city
cardList 银行卡列表 【列表对象结束】

2 企业创建账户

url:/api/v1/standardWallet/createMBAccount.shtml

请求类型:post

参数:

参数名 含义 长度 可为空 说明
custUid 渠道企业注册号 40 必填
accountId 企业账户id 必填
bankName 银行名称 必填
provinceName 必填
cityName 必填
subBranch 支行信息
netLine 联行号

返回值:参考公共返回参数

3 企业修改账户

url:/api/v1/standardWallet/modifyMBAccount.shtml

请求类型:post

参数:

参数名 含义 长度 可为空 说明
custUid 渠道企业注册号 40 必填
subBranch 支行信息
netLine 联行号
accountId 企业账户id 必填
tranPwd 交易密码 必填 需要按照规范加密处理

返回值:

企业安全设置

1 找回交易密码发送验证码

url:/api/v1/standardWallet/mBFindPwdSendCode.shtml

请求类型:post

参数:

参数名 含义 长度 可为空 说明
custUid 渠道企业注册号 40 必填
mobileNo 手机号

返回值:

参数名 含义 长度 可为空 说明
mobileToken 手机令牌 必填

2 找回交易密码验证验证码

url:/api/v1/standardWallet/mBFindPwdValiCode.shtml

请求类型:post

参数:

参数名 含义 长度 可为空 说明
custUid 渠道企业注册号 40 必填
mobileToken 手机令牌 必填
code 验证码 必填
tranPwd 交易密码 必填 需要按照规范加密处理

返回值:参考公共返回参数

3 修改交易密码

url:/api/v1/standardWallet/mBModifyTranPwd.shtml

请求类型:post

参数:

参数名 含义 长度 可为空 说明
custUid 渠道企业注册号 40 必填
oldTranPwd 旧交易密码 必填 需要按照规范加密处理
newTranPwd 新交易密码 必填 需要按照规范加密处理

返回值:参考公共返回参数

4 设置交易密码

url:/api/v1/standardWallet/mBSetTranPwd.shtml

请求类型:post

参数:

参数名 含义 长度 可为空 说明
custUid 渠道企业注册号 40 必填
tranPwd 交易密码 必填 需要按照规范加密处理

返回值:参考公共返回参数

企业提现

url:/api/v1/standardWallet/mBTransferOut.shtml

请求类型:post

参数:

参数名 含义 长度 可为空 说明
custUid 渠道企业注册号 40 必填
money 金额 单位分
accountId 企业账号
tranPwd 交易密码 必填 需要按照规范加密处理

返回值:参考公共返回值