1.1 提现接口
<p>[TOC]</p>
<h5>简要描述</h5>
<ul>
<li>提现，代付接口 (接口有IP白名单限制)</li>
</ul>
<h5>请求URL</h5>
<ul>
<li><code>http://xx.com/api/withdraw/submitorder</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>
<tr>
<td style="text-align: left;">orderid</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>商户唯一订单号<br>[max 40字符]</td>
</tr>
<tr>
<td style="text-align: left;">timestamp</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">int</td>
<td>当前时间戳,10位</td>
</tr>
<tr>
<td style="text-align: left;">money</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">int</td>
<td>提现金额[元]</td>
</tr>
<tr>
<td style="text-align: left;">memberid</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>会员ID 没有请写-1 <br>字符数字下划线*-+ 组成[5-40个字符]</td>
</tr>
<tr>
<td style="text-align: left;">type</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">int</td>
<td>类型<br>[1银行卡 2支付宝 3微信]</td>
</tr>
<tr>
<td style="text-align: left;">realname</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>银行中文名称 <br>如：工商银行 或支付宝<br>请参考附录</td>
</tr>
<tr>
<td style="text-align: left;">bankcode</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>银行代码<br> <br>如：icbc 或alipay</td>
</tr>
<tr>
<td style="text-align: left;">cardid</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>银行卡号或支付宝微信账号</td>
</tr>
<tr>
<td style="text-align: left;">callbackurl</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>商户异步回调通知地址 -1代表不用回调</td>
</tr>
<tr>
<td style="text-align: left;">demotxt</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">string</td>
<td>原样回传文字[0-64个字符]</td>
</tr>
<tr>
<td style="text-align: left;">sign</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>md5签名字符串，具体规则参考签名说明</td>
</tr>
</tbody>
</table>
<h5>提交数据</h5>
<pre><code> {
&quot;merchantid&quot;:&quot;3991585&quot;,
&quot;orderid&quot;:&quot;testorder333544ewrwrw3r2w&quot;,
&quot;timestamp&quot;:1643260309,
&quot;money&quot;:200,
&quot;memberid&quot;:&quot;asfawewwrwrwr&quot;,
&quot;type&quot;:&quot;1&quot;,
&quot;realname&quot;:&quot;张小三&quot;,
&quot;bankname&quot;:&quot;工商银行&quot;,
&quot;bankcode&quot;:&quot;icbc&quot;,
&quot;cardid&quot;:&quot;2302323230131311&quot;,
&quot;callbackurl&quot;:&quot;http://129.1.2.1/youcallurl&quot;,
&quot;demotxt&quot;:&quot;测试订单&quot;,
&quot;sign&quot;:&quot;07c175b3f80f69771e5f33e38ad6f71d&quot;
}</code></pre>
<p><hr></p>
<h5>返回成功参数示例</h5>
<pre><code> {
&quot;code&quot;:&quot;0&quot;,
&quot;msg&quot;:&quot;success&quot;,
&quot;data&quot;:{
&quot;merchantid&quot;:&quot;4636611&quot;,
&quot;orderid&quot;:&quot;100032&quot;,
&quot;money&quot;:&quot;200&quot;,
&quot;realname&quot;:&quot;张小三&quot;,
&quot;cardid&quot;:&quot;2302323230131311&quot;,
&quot;sysorderid&quot;:&quot;202306094872564636611095912&quot;,
&quot;orderQueryUrl&quot;:&quot;http://api.zgyspfwpt.com/cjfpay/optSetpQuery.html?merchantid=4636611&amp;orderid=202306098555124636611104756&amp;timestamp=1686322076&amp;sign=f24122406c3078bd16c8eaabd5d7f23a&quot;
}
}
</code></pre>
<p><hr></p>
<h5>返回失败参数例</h5>
<pre><code> {
&quot;code&quot;:512,
&quot;msg&quot;:&quot;订单号重复&quot;,
&quot;data&quot;:{
&quot;errdata&quot;:&quot;orderid[121232er2242444ewrwrw3r2w]&quot;
}
}
</code></pre>
<h5>返回参数说明</h5>
<table>
<thead>
<tr>
<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;">string</td>
<td>商户号</td>
</tr>
<tr>
<td style="text-align: left;">orderid</td>
<td style="text-align: left;">string</td>
<td>商户订单号</td>
</tr>
<tr>
<td style="text-align: left;">money</td>
<td style="text-align: left;">int</td>
<td>提现金额[元]</td>
</tr>
<tr>
<td style="text-align: left;">realname</td>
<td style="text-align: left;">string</td>
<td>提现人真实姓名</td>
</tr>
<tr>
<td style="text-align: left;">cardid</td>
<td style="text-align: left;">string</td>
<td>提现账号</td>
</tr>
<tr>
<td style="text-align: left;">sysorderid</td>
<td style="text-align: left;">string</td>
<td>平台订单号</td>
</tr>
<tr>
<td style="text-align: left;">orderQueryUrl</td>
<td style="text-align: left;">string</td>
<td>订单进度查看及反馈</td>
</tr>
</tbody>
</table>
<h5>备注</h5>
<ul>
<li>更多返回错误代码请看首页的错误代码描述</li>
</ul>