代付
<p>[TOC]</p>
<h3>注意:接口请求地址请联系客服索要</h3>
<h1>1、入库接口</h1>
<h5>请求URL</h5>
<ul>
<li><code>http://xxxxxxxxxx/api/insertOrderRecord</code></li>
</ul>
<h5>请求方式</h5>
<ul>
<li>POST</li>
</ul>
<h5>参数</h5>
<table>
<thead>
<tr>
<th style="text-align: left;">参数名</th>
<th style="text-align: left;">必选</th>
<th style="text-align: left;">类型</th>
<th>说明</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">merchantFlow</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>唯一商户订单号,最长120位</td>
</tr>
<tr>
<td style="text-align: left;">merchantId</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">number</td>
<td>商户编号,后台获取</td>
</tr>
<tr>
<td style="text-align: left;">applyAmount</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>结算金额,单位元</td>
</tr>
<tr>
<td style="text-align: left;">bankName</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>收款行名称</td>
</tr>
<tr>
<td style="text-align: left;">bankSubName</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>支行名称</td>
</tr>
<tr>
<td style="text-align: left;">accCard</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>收款卡号</td>
</tr>
<tr>
<td style="text-align: left;">accName</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>收款账户名</td>
</tr>
<tr>
<td style="text-align: left;">belongPro</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>所属省</td>
</tr>
<tr>
<td style="text-align: left;">belongCity</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>所属市</td>
</tr>
<tr>
<td style="text-align: left;">recordType</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">int</td>
<td>订单类型:1充值订单 2:代付订单</td>
</tr>
<tr>
<td style="text-align: left;">timestamps</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>13位时间戳</td>
</tr>
<tr>
<td style="text-align: left;">remark</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">string</td>
<td>备注,如:发工资</td>
</tr>
<tr>
<td style="text-align: left;">sign</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>签名</td>
</tr>
<tr>
<td style="text-align: left;">returnUrl</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">string</td>
<td>回调地址<br/><strong>注意:<br/>该参数不参与签名!!!!<br/>该参数不参与签名!!!!<br/>如果改参数不为空以该参数地址为准,否则以商户默认配置的回调地址为准 </strong></td>
</tr>
</tbody>
</table>
<h5>返回示例</h5>
<pre><code> {
&quot;msg&quot;: &quot;操作成功&quot;,
&quot;code&quot;: 0,
&quot;data&quot;: {
&quot;merchantId&quot;: 100011,
&quot;applyDate&quot;: &quot;2021-07-16 23:39:52&quot;,
&quot;tranFlow&quot;: &quot;T20210716233952165609&quot;
}
}
</code></pre>
<h5>返回参数说明</h5>
<table>
<thead>
<tr>
<th style="text-align: left;">参数</th>
<th style="text-align: left;">类型</th>
<th style="text-align: left;">描述</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">msg</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">操作成功</td>
</tr>
<tr>
<td style="text-align: left;">code</td>
<td style="text-align: left;">int</td>
<td style="text-align: left;">0 成功,非0 失败</td>
</tr>
<tr>
<td style="text-align: left;">- data</td>
<td style="text-align: left;">object</td>
<td style="text-align: left;">集合对象</td>
</tr>
<tr>
<td style="text-align: left;">merchantId</td>
<td style="text-align: left;">number</td>
<td style="text-align: left;">商户ID</td>
</tr>
<tr>
<td style="text-align: left;">applyDate</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">申请时间</td>
</tr>
<tr>
<td style="text-align: left;">tranFlow</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">平台订单号</td>
</tr>
<tr>
<td style="text-align: left;">merchantFlow</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">商户订单号</td>
</tr>
<tr>
<td style="text-align: left;">recordType</td>
<td style="text-align: left;">int</td>
<td style="text-align: left;">订单类型:1充值订单 2:代付订单</td>
</tr>
</tbody>
</table>
<h5>备注</h5>
<p>sign签名方式:所有非空参数按字典序排列,然后以key=value&key=value&....&key=秘钥拼接,如applyAmonut=100.00&merchantId=10001&...key=秘钥,然后MD5后小写即可</p>
<h1>1.1异步回调</h1>
<p>注意事项:
1、异步回调地址需要提前提供给管理员
2、<strong>当服务器下发通知后 未收到返回 success 小写字符串时 将会在1分钟-3分钟-5分钟-10分钟-30分钟-6小时-12小时 执行重试机制,重试次数7次</strong>
3、签名规则
ign签名方式:所有非空参数按字典序排列,然后以key=value&key=value&….&key=秘钥拼接,如 applyAmonut=100.00&merchantId=10001&…key=秘钥,然后MD5后大写即可
4、<strong>注意处理重复通知的情况</strong>
5、回调参数说明:</p>
<table>
<thead>
<tr>
<th style="text-align: left;">参数</th>
<th style="text-align: left;">类型</th>
<th style="text-align: left;">必选</th>
<th style="text-align: left;">描述</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">msg</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">操作成功</td>
</tr>
<tr>
<td style="text-align: left;">code</td>
<td style="text-align: left;">int</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">0000 成功 5000 代付失败,具体原因参照msg</td>
</tr>
<tr>
<td style="text-align: left;">merchantId</td>
<td style="text-align: left;">number</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">商户ID</td>
</tr>
<tr>
<td style="text-align: left;">merchantFlow</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">商户订单号</td>
</tr>
<tr>
<td style="text-align: left;">applyAmount</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">金额</td>
</tr>
<tr>
<td style="text-align: left;">accCard</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">收款卡号</td>
</tr>
<tr>
<td style="text-align: left;">accName</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">收款账户名</td>
</tr>
<tr>
<td style="text-align: left;">bankName</td>
<td style="text-align: left;">String</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">收款行</td>
</tr>
<tr>
<td style="text-align: left;">sign</td>
<td style="text-align: left;">String</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">签名</td>
</tr>
</tbody>
</table>
<h1>2、查单</h1>
<h5>请求URL</h5>
<ul>
<li><code>http://xxxxxx/api/queryOrder</code></li>
</ul>
<h5>请求方式</h5>
<ul>
<li>POST </li>
</ul>
<h5>参数</h5>
<table>
<thead>
<tr>
<th style="text-align: left;">参数名</th>
<th style="text-align: left;">必选</th>
<th style="text-align: left;">类型</th>
<th>说明</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">merchantFlow</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>商户订单号</td>
</tr>
</tbody>
</table>
<h5>返回示例</h5>
<pre><code>|参数|类型|描述|
|:-------|:-------|:-------|
| msg | string| 操作成功 |
| code | int| 0 成功,非0 失败 |
| - data |object | 数据集合 |
| merchantId | number| 商户编号 |
| merchantFlow | string| 商户订单号 |
| accName | string| 收款账户名 |
| bankName | string| 收款行名称 |
| accCard | string| 收款卡号 |
| remark | string| 备注 |
| applyDate | string| 申请日期 |
| flowState | int| 交易状态:1未处理 2已处理 3处理中 4驳回 5:代付失败 详询运营商 |
| rejectMsg |object | 驳回原因/失败原因|
| rejectRemark |object | 驳回备注 flowState=4时不为空 |
| applyAmount | string| 金额 |
</code></pre>
<h5>返回参数说明</h5>
<table>
<thead>
<tr>
<th style="text-align: left;">参数</th>
<th style="text-align: left;">类型</th>
<th style="text-align: left;">描述</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">msg</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">操作成功</td>
</tr>
<tr>
<td style="text-align: left;">code</td>
<td style="text-align: left;">int</td>
<td style="text-align: left;">0 成功,非0 失败</td>
</tr>
<tr>
<td style="text-align: left;">- data</td>
<td style="text-align: left;">object</td>
<td style="text-align: left;">集合对象</td>
</tr>
<tr>
<td style="text-align: left;">merchantId</td>
<td style="text-align: left;">number</td>
<td style="text-align: left;">商户ID</td>
</tr>
<tr>
<td style="text-align: left;">applyDate</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">申请时间</td>
</tr>
<tr>
<td style="text-align: left;">merchantFlow</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">商户订单号</td>
</tr>
<tr>
<td style="text-align: left;">recordType</td>
<td style="text-align: left;">int</td>
<td style="text-align: left;">订单类型:1充值订单 2:代付订单</td>
</tr>
</tbody>
</table>
<h1>3、查询余额</h1>
<h5>请求URL</h5>
<ul>
<li><code>http://xxxxxxx/api/queryBalance</code></li>
</ul>
<h5>请求方式</h5>
<ul>
<li>POST </li>
</ul>
<h5>参数</h5>
<table>
<thead>
<tr>
<th style="text-align: left;">参数名</th>
<th style="text-align: left;">必选</th>
<th style="text-align: left;">类型</th>
<th>说明</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">merchantId</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>商户编号</td>
</tr>
</tbody>
</table>
<h5>返回示例</h5>
<pre><code>|参数|类型|描述|
|:-------|:-------|:-------|
| msg | string| 操作成功 |
| code | int| 0 成功,非0 失败 |
| - data |object | 数据集合 |
| balance | number| 余额 |
| freeze | string| 冻结金额 |
| account | string| 账号 |
| userName | string| 用户名 |
</code></pre>
<h5>返回参数说明</h5>
<table>
<thead>
<tr>
<th style="text-align: left;">参数</th>
<th style="text-align: left;">类型</th>
<th style="text-align: left;">描述</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">msg</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">操作成功</td>
</tr>
<tr>
<td style="text-align: left;">code</td>
<td style="text-align: left;">int</td>
<td style="text-align: left;">0 成功,非0 失败</td>
</tr>
<tr>
<td style="text-align: left;">- data</td>
<td style="text-align: left;">object</td>
<td style="text-align: left;">集合对象</td>
</tr>
<tr>
<td style="text-align: left;">balance</td>
<td style="text-align: left;">number</td>
<td style="text-align: left;">余额</td>
</tr>
<tr>
<td style="text-align: left;">freeze</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">冻结金额</td>
</tr>
<tr>
<td style="text-align: left;">account</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">账号</td>
</tr>
<tr>
<td style="text-align: left;">userName</td>
<td style="text-align: left;">int</td>
<td style="text-align: left;">用户名</td>
</tr>
</tbody>
</table>
<h5>备注</h5>
<p>sign签名方式:所有非空参数按字典序排列,然后以key=value&key=value&....&key=秘钥拼接,如applyAmonut=100.00&merchantId=10001&...key=秘钥,然后MD5后小写即可</p>