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 | 返回消息 | 返回码的详细说明 |