订单查询API
<h5>接口使用描述</h5>
<h6>查询频次为：同一个订单号，1秒钟调用不超过3次，1分钟内不超过60次，调用频次过高，会终止调用结果，1分钟后会恢复正常返回。同一个订单每天调用支付检测接口的上限是300次</h6>
<h6>本接口为所有支付订单（扫码--被扫、扫码--主扫、公众号）提供查询功能，合作方可以通过该接口主动查询订单（退款单交易除外）交易结果，明确交易结果后进行下一步的业务逻辑，仅支持针对商户12月内的订单进行查询。</h6>
<h3>推荐 订单查询检测逻辑</h3>
<h4>- 可设置循环查询时间120秒</h4>
<h4>- 软件方自主可以设置订单查询前20秒，不可以取消查询</h4>
<h4>- 查询<60次 前15次1秒1次，之后2秒1次</h4>
<h4>- 客户手动取消查询后，仍可以2秒1次继续查询，直到彻底取消或重新下单</h4>
<h4>- 客户可以随时手动对订单查询，检测到已支付，自动入账。（手动检测入账逻辑）</h4>
<h5>接口地址</h5>
<pre><code> 接口地址：https://api.liantuofu.com/open/pay/query</code></pre>
<p><br/></p>
<h4>请求参数<img src='<a href="https://www.showdoc.cc/server/api/common/visitfile/sign/bfc24f8d7eb93fae8e66d4ab2b4bc461?showdoc=.jpg'">https://www.showdoc.cc/server/api/common/visitfile/sign/bfc24f8d7eb93fae8e66d4ab2b4bc461?showdoc=.jpg'</a>; 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>outTradeNo</td>
<td>商户订单号</td>
<td>string(64)</td>
<td>Y</td>
<td>CS100082018050166666</td>
<td>交易订单编号（outTradeNo和outTransactionId必填一个）</td>
</tr>
<tr>
<td>6</td>
<td>outTransactionId</td>
<td>第三方订单号</td>
<td>string(64)</td>
<td>Y</td>
<td>CS100082018050166666</td>
<td>第三方订单号（outTradeNo和outTransactionId必填一个）</td>
</tr>
<tr>
<td>7</td>
<td>operatorId</td>
<td>操作员id（接口客户无需传递）</td>
<td>string</td>
<td>N</td>
<td>1234409009</td>
<td>收银员账号登陆时，登陆返回信息中的操作员ID(收银员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,以便错误信息描述的更加精确 当返回USER_PAYING时表示支付中</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>outTradeNo</td>
<td>商户订单号</td>
<td>string(64)</td>
<td>N</td>
<td>CS100082018050166666</td>
<td>由商户生成的该笔交易的全局唯一ID，商户需确保其唯一性，重新发起一笔支付要使用新订单号，避免重复支付。后续可通过该ID查询对应订单信息。 建议值：公司简称+门店编号+时间戳+序列 支持8-64位数字、英文字母、“-”及“_”，其他字符不支持</td>
</tr>
<tr>
<td>8</td>
<td>orderStatus</td>
<td>交易状态</td>
<td>string</td>
<td>N</td>
<td>NOTPAY</td>
<td>交易状态 NOTPAY未支付 SUCCESS支付成功 REFUND转入退款 CLOSED已关闭 REVOKED已撤销</td>
</tr>
<tr>
<td>9</td>
<td>outTransactionId</td>
<td>第三方商户订单号</td>
<td>string（64）</td>
<td>N</td>
<td>1217752501201407033233368018</td>
<td><strong>该订单号与支付宝、微信支付客户端账单详情显示的商户订单号一致，通过该订单后可发起扫码退款或在支付宝、微信端查询交易。</strong></td>
</tr>
<tr>
<td>10</td>
<td>transactionId</td>
<td>第三方交易号</td>
<td>string（64）</td>
<td>N</td>
<td></td>
<td>第三方内部流水号,需要退款或者对订单有疑问时，方便找第三方排查</td>
</tr>
<tr>
<td>11</td>
<td>payType</td>
<td>支付类型</td>
<td>string</td>
<td>N</td>
<td>WXPAY (WXPAY:微信支付 ALIPAY:支付宝支付 MPAY:会员支付 CASH:现金 UNIONPAY:云闪付 BESTPAY:翼支付)</td>
<td>支付类型 WXPAY:微信支付 ALIPAY:支付宝支付 MPAY：会员支付</td>
</tr>
<tr>
<td>12</td>
<td>totalAmount</td>
<td>订单总金额</td>
<td>double</td>
<td>N</td>
<td>88.88</td>
<td>单位为元，精确到小数点后两位，取值范围[0.01至100000000]</td>
</tr>
<tr>
<td>13</td>
<td>receiptAmount</td>
<td>实收金额</td>
<td>double</td>
<td>N</td>
<td>66.66</td>
<td>单位为元，精确到小数点后两位，取值范围[0.01至100000000</td>
</tr>
<tr>
<td>14</td>
<td>discountAmount</td>
<td>优惠金额</td>
<td>double</td>
<td>N</td>
<td>22.22</td>
<td>单位为元，精确到小数点后两位，取值范围[0.01至100000000</td>
</tr>
<tr>
<td>15</td>
<td>thirdDiscountableAmount</td>
<td>第三方优惠金额</td>
<td>double</td>
<td>N</td>
<td>22.22</td>
<td>第三方优惠金额(微信支付宝官方优惠金额（微信摇一摇红包，支付宝红包等）</td>
</tr>
<tr>
<td>16</td>
<td>merchantFavorAmount</td>
<td>商户第三方优惠金额</td>
<td>double</td>
<td>N</td>
<td>22.22</td>
<td>商户第三方优惠金额(商户在微信支付宝官方发的的优惠金额)</td>
</tr>
<tr>
<td>17</td>
<td>unDiscountableAmount</td>
<td>不打折金额</td>
<td>double</td>
<td>N</td>
<td>22.22</td>
<td>不打折金额</td>
</tr>
<tr>
<td>18</td>
<td>payTime</td>
<td>交易完成时间</td>
<td>string</td>
<td>N</td>
<td></td>
<td>交易完成时间,格式为 yyyyMMddHHmmss</td>
</tr>
<tr>
<td>19</td>
<td>feeAmount</td>
<td>第三方交易手续费（用于计算商户真实到账金额）</td>
<td>double</td>
<td>N</td>
<td></td>
<td>第三方交易手续费（用于计算商户真实到账金额）</td>
</tr>
<tr>
<td>20</td>
<td>buyerId</td>
<td>第三方用户标识(微信支付openid，支付宝支付userid)</td>
<td>string</td>
<td>N</td>
<td></td>
<td>第三方用户标识(微信支付openid，支付宝支付userid)</td>
</tr>
<tr>
<td>21</td>
<td>settleAmount</td>
<td>第三方结算金额（商户真实到账金额）</td>
<td>double</td>
<td>N</td>
<td></td>
<td>第三方交易手续费（用于计算商户真实到账金额）</td>
</tr>
<tr>
<td>22</td>
<td>orderRemark</td>
<td>订单备注</td>
<td>string</td>
<td>N</td>
<td>订单备注</td>
<td>在联拓富后台展示到订单列表里</td>
</tr>
<tr>
<td>23</td>
<td>terminalName</td>
<td>款台名称</td>
<td>string</td>
<td>N</td>
<td>1</td>
<td>款台名称</td>
</tr>
<tr>
<td>24</td>
<td>operatorName</td>
<td>收银员名称</td>
<td>string</td>
<td>N</td>
<td>张三</td>
<td>收银员名称</td>
</tr>
<tr>
<td>25</td>
<td>memberCardNo</td>
<td>会员卡号</td>
<td>string</td>
<td>N</td>
<td>52001452</td>
<td>会员卡号</td>
</tr>
<tr>
<td>26</td>
<td>memberLevel</td>
<td>会员等级</td>
<td>string</td>
<td>N</td>
<td>普通</td>
<td>会员等级</td>
</tr>
<tr>
<td>27</td>
<td>memberName</td>
<td>会员名</td>
<td>string</td>
<td>N</td>
<td>李四</td>
<td>会员名</td>
</tr>
<tr>
<td>28</td>
<td>mobile</td>
<td>会员手机号</td>
<td>string</td>
<td>N</td>
<td>15718852451</td>
<td>会员手机号</td>
</tr>
<tr>
<td>29</td>
<td>memberbalance</td>
<td>会员余额</td>
<td>string</td>
<td>N</td>
<td>155</td>
<td>会员余额</td>
</tr>
<tr>
<td>30</td>
<td>memberPoint</td>
<td>会员积分</td>
<td>string</td>
<td>N</td>
<td>155</td>
<td>会员积分</td>
</tr>
<tr>
<td>31</td>
<td>memberPayOrderNo</td>
<td>会员支付订单号</td>
<td>string</td>
<td>N</td>
<td>15555555555</td>
<td>会员支付订单号（充值并支付的订单返）</td>
</tr>
<tr>
<td>32</td>
<td>memberPayOrderStatus</td>
<td>会员支付订单交易状态</td>
<td>string</td>
<td>N</td>
<td>SUCCESS</td>
<td>NOTPAY未支付 SUCCESS支付成功 REFUND转入退款 CLOSED已关闭 REVOKED已撤销（充值并支付的订单返）</td>
</tr>
<tr>
<td>33</td>
<td>memberPayAmount</td>
<td>会员支付金额</td>
<td>string</td>
<td>N</td>
<td>15</td>
<td>会员支付金额（充值并支付的订单返）</td>
</tr>
<tr>
<td>34</td>
<td>memberPayDiscountAmount</td>
<td>会员支付优惠金额</td>
<td>string</td>
<td>N</td>
<td>15</td>
<td>会员支付优惠金额（充值并支付的订单返）</td>
</tr>
<tr>
<td>35</td>
<td>memberPayReceiptAmount</td>
<td>会员支付实收金额</td>
<td>string</td>
<td>N</td>
<td>15</td>
<td>会员支付实收金额 （充值并支付的订单返）</td>
</tr>
<tr>
<td>36</td>
<td>memberPayTime</td>
<td>会员交易完成时间</td>
<td>string</td>
<td>N</td>
<td>20180719144533</td>
<td>会员交易完成时间,格式为 yyyyMMddHHmmss （充值并支付的订单返）</td>
</tr>
<tr>
<td>37</td>
<td>orderActivitys</td>
<td>订单优惠活动</td>
<td>array</td>
<td>N</td>
<td></td>
<td>订单优惠活动</td>
</tr>
<tr>
<td>38</td>
<td>orderCoupons</td>
<td>订单优惠券</td>
<td>array</td>
<td>N</td>
<td></td>
<td>订单优惠券</td>
</tr>
</tbody>
</table>
<hr />
<h4>orderActivitys</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>orderNo</td>
<td>订单编号</td>
<td>string</td>
<td>N</td>
<td></td>
<td>订单编号</td>
</tr>
<tr>
<td>2</td>
<td>activityId</td>
<td>活动id</td>
<td>string</td>
<td>N</td>
<td></td>
<td>活动id</td>
</tr>
<tr>
<td>3</td>
<td>activityName</td>
<td>活动名称</td>
<td>string</td>
<td>N</td>
<td></td>
<td>活动名称</td>
</tr>
<tr>
<td>4</td>
<td>activityChannel</td>
<td>优惠券来源</td>
<td>int</td>
<td>N</td>
<td>1</td>
<td>优惠券来源 0系统 1微信 2支付宝</td>
</tr>
<tr>
<td>5</td>
<td>activityType</td>
<td>活动类型</td>
<td>int</td>
<td>N</td>
<td></td>
<td>活动类型 7折扣 8满减</td>
</tr>
<tr>
<td>6</td>
<td>discountAmount</td>
<td>活动优惠金额</td>
<td>number</td>
<td>N</td>
<td></td>
<td>活动优惠金额</td>
</tr>
<tr>
<td>7</td>
<td>actualDiscountAmount</td>
<td>活动实际优惠金额</td>
<td>number</td>
<td>N</td>
<td></td>
<td>活动实际优惠金额</td>
</tr>
<tr>
<td>8</td>
<td>createTime</td>
<td>参与活动时间</td>
<td>string</td>
<td>N</td>
<td></td>
<td>参与活动时间</td>
</tr>
</tbody>
</table>
<hr />
<h4>orderCoupons</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>orderNo</td>
<td>订单编号</td>
<td>string</td>
<td>N</td>
<td></td>
<td>订单编号</td>
</tr>
<tr>
<td>2</td>
<td>couponNo</td>
<td>优惠券编号</td>
<td>string</td>
<td>N</td>
<td></td>
<td>优惠券编号</td>
</tr>
<tr>
<td>3</td>
<td>consumStatus</td>
<td>核销状态</td>
<td>int</td>
<td>N</td>
<td></td>
<td>核销状态 0未核销1已核销2核销失败</td>
</tr>
<tr>
<td>4</td>
<td>couponChannel</td>
<td>优惠券来源</td>
<td>int</td>
<td>N</td>
<td>1</td>
<td>优惠券来源 0系统 1微信 2支付宝</td>
</tr>
<tr>
<td>5</td>
<td>couponName</td>
<td>优惠券名称</td>
<td>string</td>
<td>N</td>
<td></td>
<td>优惠券名称</td>
</tr>
<tr>
<td>6</td>
<td>couponType</td>
<td>优惠券类型 * 系统</td>
<td>int</td>
<td>N</td>
<td></td>
<td>优惠券类型 <em> 系统：0代金券 1折扣券 2兑换券 3优惠券 4团购券 5单品代金券,7单品折扣 8单品特价券 9全场满减券 </em> 非系统：0全场 1单品</td>
</tr>
<tr>
<td>7</td>
<td>discountAmount</td>
<td>优惠券优惠金额</td>
<td>number</td>
<td>N</td>
<td></td>
<td>优惠券优惠金额</td>
</tr>
<tr>
<td>8</td>
<td>actualDiscountAmount</td>
<td>优惠券金额</td>
<td>number</td>
<td>N</td>
<td></td>
<td>优惠券金额</td>
</tr>
<tr>
<td>9</td>
<td>consumTime</td>
<td>核销时间</td>
<td>string</td>
<td>N</td>
<td></td>
<td>核销时间</td>
</tr>
</tbody>
</table>
<p><br/><br/></p>
<h5>请求示例:</h5>
<pre><code>outTradeNo=2018072517090001&amp;operatorId=10181383&amp;sign=bf5f062f783dea701f32e651788697c6&amp;appId=SC_I5640724439&amp;random=6666666666666666666&amp;merchantCode=SC_I2528987310</code></pre>
<h5>响应示例（成功）：</h5>
<pre><code class="language-json">{
&quot;code&quot;:&quot;SUCCESS&quot;,
&quot;msg&quot;:&quot;订单已支付&quot;,
&quot;random&quot;:&quot;123&quot;,
&quot;sign&quot;:&quot;3d174d93e753073078cd223dabb7e8fb&quot;,
&quot;outTradeNo&quot;:&quot;2018071914444788207030&quot;,
&quot;transactionId&quot;:&quot;4200000138201807192930525029&quot;,
&quot;outTransactionId&quot;:&quot;1807181506573740001231389&quot;,
&quot;buyerId&quot;:&quot;oHucvvzUVgZwxUm2Pdw7nNGc2IhA&quot;,
&quot;payType&quot;:&quot;WXPAY&quot;,
&quot;orderStatus&quot;:&quot;SUCCESS&quot;,
&quot;totalAmount&quot;:10,
&quot;receiptAmount&quot;:10,
&quot;discountAmount&quot;:0,
&quot;feeAmount&quot;:0.05,
&quot;payTime&quot;:&quot;20180719144533&quot;
}</code></pre>
<h5>响应示例（失败）：</h5>
<pre><code class="language-json">{
&quot;code&quot;:&quot;FAILED&quot;,
&quot;msg&quot;:&quot;支付失败&quot;,
&quot;outTradeNo&quot;:&quot;2018010101&quot;,
&quot;payType&quot;:&quot;WXPAY&quot;,
&quot;subCode&quot;:&quot;SYSTEMERROR&quot;,
&quot;subMsg&quot;:&quot;支付结果失败&quot;,
&quot;totalAmount&quot;:10,
&quot;transactionId&quot;:&quot;4200000008201711083273098279&quot;
}</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>