流程介绍
<h4>订单查询应用场景</h4>
<ol>
<li>调用“<a href="https://www.showdoc.cc/web/#/liantuofu?page_id=633518936832858">主扫支付</a>”、“<a href="https://www.showdoc.cc/web/#/liantuofu?page_id=651360832965895">被扫支付</a>”及“<a href="https://www.showdoc.cc/web/#/liantuofu?page_id=657817618887310">公众号支付</a>”接口后，由于系统、网络或其他原因，未获取到响应消息时，可调用该接口查询支付状态； </li>
<li>调用“<a href="https://www.showdoc.cc/web/#/liantuofu?page_id=658047849212386">订单关单</a>”及“<a href="https://www.showdoc.cc/web/#/liantuofu?page_id=658043997851596">订单撤销</a>”接口后，由于系统、网络或其他原因，未获取到响应消息时，可调用该查询接口查询操作状态；</li>
<li>“<a href="https://www.showdoc.cc/web/#/liantuofu?page_id=633518936832858">主扫支付</a>”正常展示付款二维码后，需要获取用户最终扫码支付的状态时；</li>
<li>“<a href="https://www.showdoc.cc/web/#/liantuofu?page_id=657817618887310">公众号支付</a>”跳转微信/支付宝支付页面后，需要获取用户最终支付状态时；</li>
<li>调用“<a href="https://www.showdoc.cc/web/#/liantuofu?page_id=651360832965895">被扫支付</a>”接口，响应消息中“结果”（subCode）为“USER_PAYING 状态不明”时；</li>
<li>
<p>调用“<a href="https://www.showdoc.cc/web/#/liantuofu?page_id=658025876912528">订单查询</a>”接口返回的交易状态（orderStatus）为“NOTPAY：未支付”时，可间隔一定时间调用该接口继续确认支付结果；</p>
</li>
<li>其他情况下，需要确认某支付订单的支付状态时。</li>
</ol>
<h4>订单查询建议使用频率及规则：</h4>
<ol>
<li>若调用“<a href="https://www.showdoc.cc/web/#/liantuofu?page_id=658025876912528">订单查询</a>”接口未收到响应或返回失败或者的交易状态（orderStatus）为“NOTPAY：支付中”时，则商户可以尝试循环调用（按业务需求间隔1S~5S），或者商户自行建立定时任务调用（如：间隔1S、2S、3S…）若调用五分钟之后依然没有明确支付结果（明确的支付成功（orderStatus= SUCCESS））;</li>
</ol>
<p>限制次数：同一笔订单，一秒不超过1次，一分钟最多60次，每笔每天调用支付检测接口的上限是300次。
<font size="5" color="red"> 此接口必须在支付结果返回后再调用，不要和支付同时调用，会直接导致订单失败。建议收到支付响应后1到2秒后调用订单查询 </BR> </font></p>
<h3>推荐 订单查询检测逻辑</h3>
<p>（ <font size="5" color="green"> 重要必接！！防止客户付款，软件未入账 </BR> </font>）</p>
<h4>- 推荐可设置查询时间120秒，安全检测时间，检测成功可以随时入账。</h4>
<h4>- 软件可以设置订单查询前20秒，不可以取消查询</h4>
<h4>- 查询<60次 前30次1秒1次（如果希望更及时拿到结果可以一秒调用2-3次），之后2秒1次</h4>
<h4>- 客户手动取消查询后，仍可以2秒1次继续查询，直到彻底取消或重新下单</h4>
<h4>- 客户可以随时手动对订单查询，检测到已支付，自动入账。（手动检测入账逻辑）</h4>
<h4>-客户可以对异常订单进行存取，可以随时对订单手动继续检测和入账称为核销入账。；软件可以随时对异常订单检测或删除操作处理</h4>
<p><img src="https://www.showdoc.com.cn/server/api/attachment/visitFile?sign=428c54249a4f252c8735e3667924671d&amp;file=file.png" alt="" /></p>
<h4>-存入异常的订单随时查看手动检测入账或删除</h4>
<p>（<font size="5" color="green"> 重要必接！！防止客户付款，软件未入账 </BR> </font>）
<img src="https://www.showdoc.com.cn/server/api/attachment/visitFile?sign=941bb0a903877d5a9a7dab3e710007b7&amp;file=file.png" alt="" />
<img src="https://www.showdoc.com.cn/server/api/attachment/visitFile?sign=5996aebc45a8c1e130b30d3cea2d5dd0&amp;file=file.png" alt="" />
<img src="https://www.showdoc.com.cn/server/api/attachment/visitFile?sign=e351f726027cad4164c6dab192656eb3&amp;file=file.png" alt="" />
<img src="https://www.showdoc.com.cn/server/api/attachment/visitfile/sign/85d2b50e6c575f688ae0840132259b51" alt="" /></p>
<ol>
<li>目前仅支持针对12月内的订单进行查询（具体查询时间范围，以支付机构为准）。</li>
</ol>
<h4>订单查询状态判断逻辑：</h4>
<p><br/><br/>
<img src="https://www.showdoc.cc/server/api/common/visitfile/sign/c9b1977419f899d5220c917c8ae9d971?showdoc=.jpg" alt="" />
<br/><br/>
订单查询返回消息中，当code=SUCCESS时，表示订单支付成功，订单的支付状态可以查询orderStatus值。</p>
<p>支付状态orderStatus包括以下几个状态：</p>
<ul>
<li>SUCCESS：支付成功</li>
<li>NOTPAY：未支付</li>
<li>REFUND：转入退款</li>
<li>CLOSED：已关单</li>
</ul>
<p>订单查询返回消息中，当code=FAILED时，表示订单支付失败或支付中情况。
如果判断subCode=USER_PAYING 为支付中状态，此时可以循环调用订单查询接口去确定支付状态，避免由于网络、客户没输入完密码等原因造成的假性失败情况。
可根据返回的错误码subCode及对应错误信息subMsg进行提示处理，返回提示框告诉收银员。
不管subCode返回值如何，只要不确定支付状态，都可以再120秒循环调用订单查询，确保客户已支付的状态，可以查询回来正确支付情况，防止客户已支付没有入账的异常情况。
同时失败的订单可以存到异常订单里面，随时让客户检测订单状态，保证检测支付成功可以随时入账。</p>
<h4>常见subCode举例</h4>
<table>
<thead>
<tr>
<th>subCode </th>
<th>subMsg </th>
</tr>
</thead>
<tbody>
<tr>
<td>OPERATOR_ERROR </td>
<td>操作失败</td>
</tr>
<tr>
<td>USER_PAYING</td>
<td>用户支付中</td>
</tr>
<tr>
<td>TRADE_PAY_ERROR</td>
<td>前置返回错误信息</td>
</tr>
<tr>
<td>TRADE_NOT_PAY</td>
<td>订单未支付</td>
</tr>
<tr>
<td>PARAMETER_ERROR</td>
<td>参数错误 </td>
</tr>
<tr>
<td>SYSTEM_ERROR</td>
<td> 系统异常</td>
</tr>
</tbody>
</table>