账单查询
<h5>接口使用描述</h5>
<pre><code>商家服务器端选择起始时间和终止时间（时间跨度30天以内）以及相关的过滤条件，将这些参数发送给联拓富支付平台，联拓富支付平台将会返回符合条件的订单交易明细（对账单）。</code></pre>
<h5>接口地址</h5>
<pre><code> 接口地址：http(s)://api.liantuofu.com/open/bill</code></pre>
<p><br/></p>
<h4>请求参数<img src='https://www.showdoc.cc/server/api/common/visitfile/sign/bfc24f8d7eb93fae8e66d4ab2b4bc461?showdoc=.jpg' align='right' style=' width:300px;height:100 px'/></h4>
<table>
<thead>
<tr>
<th><strong>NO</strong></th>
<th><strong>字段</strong></th>
<th><strong>名称</strong></th>
<th><strong>长度</strong></th>
<th><strong>必填</strong></th>
<th><strong>示例</strong></th>
<th><strong>说明</strong></th>
</tr>
</thead>
<tbody>
<tr>
<td>1</td>
<td>appId</td>
<td>合作方标识</td>
<td>string</td>
<td>Y</td>
<td>EW_N2949193174</td>
<td>合作商户编码，用于以后所有接口发起请求时验签使用</td>
</tr>
<tr>
<td>2</td>
<td>sign</td>
<td>签名。具体参见“<a href="https://www.showdoc.cc/web/#/liantuofu?page_id=673453270295568">签名规则</a>”</td>
<td>string</td>
<td>Y</td>
<td>1b70687c8a4c72f50c749baf95a482c0</td>
<td>MD5加密验签值。具体参见“<a href="https://www.showdoc.cc/web/#/liantuofu?page_id=673453270295568">签名规则</a>”</td>
</tr>
<tr>
<td>3</td>
<td>random</td>
<td>随机数</td>
<td>string</td>
<td>Y</td>
<td>123</td>
<td>用来增加加密验签的复杂度，长度不限制，只限制传递数字，不支持中文，字母，特殊符号。</td>
</tr>
<tr>
<td>4</td>
<td>merchantCode</td>
<td>门店编号</td>
<td>string</td>
<td>Y</td>
<td>EW_N9479011740</td>
<td>门店编号，用于后续接口请求参数的使用</td>
</tr>
<tr>
<td>5</td>
<td>billBeginTime</td>
<td>查询开始时间</td>
<td>string</td>
<td>Y</td>
<td>20180701000000</td>
<td>查询开始时间,格式为 yyyyMMddHHmmss</td>
</tr>
<tr>
<td>6</td>
<td>billEndTime</td>
<td>查询结束时间</td>
<td>string</td>
<td>Y</td>
<td>20180720235959</td>
<td>查询结束时间,格式为 yyyyMMddHHmmss</td>
</tr>
<tr>
<td>7</td>
<td>pageNumber</td>
<td>当前页数, 默认为1</td>
<td>int</td>
<td>N</td>
<td>1</td>
<td>当前页数, 默认为1</td>
</tr>
<tr>
<td>8</td>
<td>pageSize</td>
<td>每页记录数, 如果不指定默认为20</td>
<td>int</td>
<td>N</td>
<td>20</td>
<td>每页记录数, 如果不指定默认为20</td>
</tr>
<tr>
<td>9</td>
<td>outTradeNo</td>
<td>商户订单号</td>
<td>string</td>
<td>N</td>
<td>CS100082018050166666</td>
<td>由商户生成的该笔交易的全局唯一ID，商户需确保其唯一性，重新发起一笔支付要使用原订单号，避免重复支付。后续可通过该ID查询对应订单信息。 建议值：公司简称+门店编号+时间戳+序列 支持8-64位数字、英文字母、“-”及“_”，其他字符不支持</td>
</tr>
<tr>
<td>10</td>
<td>outTransactionId</td>
<td>第三方商户订单号</td>
<td>string</td>
<td>N</td>
<td>1217752501201407033233368018</td>
<td><strong>该订单号与支付宝、微信支付客户端账单详情显示的商户订单号一致，通过该订单后可发起扫码退款或在支付宝、微信端查询交易。</strong></td>
</tr>
<tr>
<td>11</td>
<td>transactionId</td>
<td>第三方交易号</td>
<td>string</td>
<td>N</td>
<td></td>
<td>第三方内部流水号,需要退款或者对订单有疑问时，方便找第三方排查</td>
</tr>
<tr>
<td>12</td>
<td>payType</td>
<td>支付类型</td>
<td>string</td>
<td>N</td>
<td>WXPAY</td>
<td>支付类型 WXPAY:微信支付 ALIPAY:支付宝支付 MPAY：会员支付</td>
</tr>
<tr>
<td>13</td>
<td>orderStatus</td>
<td>订单交易状态</td>
<td>string</td>
<td>N</td>
<td>NOTPAY</td>
<td>交易状态 NOTPAY未支付 SUCCESS支付成功 REFUND转入退款 CLOSED已关</td>
</tr>
<tr>
<td>14</td>
<td>operatorId</td>
<td>操作员id（接口客户无需传递）</td>
<td>string</td>
<td>N</td>
<td>1234409009</td>
<td>收银员账号登陆时，登陆返回信息中的操作员ID(收银员ID)</td>
</tr>
<tr>
<td>15</td>
<td>terminalId</td>
<td>款台id</td>
<td>string</td>
<td>N</td>
<td>款台id</td>
<td>款台id</td>
</tr>
</tbody>
</table>
<hr />
<h4>响应参数</h4>
<table>
<thead>
<tr>
<th><strong>NO</strong></th>
<th><strong>字段</strong></th>
<th><strong>名称</strong></th>
<th><strong>长度</strong></th>
<th><strong>必填</strong></th>
<th><strong>示例</strong></th>
<th><strong>说明</strong></th>
</tr>
</thead>
<tbody>
<tr>
<td>1</td>
<td>code</td>
<td>结果</td>
<td>string</td>
<td>Y</td>
<td>SUCCESS</td>
<td>查询交易结果 SUCCESS：表示查询成功FAILED：表示查询失败</td>
</tr>
<tr>
<td>2</td>
<td>msg</td>
<td>结果描述</td>
<td>string</td>
<td>Y</td>
<td>登陆成功</td>
<td>无论是成功或者失败，message都会针对于当前的结果返回响应的结果描述</td>
</tr>
<tr>
<td>3</td>
<td>subCode</td>
<td>错误代码</td>
<td>string</td>
<td>N</td>
<td>LOGIN_ERROR</td>
<td>如果code为FAILED，subcode会返回详细的错误code,以便错误信息描述的更加精确</td>
</tr>
<tr>
<td>4</td>
<td>subMsg</td>
<td>错误描述</td>
<td>string</td>
<td>N</td>
<td>EW_N2320993253</td>
<td>如果code为FAILED，subMsg会返回详细的错误描述,以便错误信息描述的更加精确</td>
</tr>
<tr>
<td>5</td>
<td>sign</td>
<td>签名</td>
<td>string</td>
<td>Y</td>
<td>1b70687c8a4c72f50c749baf95a482c0</td>
<td>请求时传递的sign</td>
</tr>
<tr>
<td>6</td>
<td>random</td>
<td>随机数</td>
<td>string</td>
<td>Y</td>
<td>123</td>
<td>请求时传递的随机数</td>
</tr>
<tr>
<td>7</td>
<td>totalCount</td>
<td>全部记录数</td>
<td>int</td>
<td>N</td>
<td>10</td>
<td>全部记录数</td>
</tr>
<tr>
<td>8</td>
<td>totalPage</td>
<td>全部页数</td>
<td>int</td>
<td>N</td>
<td>8</td>
<td>全部页数</td>
</tr>
<tr>
<td>9</td>
<td>pageNumber</td>
<td>当前页数</td>
<td>int</td>
<td>N</td>
<td>2</td>
<td>当前页数</td>
</tr>
<tr>
<td>10</td>
<td>orderDetails</td>
<td>订单详情列表</td>
<td>array</td>
<td>N</td>
<td>订单详情列表</td>
<td>订单详情列表</td>
</tr>
</tbody>
</table>
<h4>orderDetails</h4>
<table>
<thead>
<tr>
<th><strong>NO</strong></th>
<th><strong>字段</strong></th>
<th><strong>名称</strong></th>
<th><strong>长度</strong></th>
<th><strong>必填</strong></th>
<th><strong>示例</strong></th>
<th><strong>说明</strong></th>
</tr>
</thead>
<tbody>
<tr>
<td>1</td>
<td>outTradeNo</td>
<td>商户订单号</td>
<td>string</td>
<td>N</td>
<td>CS100082018050166666</td>
<td>由商户生成的该笔交易的全局唯一ID，商户需确保其唯一性，重新发起一笔支付要使用原订单号，避免重复支付。后续可通过该ID查询对应订单信息。 建议值：公司简称+门店编号+时间戳+序列 支持8-64位数字、英文字母、“-”及“_”，其他字符不支持</td>
</tr>
<tr>
<td>2</td>
<td>orderStatus</td>
<td>交易状态</td>
<td>string</td>
<td>N</td>
<td>NOTPAY</td>
<td>交易状态 NOTPAY未支付 SUCCESS支付成功 REFUND转入退款 CLOSED已关</td>
</tr>
<tr>
<td>3</td>
<td>outTransactionId</td>
<td>第三方商户订单号</td>
<td>string</td>
<td>N</td>
<td>1217752501201407033233368018</td>
<td><strong>该订单号与支付宝、微信支付客户端账单详情显示的商户订单号一致，通过该订单后可发起扫码退款或在支付宝、微信端查询交易。</strong></td>
</tr>
<tr>
<td>4</td>
<td>transactionId</td>
<td>第三方交易号</td>
<td>string</td>
<td>N</td>
<td></td>
<td>第三方内部流水号,需要退款或者对订单有疑问时，方便找第三方排查</td>
</tr>
<tr>
<td>5</td>
<td>payType</td>
<td>支付类型</td>
<td>string</td>
<td>N</td>
<td>WXPAY</td>
<td>支付类型 WXPAY:微信支付 ALIPAY:支付宝支付 MPAY：会员支付</td>
</tr>
<tr>
<td>6</td>
<td>totalAmount</td>
<td>订单总金额</td>
<td>double</td>
<td>N</td>
<td>88.88</td>
<td>单位为元，精确到小数点后两位，取值范围[0.01至100000000]</td>
</tr>
<tr>
<td>7</td>
<td>receiptAmount</td>
<td>实收金额</td>
<td>double</td>
<td>N</td>
<td>66.66</td>
<td>单位为元，精确到小数点后两位，取值范围[0.01至100000000</td>
</tr>
<tr>
<td>8</td>
<td>discountAmount</td>
<td>优惠金额</td>
<td>double</td>
<td>N</td>
<td>22.22</td>
<td>单位为元，精确到小数点后两位，取值范围[0.01至100000000</td>
</tr>
<tr>
<td>9</td>
<td>payTime</td>
<td>交易完成时间</td>
<td>string</td>
<td>N</td>
<td></td>
<td>交易完成时间,格式为 yyyyMMddHHmmss</td>
</tr>
<tr>
<td>10</td>
<td>feeAmount</td>
<td>第三方交易手续费（用于计算商户真实到账金额）</td>
<td>double</td>
<td>N</td>
<td></td>
<td>第三方交易手续费（用于计算商户真实到账金额）</td>
</tr>
<tr>
<td>11</td>
<td>buyerId</td>
<td>第三方用户标识(微信支付openid，支付宝支付userid)</td>
<td>string</td>
<td>N</td>
<td></td>
<td>第三方用户标识(微信支付openid，支付宝支付userid)</td>
</tr>
<tr>
<td>12</td>
<td>settleAmount</td>
<td>第三方结算金额（商户真实到账金额）</td>
<td>double</td>
<td>N</td>
<td></td>
<td>第三方交易手续费（用于计算商户真实到账金额）</td>
</tr>
<tr>
<td>13</td>
<td>refundAmount</td>
<td>退款金额</td>
<td>double</td>
<td>N</td>
<td>66.66</td>
<td>微信支付退款支持单笔交易分多次退款,申请退款总金额不能超过订单金额, 单位为元，支持两位小数</td>
</tr>
<tr>
<td>14</td>
<td>merchantCode</td>
<td>商户编号</td>
<td>string</td>
<td>N</td>
<td>EW_N947901174</td>
<td>商户编号，用于后续接口请求参数的使用</td>
</tr>
<tr>
<td>15</td>
<td>merchantName</td>
<td>商户名称</td>
<td>string</td>
<td>N</td>
<td>小精灵门店1</td>
<td>当前登陆账号对应的门店简称，开通门店时填写的值，可以用来显示在页面上来区分当前门店</td>
</tr>
<tr>
<td>16</td>
<td>orderRemark</td>
<td>订单备注</td>
<td>string</td>
<td>Y</td>
<td>订单备注</td>
<td>在联拓富后台展示到订单列表里</td>
</tr>
</tbody>
</table>
<p><br/><br/></p>
<h5>请求示例:</h5>
<pre><code>billBeginTime=20180725090012&billEndTime=20180725174012&pageNumber=&pageSize=&outTradeNo=&payType=&orderStatus=&operatorId=10181383&sign=2ecf5874777ea1807916e4272a79a538&appId=SC_I5640724439&random=6666666666666666666&merchantCode=SC_I2528987310</code></pre>
<h5>响应示例（成功）：</h5>
<pre><code class="language-json">{
"code":"SUCCESS",
"msg":"查询成功",
"random":"123",
"sign":"a4770ec9de86518857f33dc0d592484f",
"totalCount":4,
"totalPage":1,
"pageNumber":1,
"orderDetails":[
{
"outTradeNo":"2018072018000041950362",
"transactionId":"4200000128201807207793234608",
"outTransactionId":"1807201450102450001231816",
"buyerId":"oHucvvzUVgZwxUm2Pdw7nNGc2IhA",
"payType":"WXPAY",
"orderStatus":"SUCCESS",
"totalAmount":0.01,
"receiptAmount":0.01,
"discountAmount":0,
"refundAmount":0,
"feeAmount":0,
"settleAmount":0.01,
"payTime":"20180720180046",
"merchantCode":"EW_N4823909784",
"merchantName":"撒露方庄店"
}
]
}</code></pre>
<h5>响应示例（失败）：</h5>
<pre><code class="language-json">{
"code":"FAILED",
"msg":"支付失败",
"outTradeNo":"2018010101",
"payType":"WXPAY",
"subCode":"SYSTEMERROR",
"subMsg":"支付结果失败",
"totalAmount":10,
"transactionId":"4200000008201711083273098279"
}</code></pre>
<h5>错误码</h5>
<table>
<thead>
<tr>
<th>错误码</th>
<th>错误描述</th>
<th>建议处理</th>
</tr>
</thead>
<tbody>
<tr>
<td>SYSTEMERROR</td>
<td>支付结果失败</td>
<td>找联拓富技术查询</td>
</tr>
</tbody>
</table>