1.2 商户资金账户
优质
小牛编辑
129浏览
2023-12-01
1.2 商户资金账户管理
1.2.1商户充值
【场景介绍】
商户将资金充值到账户余额。
| 【重要说明】如使用钱麦收银台，当前此URL仅支持在PC端打开。如在移动端打开，则会报错。 |
|---|
【请求地址】
| 环境 | 接口服务URI |
|---|---|
| 生产环境 | /rest/v1.0/order/merchantRecharge |
1.2.1.1请求参数：
| 参数名称 | 参数含义 | 数据类型 | 必填 | 参数说明 |
|---|---|---|---|---|
| requestNo | 商户请求号 | String(32) | Y | 商户充值请求号；必须在该商户编号下唯一 |
| merchantNo | 商户编号 | String(16) | Y | 商户编号 |
| orderAmount | 订单金额 | Amount | Y | 商户订单总金额；单位：元；必须大于等于0.01，最大18位 |
| payTool | 指定支付方式 | String(32) | N | 1.SALESB2B-网银B2B 2.如商户使用自己的收银台时，此项必传； |
| merchantExpireTime | 订单有效期 | Int(1,1440) | N | 单位：分钟；1<=Time<=1440 |
| merchantOrderDate | 商户下单时间 | DateTime | Y | 商户服务器记录的下单时间；格式：YYYY-MM-DD HH:mm:ss |
| trxExtraInfo | 风控参数 | String(256) | N | 建议按照附件《行业风险字段标准对接》相应行业传输所需字段。 |
| bankCode | 指定银行编码 | String(16) | N | 当指定支付方式传入SALESB2B时，可传入此项，直接跳转对应网银页面。 |
| serverCallbackUrl | 后台服务通知地址 | String(512) | Y | 充值成功后，服务器通知地址 |
| webCallbackUrl | 前端页面通知地址 | String(512) | Y | 跳转商户页面地址 |
1.2.1.2返回参数：
| 参数名称 | 参数含义 | 参数说明 |
|---|---|---|
| requestNo | 商户请求号 | 请求成功后，原值返回 |
| redirectUrl | 支付链接 | 请求成功后返回，返回的链接为钱麦收银台地址,商户需要跳转到此地址以完成后续支付流程 |
| orderAmount | 订单金额 | 请求成功后返回，商户订单总金额；单位：元 |
| fundAmount | 需支付金额 | 请求成功后返回，用户实际需支付金额；单位：元 |
| status | 状态 | 请求成功后返回未支付-UNPAY支付成功-SUCCESS |
| code | 返回码 | 请参考附录：返回码列表 |
| message | 返回消息 | 返回码的详细说明 |
1.2.1.3主动通知：
| 【重要说明】 关于主动通知主要的注意事项，请开发者仔细注意。 |
|---|
通知方式：将参数通知到请求时传入的serverCallbackUrl。
通知机制：仅异步通知一次，如通知失败，则每3分钟补偿通知1次，共通知3次。
通知参数：同4.1.2.2订单查询的返回参数。
1.2.2商户充值查询
请调用4.1.2.2订单查询接口查询
1.2.3商户转账
【场景介绍】
商户的资金转账给用户账户中，用户账户是在本商户下。
【请求地址】
| 环境 | 接口服务URI |
|---|---|
| 生产环境 | /est/v1.0/transfer/merchantTransfer |
1.2.3.1请求参数：
| 参数名称 | 参数含义 | 数据类型 | 必填 | 参数说明 |
|---|---|---|---|---|
| requestNo | 商户请求号 | String（32） | Y | 商户转账请求号； |
| merchantNo | 商户编号 | String（16） | Y | 商户编号 |
|---|---|---|---|---|
| amount | 转账金额 | Amount | Y | 转账金额；单位：元；必须大于等于0.01，最大18位 |
| rechargeRequestNo | 商户充值请求号 | String（32） | N | 商户充值请求号 当toUerType=MEMBER时，此项必传。 |
| toUerType | 转入方类型 | String（16） | Y | 转入方类型： MEMBER-会员 MERCHANT-商户 |
| toUserNo | 转入方编号 | String（32） | Y | 当toUerType=MEMBER时需传商户用户标识，即传merchanUserId； 当toUerType=MERCHANT时需传ledgerNo |
| transferType | 转账类型 | Enum（12） | Y | 转账类型： 账户到账户-USER_TO_USER； |
1.2.3.2返回参数：
| 参数名称 | 参数含义 | 参数说明 |
|---|---|---|
| requestNo | 商户请求号 | 商户转账请求号请求成功后，原值返回 |
| code | 返回码 | 请参考附录：返回码列表 |
| message | 返回消息 | 返回码的详细说明 |
| 【重要说明】商户向用户转账基于商户充值订单,且需要商户充值成功24小时后才可申请转账。 |
|---|
1.2.4转账查询
【场景介绍】
查询转账相关信息和进度。
【请求地址】
| 环境 | 接口服务URI |
|---|---|
| 生产环境 | /rest/v1.0/transfer/merchantQuery |
1.2.4.1请求参数：
| 参数名称 | 参数含义 | 数据类型 | 必填 | 参数说明 |
|---|---|---|---|---|
| merchantNo | 商户编号 | String（16） | Y | 商户编号 |
| transferRequestNo | 商户转账请求号 | String（32） | Y | 商户原转账请求号；必须在该商户编号下唯一 |
1.2.4.2返回参数：
| 参数名称 | 参数含义 | 参数说明 |
|---|---|---|
| fromUserNo | 转出方编号 | 请求成功后返回 |
| toUserNo | 转入方编号 | 请求成功后返回 |
| transferType | 转账类型 | 请求成功后返回USER_TO_USER-账户到账户 |
| status | 转账状态 | 请求成功后返回转账状态：SUCCESS-转账成功FAILURE-转账失败INIT-初始化 |
| amount | 转账金额 | 转账金额；单位：元 |
| code | 返回码 | 请参考附录：返回码列表 |
| message | 返回消息 | 返回码的详细说明 |