SW话单商对接文档

SW话单商对接文档


订单查询接口

<p>[TOC]</p> <h5>简要描述</h5> <ul> <li>订单信息查询</li> </ul> <h5>请求URL</h5> <ul> <li><code>http://网关地址/api/customer/queryOrder</code></li> </ul> <h5>请求方式</h5> <ul> <li>POST application/x-www-form-urlencoded</li> </ul> <h5>参数</h5> <table> <thead> <tr> <th style="text-align: center;">参数名</th> <th style="text-align: center;">必选</th> <th style="text-align: center;">是否参与加密</th> <th style="text-align: center;">类型</th> <th style="text-align: left;">说明</th> </tr> </thead> <tbody> <tr> <td style="text-align: center;">customerId</td> <td style="text-align: center;">是</td> <td style="text-align: center;">是</td> <td style="text-align: center;">number</td> <td style="text-align: left;">商户编码(平台提供)</td> </tr> <tr> <td style="text-align: center;">customerOrderId</td> <td style="text-align: center;">是</td> <td style="text-align: center;">是</td> <td style="text-align: center;">string</td> <td style="text-align: left;">商户订单号,创建订单时传给平台的商户订单号</td> </tr> <tr> <td style="text-align: center;">timestamp</td> <td style="text-align: center;">是</td> <td style="text-align: center;">是</td> <td style="text-align: center;">string</td> <td style="text-align: left;">东8区北京时间戳(13位) 精确到毫秒,如:1702641908066</td> </tr> <tr> <td style="text-align: center;">sign</td> <td style="text-align: center;">是</td> <td style="text-align: center;">否</td> <td style="text-align: center;">string</td> <td style="text-align: left;">签名值</td> </tr> </tbody> </table> <h5>返回示例</h5> <pre><code>{ &amp;quot;code&amp;quot;: 0, &amp;quot;msg&amp;quot;: &amp;quot;success&amp;quot;, &amp;quot;data&amp;quot;: { &amp;quot;amount&amp;quot;: 30, &amp;quot;createtime&amp;quot;: &amp;quot;2025-02-21 17:10:11&amp;quot;, &amp;quot;orderid&amp;quot;: &amp;quot;2503211710118079669&amp;quot;, &amp;quot;phone&amp;quot;: &amp;quot;18654678965&amp;quot;, &amp;quot;voucher&amp;quot;: &amp;quot;4272053294170229102&amp;quot;, &amp;quot;customerOrderId&amp;quot;: &amp;quot;HDS1742548211185&amp;quot;, &amp;quot;status&amp;quot;: &amp;quot;2&amp;quot; } }</code></pre> <h5>返回参数说明</h5> <table> <thead> <tr> <th style="text-align: center;">参数名</th> <th style="text-align: center;">类型</th> <th style="text-align: center;">是否必填</th> <th>说明</th> </tr> </thead> <tbody> <tr> <td style="text-align: center;">code</td> <td style="text-align: center;">string</td> <td style="text-align: center;">是</td> <td>响应编码&lt;br&gt;0:查询成功&lt;br&gt;其他错误请见下方错误编码</td> </tr> <tr> <td style="text-align: center;">msg</td> <td style="text-align: center;">string</td> <td style="text-align: center;">是</td> <td>响应信息,查询失败会有具体的错误信息</td> </tr> <tr> <td style="text-align: center;">data</td> <td style="text-align: center;">json</td> <td style="text-align: center;">否</td> <td>受理成功有返回值</td> </tr> </tbody> </table> <h5>data参数说明</h5> <table> <thead> <tr> <th style="text-align: center;">参数名</th> <th style="text-align: center;">类型</th> <th style="text-align: center;">是否必填</th> <th>说明</th> </tr> </thead> <tbody> <tr> <td style="text-align: center;">customerOrderId</td> <td style="text-align: center;">string</td> <td style="text-align: center;">是</td> <td>商户订单号</td> </tr> <tr> <td style="text-align: center;">orderid</td> <td style="text-align: center;">string</td> <td style="text-align: center;">是</td> <td>平台订单号</td> </tr> <tr> <td style="text-align: center;">serverTarget</td> <td style="text-align: center;">string</td> <td style="text-align: center;">是</td> <td>充值号码</td> </tr> <tr> <td style="text-align: center;">amount</td> <td style="text-align: center;">string</td> <td style="text-align: center;">是</td> <td>充值金额</td> </tr> <tr> <td style="text-align: center;">createtime</td> <td style="text-align: center;">string</td> <td style="text-align: center;">是</td> <td>订单受理时间</td> </tr> <tr> <td style="text-align: center;">status</td> <td style="text-align: center;">string</td> <td style="text-align: center;">是</td> <td>订单状态&lt;br&gt;1:代表充值中&lt;br&gt;2:代表充值成功&lt;br&gt;9:代表充值失败</td> </tr> <tr> <td style="text-align: center;">voucher</td> <td style="text-align: center;">string</td> <td style="text-align: center;">是</td> <td>充值凭证 如果充值成功有值,否则为空</td> </tr> </tbody> </table> <h3>错误编码附录</h3> <table> <thead> <tr> <th style="text-align: center;">错误编码</th> <th style="text-align: center;">错误信息</th> </tr> </thead> <tbody> <tr> <td style="text-align: center;">8001</td> <td style="text-align: center;">商户信息不存在</td> </tr> <tr> <td style="text-align: center;">8003</td> <td style="text-align: center;">IP不在白名单内</td> </tr> <tr> <td style="text-align: center;">8004</td> <td style="text-align: center;">参数签名错误</td> </tr> <tr> <td style="text-align: center;">8007</td> <td style="text-align: center;">订单不存在</td> </tr> </tbody> </table>

页面列表

ITEM_HTML