转账查询
<h1>转账查询接口开发文档</h1>
<h2>一、接口概述</h2>
<p>转账查询接口用于查询特定转账交易的状态及详细信息,帮助商户了解转账操作的执行情况,以便进行后续处理。</p>
<h2>二、接口基本信息</h2>
<ol>
<li><strong>请求地址</strong>:<code>https://pay.lmwa.cn/api/transfer/query</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>out_biz_no</td>
<td>是</td>
<td>String</td>
<td>2016080615134334919</td>
<td>在转账接口传入或返回的交易号,通过该交易号定位具体的转账记录进行查询</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 表示转账成功;2 表示转账失败,通过该字段获取转账操作的当前状态</td>
</tr>
<tr>
<td>转账失败原因</td>
<td>errmsg</td>
<td>String</td>
<td>收款方账户异常</td>
<td>当<code>status = 2</code>(转账失败)时返回,详细说明转账失败的具体原因</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>amount</td>
<td>String</td>
<td>-</td>
<td>转账的具体金额,单位为元</td>
</tr>
<tr>
<td>转账花费金额</td>
<td>cost_money</td>
<td>String</td>
<td>-</td>
<td>从商户可用余额中扣减的金额,可能包含手续费等</td>
</tr>
<tr>
<td>转账备注</td>
<td>remark</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>