API文档--v1.9


卡券订单查询接口

<h5>接口描述</h5> <ul> <li>接口方向:接入方 → 本平台</li> <li>限速控制:&gt; /10请求/s</li> <li>用于提卡超时、提卡异常等存疑订单、异步提卡订单的查询</li> <li>下单<strong>1分钟</strong>后方可调用此接口,只支持查询<strong>当月订单、上月订单</strong>。</li> </ul> <h5>请求URL</h5> <ul> <li>http(https)://IP:端口/api/order/query</li> </ul> <h5>请求方式</h5> <ul> <li>POST(application/x-www-form-urlencoded)</li> </ul> <h5>请求参数</h5> <table> <thead> <tr> <th style="text-align: left;">参数名</th> <th style="text-align: left;">必填</th> <th style="text-align: left;">示例</th> <th>说明</th> </tr> </thead> <tbody> <tr> <td style="text-align: left;">appId</td> <td style="text-align: left;">是</td> <td style="text-align: left;">4Kq9U9rVFz</td> <td>应用ID</td> </tr> <tr> <td style="text-align: left;">orderId</td> <td style="text-align: left;">-</td> <td style="text-align: left;">201701010101010001</td> <td>平台订单号</td> </tr> <tr> <td style="text-align: left;">outOrderId</td> <td style="text-align: left;">-</td> <td style="text-align: left;">cy1017010101010101</td> <td>接入方订单号</td> </tr> <tr> <td style="text-align: left;">timestamp</td> <td style="text-align: left;">是</td> <td style="text-align: left;">20160311154602111</td> <td>时间戳,格式:yyyyMMddHHmmssSSS</td> </tr> <tr> <td style="text-align: left;">sign</td> <td style="text-align: left;">是</td> <td style="text-align: left;">tmE36C00Hzbj1TF2fFuAAR……</td> <td>签名,[签名算法](<a href="https://www.showdoc.cc/900133176881927?page_id=4798471163226341">https://www.showdoc.cc/900133176881927?page_id=4798471163226341</a> &quot;签名算法&quot;)</td> </tr> </tbody> </table> <h3><em>注意:</em></h3> <ul> <li>orderId与outOrderId至少填写1项,<strong>如都填写以orderId进行查询</strong></li> <li><strong>只支持查询当月订单、上月订单</strong></li> <li> <p><strong>注意避免传错单号造成的账目差异</strong></p> </li> <li>状态获取请以回调接口为主,查询作为补充使用</li> <li>建议查询逻辑:下单1分钟后未收到回调调用查询,间隔5分钟</li> </ul> <h4>返回格式:json</h4> <h4>返回参数</h4> <table> <thead> <tr> <th style="text-align: left;">参数名</th> <th style="text-align: left;">必填</th> <th style="text-align: left;">示例</th> <th>说明</th> </tr> </thead> <tbody> <tr> <td style="text-align: left;">code</td> <td style="text-align: left;">是</td> <td style="text-align: left;">00</td> <td>请求结果,请看结果码章节</td> </tr> <tr> <td style="text-align: left;">msg</td> <td style="text-align: left;">是</td> <td style="text-align: left;">查询成功</td> <td>结果描述</td> </tr> <tr> <td style="text-align: left;">orderId</td> <td style="text-align: left;">-</td> <td style="text-align: left;">201701010101010001</td> <td>平台订单号</td> </tr> <tr> <td style="text-align: left;">outOrderId</td> <td style="text-align: left;">-</td> <td style="text-align: left;">cy1017010101010101</td> <td>接入方订单号</td> </tr> <tr> <td style="text-align: left;">orderStatus</td> <td style="text-align: left;">-</td> <td style="text-align: left;">2</td> <td>订单状态,2-提卡成功,3-提卡失败,1-处理中,4-未查询到订单</td> </tr> <tr> <td style="text-align: left;">orderDesc</td> <td style="text-align: left;">-</td> <td style="text-align: left;">结果描述,提卡成功/失败原因</td> <td>结果描述</td> </tr> <tr> <td style="text-align: left;">completeTime</td> <td style="text-align: left;">-</td> <td style="text-align: left;">20160311154601</td> <td>订单完成时间,格式:yyyyMMddHHmmss</td> </tr> <tr> <td style="text-align: left;">cost</td> <td style="text-align: left;">-</td> <td style="text-align: left;">10.355</td> <td>订单总消费,单位(元)</td> </tr> <tr> <td style="text-align: left;">cardData</td> <td style="text-align: left;">-</td> <td style="text-align: left;">json数组</td> <td>卡券信息</td> </tr> <tr> <td style="text-align: left;">cardName</td> <td style="text-align: left;">-</td> <td style="text-align: left;">xxx5元官方优惠券</td> <td>卡卷名称</td> </tr> <tr> <td style="text-align: left;">cardType</td> <td style="text-align: left;">是</td> <td style="text-align: left;">LINK</td> <td>卡券形式:&lt;br/&gt;LINK 链接&lt;br/&gt;PICTURE 券码+链接&lt;br/&gt;NUMBER_PASSWORD 卡号+密码&lt;br/&gt;PASSWORD 密码</td> </tr> <tr> <td style="text-align: left;">cardNo</td> <td style="text-align: left;">-</td> <td style="text-align: left;">-</td> <td>卡号(卡券形式为NUMBER_PASSWORD时有值),[解密算法](<a href="https://www.showdoc.cc/900133176881927?page_id=4798471163226341">https://www.showdoc.cc/900133176881927?page_id=4798471163226341</a> &quot;签名算法&quot;)</td> </tr> <tr> <td style="text-align: left;">cardPwd</td> <td style="text-align: left;">-</td> <td style="text-align: left;">-</td> <td>密码(卡券形式为NUMBER_PASSWORD、PASSWORD、PICTURE时有值),[解密算法](<a href="https://www.showdoc.cc/900133176881927?page_id=4798471163226341">https://www.showdoc.cc/900133176881927?page_id=4798471163226341</a> &quot;签名算法&quot;)</td> </tr> <tr> <td style="text-align: left;">cardLink</td> <td style="text-align: left;">-</td> <td style="text-align: left;">-</td> <td>链接(卡券形式为LINK或PICTURE时有值),[解密算法](<a href="https://www.showdoc.cc/900133176881927?page_id=4798471163226341">https://www.showdoc.cc/900133176881927?page_id=4798471163226341</a> &quot;签名算法&quot;)</td> </tr> <tr> <td style="text-align: left;">expireTime</td> <td style="text-align: left;">-</td> <td style="text-align: left;">2016-03-11 15:46:01</td> <td>卡券有效期,格式:yyyy-MM-dd HH:mm:ss</td> </tr> </tbody> </table> <h4><em>注意:</em></h4> <ul> <li>cardNo、cardPwd、cardLink为加密参数,请参照[解密算法](<a href="https://www.showdoc.cc/900133176881927?page_id=4798471163226341">https://www.showdoc.cc/900133176881927?page_id=4798471163226341</a> &quot;签名算法&quot;) </li> </ul> <h4>返回示例</h4> <pre><code> { &amp;quot;code&amp;quot;:&amp;quot;00&amp;quot;, &amp;quot;msg&amp;quot;:&amp;quot;查询成功&amp;quot;, &amp;quot;orderId&amp;quot;:&amp;quot;201701010101010001&amp;quot;, &amp;quot;outOrderId&amp;quot;:&amp;quot;cy1017010101010101&amp;quot;, &amp;quot;orderStatus&amp;quot;:&amp;quot;2&amp;quot;, &amp;quot;orderDesc&amp;quot;:&amp;quot;提卡成功&amp;quot;, &amp;quot;completeTime&amp;quot;:&amp;quot;20160311154601&amp;quot;, &amp;quot;cardData&amp;quot;: [ { &amp;quot;cardName&amp;quot;: &amp;quot;xxx5元官方优惠券&amp;quot;, &amp;quot;cardType&amp;quot;: &amp;quot;NUMBER_PASSWORD&amp;quot;, &amp;quot;cardNo&amp;quot;: &amp;quot;1dM/tmE36C00Hzbj1TF2fFuAAR……&amp;quot;, &amp;quot;cardPwd&amp;quot;: &amp;quot;1dM/tmE36C00Hzbj1TF2fFuAAR……&amp;quot;, &amp;quot;expireTime&amp;quot;: &amp;quot;2016-03-11 15:46:01&amp;quot; }, { &amp;quot;cardName&amp;quot;: &amp;quot;xxx5元官方优惠券&amp;quot;, &amp;quot;cardType&amp;quot;: &amp;quot;NUMBER_PASSWORD&amp;quot;, &amp;quot;cardNo&amp;quot;: &amp;quot;1dM/tmE36C00Hzbj1TF2fFuAAR……&amp;quot;, &amp;quot;cardPwd&amp;quot;: &amp;quot;1dM/tmE36C00Hzbj1TF2fFuAAR……&amp;quot;, &amp;quot;expireTime&amp;quot;: &amp;quot;2016-03-11 15:46:01&amp;quot; } ] }</code></pre>

页面列表

ITEM_HTML