转账发起
<h1>转账发起接口开发文档</h1>
<h2>一、接口使用前提</h2>
<p>商户需在商户后台开启代付 API 接口开关,方可调用本接口进行转账操作。</p>
<h2>二、接口基本信息</h2>
<ol>
<li><strong>请求地址</strong>:<code>https://pay.lmwa.cn/api/transfer/submit</code></li>
<li><strong>请求方式</strong>:POST</li>
</ol>
<h2>三、请求参数说明</h2>
<table>
<thead>
<tr>
<th>字段名</th>
<th>变量名</th>
<th>必填</th>
<th>类型</th>
<th>示例值</th>
<th>描述</th>
</tr>
</thead>
<tbody>
<tr>
<td>商户 ID</td>
<td>pid</td>
<td>是</td>
<td>Int</td>
<td>1001</td>
<td>商户在支付平台的唯一标识,用于识别发起转账的商户</td>
</tr>
<tr>
<td>转账方式</td>
<td>type</td>
<td>是</td>
<td>String</td>
<td>alipay</td>
<td>指定转账使用的平台,取值参考转账方式列表</td>
</tr>
<tr>
<td>收款方账号</td>
<td>account</td>
<td>是</td>
<td>String</td>
<td>alipay@alipay.com</td>
<td>收款方的账号,根据转账方式不同,可为支付宝账号、微信 OpenId 或银行卡号</td>
</tr>
<tr>
<td>收款方姓名</td>
<td>name</td>
<td>否</td>
<td>String</td>
<td>张三</td>
<td>选填字段,若传入则平台会校验该姓名与收款方账号是否匹配</td>
</tr>
<tr>
<td>转账金额</td>
<td>money</td>
<td>是</td>
<td>String</td>
<td>1.00</td>
<td>转账的具体金额,单位为元</td>
</tr>
<tr>
<td>转账备注</td>
<td>remark</td>
<td>否</td>
<td>String</td>
<td>-</td>
<td>转账时的备注信息,可用于说明转账用途等,选填</td>
</tr>
<tr>
<td>转账交易号</td>
<td>out_biz_no</td>
<td>否</td>
<td>String</td>
<td>2016080615134334917</td>
<td>用于避免重复请求转账,必须为 19 位纯数字,且以日期时间开头。若不传,平台可能按默认规则处理</td>
</tr>
<tr>
<td>当前时间戳</td>
<td>timestamp</td>
<td>是</td>
<td>String</td>
<td>1721206072</td>
<td>10 位整数,单位为秒,用于校验请求时效性</td>
</tr>
<tr>
<td>签名字符串</td>
<td>sign</td>
<td>是</td>
<td>String</td>
<td>-</td>
<td>依据签名规则生成,用于验证请求合法性</td>
</tr>
<tr>
<td>签名类型</td>
<td>sign_type</td>
<td>是</td>
<td>String</td>
<td>RSA</td>
<td>默认采用 RSA 签名算法</td>
</tr>
</tbody>
</table>
<h2>四、返回参数说明</h2>
<table>
<thead>
<tr>
<th>字段名</th>
<th>变量名</th>
<th>类型</th>
<th>示例值</th>
<th>描述</th>
</tr>
</thead>
<tbody>
<tr>
<td>返回状态码</td>
<td>code</td>
<td>Int</td>
<td>0</td>
<td>0 表示转账请求成功提交,其他值表示失败</td>
</tr>
<tr>
<td>错误信息</td>
<td>msg</td>
<td>String</td>
<td>-</td>
<td>转账请求失败时,返回具体的失败原因</td>
</tr>
<tr>
<td>转账状态</td>
<td>status</td>
<td>Int</td>
<td>-</td>
<td>0 表示转账正在处理中,1 表示转账成功。若为 0,需后续调用转账查询接口获取最终状态</td>
</tr>
<tr>
<td>转账交易号</td>
<td>out_biz_no</td>
<td>String</td>
<td>2016080615134334917</td>
<td>商户自定义的转账交易号(若有),可用于后续转账查询</td>
</tr>
<tr>
<td>接口转账单号</td>
<td>orderid</td>
<td>String</td>
<td>40001283951815782</td>
<td>支付宝或微信等平台返回的转账单号</td>
</tr>
<tr>
<td>转账完成时间</td>
<td>paydate</td>
<td>String</td>
<td>2024-07-01 16:47:32</td>
<td>转账成功时的时间,若转账未完成则无此信息</td>
</tr>
<tr>
<td>转账花费金额</td>
<td>cost_money</td>
<td>String</td>
<td>-</td>
<td>从商户可用余额中扣减的转账金额,可能包含手续费</td>
</tr>
<tr>
<td>当前时间戳</td>
<td>timestamp</td>
<td>String</td>
<td>1721206072</td>
<td>10 位整数,单位为秒,与请求中的时间戳对应</td>
</tr>
<tr>
<td>签名字符串</td>
<td>sign</td>
<td>String</td>
<td>-</td>
<td>用于验证返回数据的合法性,参考签名规则</td>
</tr>
<tr>
<td>签名类型</td>
<td>sign_type</td>
<td>String</td>
<td>RSA</td>
<td>默认采用 RSA 签名算法</td>
</tr>
</tbody>
</table>
<h2>五、转账方式列表</h2>
<table>
<thead>
<tr>
<th>状态值</th>
<th>描述</th>
</tr>
</thead>
<tbody>
<tr>
<td>alipay</td>
<td>通过支付宝平台进行转账</td>
</tr>
<tr>
<td>wxpay</td>
<td>通过微信支付平台进行转账</td>
</tr>
<tr>
<td>qqpay</td>
<td>通过 QQ 钱包进行转账</td>
</tr>
<tr>
<td>bank</td>
<td>通过银行卡进行转账</td>
</tr>
</tbody>
</table>