单笔转账接口
<p>[TOC]</p>
<h5>简要描述</h5>
<ul>
<li>单笔转账到支付宝或银行卡。</li>
</ul>
<h5>请求URL</h5>
<ul>
<li><code>http://后台域名/openapi/v1/transfer</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;">userId</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>用户ID</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;">outOrderNo</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>外部订单号,不可重复</td>
</tr>
<tr>
<td style="text-align: left;">notifyUrl</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>回调通知URL</td>
</tr>
<tr>
<td style="text-align: left;">payMethod</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>付款方式 固定:accountBook</td>
</tr>
<tr>
<td style="text-align: left;">transferMethod</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>转账方式 支付宝:alipay 银行卡:bankcard</td>
</tr>
<tr>
<td style="text-align: left;">amount</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>转账金额,单位:元</td>
</tr>
<tr>
<td style="text-align: left;">payeeInfo</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">object</td>
<td>收款方信息</td>
</tr>
<tr>
<td style="text-align: left;">└acctName</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>收款方姓名</td>
</tr>
<tr>
<td style="text-align: left;">└account</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>收款方账号</td>
</tr>
<tr>
<td style="text-align: left;">remarks</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">string</td>
<td>备注</td>
</tr>
<tr>
<td style="text-align: left;">apiKeySlot</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">number</td>
<td>可空,主API传1,副API传2,默认1</td>
</tr>
</tbody>
</table>
<h5>返回示例</h5>
<pre><code>{
&quot;code&quot;: &quot;0000&quot;,
&quot;msg&quot;: &quot;Success&quot;,
&quot;data&quot;: {
&quot;orderNo&quot;: &quot;P22080361906575958&quot;,
&quot;amount&quot;: &quot;1.00&quot;,
&quot;handlingFee&quot;: &quot;0.01&quot;,
&quot;totalAmount&quot;: &quot;1.01&quot;
}
}</code></pre>
<p>> 若下单成功,则返回 0000,最终是否转账成功请以回调通知为准。</p>
<h5>安全提醒</h5>
<ul>
<li>
<p>接口可能因为网络等因素导致请求超时或响应异常,此时服务器可能收到了转账请求并进行了处理。为了安全起见,对于“请求超时”或“响应异常”的情况,您应该调用 「订单查询接口」 确定一下是否有被处理,而不应该直接当作转账失败处理。</p>
</li>
<li>遇到外部订单号重复错误代码,请谨慎处理,建议检查原因,不要直接当作失败。</li>
</ul>
<h5>常见错误代码</h5>
<table>
<thead>
<tr>
<th>错误代码</th>
<th>说明</th>
</tr>
</thead>
<tbody>
<tr>
<td>1001</td>
<td>外部订单号重复,请检查原因,切勿直接当作失败</td>
</tr>
<tr>
<td>4000</td>
<td>下单失败</td>
</tr>
<tr>
<td>4001</td>
<td>缺少userId</td>
</tr>
<tr>
<td>4002</td>
<td>缺少sign</td>
</tr>
<tr>
<td>4003</td>
<td>参数userId有误</td>
</tr>
<tr>
<td>4004</td>
<td>apiKey未设置</td>
</tr>
<tr>
<td>4005</td>
<td>参数sign不正确</td>
</tr>
<tr>
<td>4006</td>
<td>超出设置的API限额</td>
</tr>
</tbody>
</table>