招联对接文档


1.5 订单查询接口

<h2>订单查询接口</h2> <p><strong>接口地址</strong>:<code>/pay/api/1.0/queryOrder</code></p> <p><strong>请求方式</strong>:<code>POST</code></p> <p><strong>请求数据类型</strong>:<code>application/json</code></p> <p><strong>响应数据类型</strong>:<code>application/json</code></p> <p><strong>接口描述</strong>: 由于不可抗因素导致交易超时,或者状态不明确时,需要商户主动发起交易查询。来确定交易的最终状态。目前系统支持往前查询<code>3</code>日的交易。即<code>T-3到T日</code>的交易才能查询到记录。</p> <p>3日前的交易查询请参考[1.6历史订单查询](<a href="https://www.showdoc.com.cn/jucaishangfu/9965825376511642">https://www.showdoc.com.cn/jucaishangfu/9965825376511642</a> &quot;1.6历史订单查询&quot;)</p> <p><strong>请求示例</strong>:</p> <pre><code class="language-javascript">{ &amp;quot;appId&amp;quot;: &amp;quot;MCH_A698612520&amp;quot;, &amp;quot;mchNo&amp;quot;: &amp;quot;MCH_I293975931&amp;quot;, &amp;quot;mchOrderNo&amp;quot;: &amp;quot;202303271529422244655558&amp;quot;, &amp;quot;sign&amp;quot;: &amp;quot;480f2880dfa2a9d9ec543fdc62386d1b&amp;quot;, &amp;quot;termId&amp;quot;: &amp;quot;12345678&amp;quot;, &amp;quot;wayCode&amp;quot;: &amp;quot;WECHAT&amp;quot; }</code></pre> <p><strong>请求参数</strong>:</p> <table> <thead> <tr> <th>参数名称</th> <th>参数说明</th> <th>请求类型</th> <th>是否必须</th> <th>数据类型</th> <th>schema</th> </tr> </thead> <tbody> <tr> <td>req</td> <td>req</td> <td>body</td> <td>支付订单查询请求实体类</td> <td>支付订单查询请求实体类</td> </tr> <tr> <td>&amp;emsp;&amp;emsp;version</td> <td>版本号</td> <td>false</td> <td>string</td> <td>默认1.0</td> </tr> <tr> <td>&amp;emsp;&amp;emsp;sign</td> <td>签名值</td> <td><code>true</code></td> <td>string</td> <td>详见签名生成算法</td> </tr> <tr> <td>&amp;emsp;&amp;emsp;termId</td> <td>终端id</td> <td><code>true</code></td> <td>string</td> <td>没有真实终端号统一填88888888</td> </tr> <tr> <td>&amp;emsp;&amp;emsp;mchNo</td> <td>商户号</td> <td><code>true</code></td> <td>string</td> <td>招联分配给二级商户的商户号</td> </tr> <tr> <td>&amp;emsp;&amp;emsp;appId</td> <td>应用id</td> <td><code>true</code></td> <td>string</td> <td>商户配置的应用id</td> </tr> <tr> <td>&amp;emsp;&amp;emsp;mchOrderNo</td> <td>商户订单号</td> <td><code>true</code></td> <td>string</td> <td>商户订单号, 商户系统内部的订单号(5到30个字符、 只能包含字母数字下划线,区分大小写)</td> </tr> <tr> <td>&amp;emsp;&amp;emsp;wayCode</td> <td>支付方式</td> <td>false</td> <td>string</td> <td>ALIPAY(统一下单、条码支付、服务窗支付)&lt;br&gt; WECHAT(统一下单、条码支付、公众号支付、小程序)&lt;br&gt; UNIONPAY(银联)</td> </tr> </tbody> </table> <p><strong>响应状态</strong>:</p> <table> <thead> <tr> <th>状态码</th> <th>说明</th> <th>schema</th> </tr> </thead> <tbody> <tr> <td>200</td> <td>OK</td> <td>R«订单查询返回实体»</td> </tr> </tbody> </table> <p>&gt;见[应答码表](<a href="https://www.showdoc.com.cn/jucaishangfu/9966099368299628">https://www.showdoc.com.cn/jucaishangfu/9966099368299628</a> &quot;应答码表&quot;)</p> <p><strong>响应参数</strong>:</p> <table> <thead> <tr> <th>参数名称</th> <th>参数说明</th> <th>类型</th> <th>schema</th> </tr> </thead> <tbody> <tr> <td>code</td> <td>integer(int32)</td> <td>200表示成功 其他表示失败</td> </tr> <tr> <td>data</td> <td>订单查询返回实体</td> <td>订单查询返回实体</td> </tr> <tr> <td>&amp;emsp;&amp;emsp;amount</td> <td>订单金额(分)</td> <td>string</td> </tr> <tr> <td>&amp;emsp;&amp;emsp;buyerId</td> <td>买家在渠道(微信、支付宝)的用户ID</td> <td>string</td> </tr> <tr> <td>&amp;emsp;&amp;emsp;buyerLogonId</td> <td>买家在渠道登录账号</td> <td>string</td> </tr> <tr> <td>&amp;emsp;&amp;emsp;channelOrderId</td> <td>条码流水号</td> <td>string</td> </tr> <tr> <td>&amp;emsp;&amp;emsp;couponFee</td> <td>优惠金额(分)</td> <td>string</td> </tr> <tr> <td>&amp;emsp;&amp;emsp;dealDate</td> <td>交易日期</td> <td>string</td> </tr> <tr> <td>&amp;emsp;&amp;emsp;discountGoodsDetail</td> <td>支付宝交易支付所使用的单品券优惠的商品优惠信息</td> <td>string</td> </tr> <tr> <td>&amp;emsp;&amp;emsp;extParam</td> <td>附加数据</td> <td>string</td> </tr> <tr> <td>&amp;emsp;&amp;emsp;fundBillList</td> <td>支付宝交易资金渠道</td> <td>string</td> </tr> <tr> <td>&amp;emsp;&amp;emsp;fyTermId</td> <td>终端号</td> <td>string</td> </tr> <tr> <td>&amp;emsp;&amp;emsp;hbIsSeller</td> <td>返回值</td> <td>string</td> </tr> <tr> <td>&amp;emsp;&amp;emsp;orgId</td> <td>机构号</td> <td>string</td> </tr> <tr> <td>&amp;emsp;&amp;emsp;isCredit</td> <td>1-表示信用卡或者花呗 0-表示其他(非信用方式) 不填,表示未知</td> <td>string</td> </tr> <tr> <td>&amp;emsp;&amp;emsp;mchNo</td> <td>商户号</td> <td>string</td> </tr> <tr> <td>&amp;emsp;&amp;emsp;mchOrderNo</td> <td>商户订单号</td> <td>string</td> </tr> <tr> <td>&amp;emsp;&amp;emsp;payTime</td> <td>用户支付时间</td> <td>string</td> <td>yyyyMMddHHmmss</td> </tr> <tr> <td>&amp;emsp;&amp;emsp;payType</td> <td>付款方式</td> <td>string</td> </tr> <tr> <td>&amp;emsp;&amp;emsp;promotionDetail</td> <td>微信营销详情</td> <td>string</td> </tr> <tr> <td>&amp;emsp;&amp;emsp;randomStr</td> <td>随机字符串</td> <td>string</td> </tr> <tr> <td>&amp;emsp;&amp;emsp;serviceChargeFlag</td> <td>手续费减免标识</td> <td>string</td> </tr> <tr> <td>&amp;emsp;&amp;emsp;settlementAmt</td> <td>应结算订单金额(分)</td> <td>string</td> <td>单位分,原订单交易金额-官方商户出资金额(包含手续费)</td> </tr> <tr> <td>&amp;emsp;&amp;emsp;paymentAmount</td> <td>实付金额(分)</td> <td>string</td> <td>实付金额=订单金额-优惠金额</td> </tr> <tr> <td>&amp;emsp;&amp;emsp;termId</td> <td>终端号</td> <td>string</td> </tr> <tr> <td>&amp;emsp;&amp;emsp;traceNo</td> <td>系统内部追踪号</td> <td>string</td> </tr> <tr> <td>&amp;emsp;&amp;emsp;transStat</td> <td>交易状态</td> <td>string</td> <td>SUCCESS 成功 PAYERROR 失败 USERPAYING支付中 NOTPAY 未支付 CLOSED 已关闭 REVOKED 已撤销 REFUND 已退款</td> </tr> <tr> <td>&amp;emsp;&amp;emsp;transactionId</td> <td>渠道交易流水号</td> <td>string</td> </tr> <tr> <td>&amp;emsp;&amp;emsp;voucherDetailList</td> <td>支付宝交易支付时所使用的所有优惠券信息</td> <td>string</td> </tr> <tr> <td>&amp;emsp;&amp;emsp;wayCode</td> <td>订单类型</td> <td>string</td> </tr> <tr> <td>msg</td> <td>string</td> </tr> <tr> <td>sign</td> <td>string</td> </tr> </tbody> </table> <p><strong>响应示例</strong>:</p> <pre><code class="language-javascript">{ &amp;quot;code&amp;quot;: 200, &amp;quot;msg&amp;quot;: &amp;quot;SUCCESS&amp;quot;, &amp;quot;data&amp;quot;: { &amp;quot;returnCode&amp;quot;: &amp;quot;000000&amp;quot;, &amp;quot;returnMsg&amp;quot;: &amp;quot;SUCCESS&amp;quot;, &amp;quot;termId&amp;quot;: &amp;quot;263575187&amp;quot;, &amp;quot;randomStr&amp;quot;: &amp;quot;S2JTKV6TPNMOBSQO4SEO5EHD3EDAYGBV&amp;quot;, &amp;quot;orgId&amp;quot;: &amp;quot;ISV_I238002400&amp;quot;, &amp;quot;mchNo&amp;quot;: &amp;quot;MCH_I293975931&amp;quot;, &amp;quot;wayCode&amp;quot;: &amp;quot;WECHAT&amp;quot;, &amp;quot;transStat&amp;quot;: &amp;quot;SUCCESS&amp;quot;, &amp;quot;mchOrderNo&amp;quot;: &amp;quot;202303271529422244655559&amp;quot;, &amp;quot;amount&amp;quot;: &amp;quot;1&amp;quot;, &amp;quot;buyerId&amp;quot;: &amp;quot;oUpF8uAaF7ZBRRpcIlquMHmQ892Q&amp;quot;, &amp;quot;transactionId&amp;quot;: &amp;quot;4200067681202303275321464464&amp;quot;, &amp;quot;extParam&amp;quot;: &amp;quot;&amp;quot;, &amp;quot;dealDate&amp;quot;: &amp;quot;20230327&amp;quot;, &amp;quot;couponFee&amp;quot;: &amp;quot;0&amp;quot;, &amp;quot;buyerLogonId&amp;quot;: &amp;quot;&amp;quot;, &amp;quot;fundBillList&amp;quot;: &amp;quot;&amp;quot;, &amp;quot;traceNo&amp;quot;: &amp;quot;030062147129&amp;quot;, &amp;quot;channelOrderId&amp;quot;: &amp;quot;202303271529422244655559&amp;quot;, &amp;quot;fyTermId&amp;quot;: null, &amp;quot;isCredit&amp;quot;: &amp;quot;0&amp;quot;, &amp;quot;payTime&amp;quot;: &amp;quot;20230327111346&amp;quot;, &amp;quot;settlementAmt&amp;quot;: &amp;quot;1&amp;quot;, &amp;quot;payType&amp;quot;: &amp;quot;OTHERS&amp;quot;, &amp;quot;promotionDetail&amp;quot;: null, &amp;quot;voucherDetailList&amp;quot;: null, &amp;quot;discountGoodsDetail&amp;quot;: null, &amp;quot;hbIsSeller&amp;quot;: null, &amp;quot;serviceChargeFlag&amp;quot;: null }, &amp;quot;sign&amp;quot;: &amp;quot;1ac527b52dcb1638bb92c10bfccbd5d3&amp;quot; }</code></pre>

页面列表

ITEM_HTML