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 | 订单金额 | Amount | Y | 商户订单总金额;单位:元;必须大于等于0.01,最大18位 |
fundAmount | 需支付金额 | Amount | Y | 用户实际需支付金额;单位:元;必须大于等于0.01,最大18位 |
payTool | 指定支付方式 | String(32) | N | 1. 绑卡支付-BINDCARD;账户绑新卡支付-DIRECTFIRST;2.如商户使用自己的收银台时,此项必传; |
bindCardId | 绑卡ID | String(16) | N | 当商户传入的payTool=BINDCARD时,此项必传 |
merchantExpireTime | 订单有效期 | Int(1,1440) | N | 单位:分钟;其他支付方式:1<=Time<=1440 |
merchantOrderDate | 商户下单时间 | DateTime | Y | 商户服务器记录的下单时间;格式: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端指定支付方式 | 移动端收银台 | 移动端指定支付方式 |
---|---|---|---|---|
绑卡支付-BINDCARD | √ | X | √ | √ |
账户绑新卡支付-DIRECTFIRST | √ | X | √ | √ |
2.4.1.3主动通知:
通知方式:将参数通知到请求时传入的serverCallbackUrl。
通知机制:仅异步通知一次,如通知失败,则每3分钟补偿通知1次,共通知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 | 转账金额 | Amount | Y | 转账金额;单位:元;必须大于等于0.01,最大18位 |
fromUserNo | 转出方编号 | String(32) | Y | 需传商户用户标识,即传merchanUserId |
toUserNo | 转入方编号 | String(32) | Y | 需传商户用户标识,即传merchanUserId |
bindCardId | 绑卡ID | String(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 | 绑卡ID | String(16) | Y | 提现卡的绑卡ID |
amount | 提现金额 | Amount | Y | 提现金额;单位:元;必须大于等于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 | 返回消息 | 返回码的详细说明 |