2.4 账户资金服务

优质
小牛编辑
142浏览
2023-12-01

2.4 账户资金服务

2.4.1充值

【场景介绍】

用户使用账户绑定的储蓄卡,将资金充值到用户账户余额。

【调用流程】

【请求地址】

环境接口服务URI
生产环境/rest/v1.0/order/recharge

2.4.1.1请求参数

参数名称参数含义数据类型必填参数说明
requestNo商户请求号String(32)Y商户充值请求号;必须在该商户编号下唯一
merchantNo商户编号String(16)Y商户编号
merchantUserId商户用户标识String(32)Y商户用户唯一编号,必须在该商户编号下唯一
orderAmount订单金额AmountY商户订单总金额;单位:元;必须大于等于0.01,最大18位
fundAmount需支付金额AmountY用户实际需支付金额;单位:元;必须大于等于0.01,最大18位
payTool指定支付方式String(32)N1. 绑卡支付-BINDCARD;账户绑新卡支付-DIRECTFIRST;2.如商户使用自己的收银台时,此项必传;
bindCardId绑卡IDString(16)N当商户传入的payTool=BINDCARD时,此项必传
merchantExpireTime订单有效期Int(1,1440)N单位:分钟;其他支付方式:1<=Time<=1440
merchantOrderDate商户下单时间DateTimeY商户服务器记录的下单时间;格式:YYYY-MM-DD HH:mm:ss
trxExtraInfo风控参数String(256)N建议按照附件《行业风险字段标准对接》相应行业传输所需字段。
serverCallbackUrl后台服务通知地址String(512)Y充值成功后,服务器通知地址
webCallbackUrl前端页面通知地址String(512)Y跳转商户页面地址

2.4.1.2返回参数:

参数名称参数含义参数说明
requestNo商户请求号请求成功后,原值返回
redirectUrl支付链接请求成功后返回,返回的链接为钱麦收银台地址,商户需要跳转到此地址以完成后续支付流程
orderAmount订单金额请求成功后返回,商户订单总金额;单位:元
fundAmount需支付金额请求成功后返回,用户实际需支付金额;单位:元
status状态请求成功后返回未支付-UNPAY支付成功-SUCCESS
code返回码请参考附录:返回码列表
message返回消息返回码的详细说明
【重要说明】

【支付+钱麦各端支持的支付方式列表如下】

支持的支付方式PC端收银台PC端指定支付方式移动端收银台移动端指定支付方式
绑卡支付-BINDCARDX
账户绑新卡支付-DIRECTFIRSTX

2.4.1.3主动通知:

  1. 通知方式:将参数通知到请求时传入的serverCallbackUrl。

  2. 通知机制:仅异步通知一次,如通知失败,则每3分钟补偿通知1次,共通知3次。

  3. 通知参数:同4.1.2.2订单查询的返回参数。

2.4.2转账

【场景介绍】

用户将余额或者绑定银行卡中的资金转账给其他用户账户中,其他用户账户是在本商户下。

【请求地址】

环境接口服务URI
生产环境/rest/v1.0/transfer/transfer

2.4.2.1请求参数:

参数名称参数含义数据类型必填参数说明
requestNo商户请求号String(32)Y商户转账请求号;必须在该商户编号下唯一
merchantNo商户编号String(16)Y商户编号
transferType转账类型Enum(12)Y转账类型:
amount转账金额AmountY转账金额;单位:元;必须大于等于0.01,最大18位
fromUserNo转出方编号String(32)Y需传商户用户标识,即传merchanUserId
toUserNo转入方编号String(32)Y需传商户用户标识,即传merchanUserId
bindCardId绑卡IDString(16)N当转账类型是CARD_TO_USER时必传
token密码验证结果String(32)Y发起转账前需要调用密码校验接口获取验密token

2.4.2.2返回参数:

参数名称参数含义参数说明
requestNo商户请求号商户转账请求号请求成功后,原值返回
code返回码请参考附录:返回码列表
message返回消息返回码的详细说明

2.4.3转账查询

【场景介绍】

查询转账相关信息和进度。

【请求地址】

环境接口服务URI
生产环境/rest/v1.0/transfer/query

2.4.3.1请求参数:

参数名称参数含义数据类型必填参数说明
merchantNo商户编号String(16)Y商户编号
transferRequestNo商户转账请求号String(32)Y商户原转账请求号;必须在该商户编号下唯一

2.4.3.2返回参数:

参数名称参数含义参数说明
fromUserNo转出方编号请求成功后返回
toUserNo转入方编号请求成功后返回
transferType转账类型请求成功后返回转账类型:用户账户到用户账户-USER_TO_USER;用户卡到用户账户-CARD_TO_USER
status转账状态请求成功后返回转账状态:SUCCESS-转账成功FAILURE-转账失败INIT-初始化
amount转账金额转账金额;单位:元
code返回码请参考附录:返回码列表
message返回消息返回码的详细说明

2.4.4提现

【场景介绍】

用户将账户中的余额提现到本人储蓄卡中,提现到账结果异步通知给商户。

【请求地址】

环境接口服务URI
生产环境/rest/v1.0/withdraw/withdraw

2.4.4.1请求参数:

参数名称参数含义数据类型必填参数说明
requestNo商户请求号String(32)Y商户提现请求号;必须在该商户编号下唯一
merchantNo商户编号String(16)Y商户编号
bindCardId绑卡IDString(16)Y提现卡的绑卡ID
amount提现金额AmountY提现金额;单位:元;必须大于等于0.01,最大18位
serverCallbackUrl后台服务通知地址String(512)Y服务器点对点通知地址
token密码验证结果String(32)Y发起转账前需要调用密码校验接口获取验密token
merchantUserId商户用户标识String(32)Y商户用户唯一编号;必须在该商户编号下唯一

2.4.4.2返回参数:

参数名称参数含义参数说明
status提现状态请求成功后返回,提现状态:提现处理中-PROCESS
bankCode银行编码用户提现银行卡的银行编码,请参考附录:银行编码表。
cardLast卡号后四位用户提现银行卡的卡号后四位
code返回码请参考附录:返回码列表
message返回消息返回码的详细说明

2.4.5提现查询

【场景介绍】

用于查询用户提现信息和进度。

【请求地址】

环境接口服务URI
生产环境/rest/v1.0/withdraw/query

2.4.5.1请求参数:

参数名称参数含义数据类型必填参数说明
merchantNo商户编号String(16)Y钱麦商户编号
withdrawRequestNo商户提现请求号String(32)Y原商户提现请求号

2.4.5.2返回参数:

参数名称参数含义参数说明
status提现状态提现状态:处理中-PROCESS提现成功-SUCCESS提现失败-FAILURE
bankCode银行编码用户提现银行卡的银行编码,请参考附录:银行编码表。
cardLast卡号后四位用户提现银行卡的卡号后四位
code返回码请参考附录:返回码列表
message返回消息返回码的详细说明