海心下游对接接口文档


订单结果查询

<h5>简要描述</h5> <ul> <li>下游在订单状态不确定或者没收到回调的时候可调用该接口查询订单状态,&lt;font color=LightCoral &gt;如有多个账号同一笔订单请确保请求头的Authorization-User参数和提单的一致,不一致将返回订单不存在,否则造成损失后果自负&lt;/font&gt;</li> </ul> <h5>请求URL</h5> <ul> <li><code>http://ip:port/order/query</code></li> </ul> <h5>请求方式</h5> <ul> <li>POST </li> <li>application/json;charset=UTF-8 </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;">orderId</td> <td style="text-align: left;">否</td> <td style="text-align: left;">Long</td> <td>我方订单号(orderId与requestId至少传一个,如果两者都传则以orderId为准)</td> </tr> <tr> <td style="text-align: left;">requestId</td> <td style="text-align: left;">否</td> <td style="text-align: left;">string</td> <td>下单时请求平台的requestId(orderId与requestId至少传一个,如果两者都传则以orderId为准)</td> </tr> <tr> <td style="text-align: left;">sign</td> <td style="text-align: left;">是</td> <td style="text-align: left;">String</td> <td>签名,MD5(userId+key)</td> </tr> </tbody> </table> <h5>请求示例</h5> <pre><code>{     &amp;quot;orderId&amp;quot;:&amp;quot;1407350763952541696&amp;quot;,     &amp;quot;sign&amp;quot;:&amp;quot;c1e918e5c0e9da66c0391614671f8076&amp;quot; }</code></pre> <pre><code>{     &amp;quot;requestId&amp;quot;:&amp;quot;1407350763952541696&amp;quot;,     &amp;quot;sign&amp;quot;:&amp;quot;c1e918e5c0e9da66c0391614671f8076&amp;quot; }</code></pre> <h5>返回参数说明</h5> <table> <thead> <tr> <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;">Integer</td> <td>返回结果码,200充值成功;421充值中;505充值失败;420订单不存在,超过十分钟可当失败处理,&lt;font color=LightCoral &gt;其他不处理&lt;/font&gt;</td> </tr> <tr> <td style="text-align: left;">msg</td> <td style="text-align: left;">String</td> <td>返回结果信息</td> </tr> <tr> <td style="text-align: left;">data</td> <td style="text-align: left;">Map</td> <td>数据集合,提单成功返回</td> </tr> <tr> <td style="text-align: left;">data. orderId</td> <td style="text-align: left;">Long</td> <td>平台订单id,充值成功返回</td> </tr> <tr> <td style="text-align: left;">data. certificate</td> <td style="text-align: left;">Long</td> <td>充值凭证,充值成功返回</td> </tr> <tr> <td style="text-align: left;">data.proxyPrice</td> <td style="text-align: left;">string</td> <td>扣款金额,保留4位小数</td> </tr> </tbody> </table> <h5>返回示例</h5> <pre><code>{     &amp;quot;code&amp;quot;:200,     &amp;quot;msg&amp;quot;:&amp;quot;订单处理成功&amp;quot;,     &amp;quot;data&amp;quot;:{         &amp;quot;orderId&amp;quot;:&amp;quot;1407727321389207552&amp;quot;,         &amp;quot;certificate&amp;quot;:&amp;quot;111&amp;quot;, &amp;quot;proxyPrice&amp;quot;:&amp;quot;9.9000&amp;quot;     } }</code></pre> <pre><code> {     &amp;quot;code&amp;quot;:505,     &amp;quot;msg&amp;quot;:&amp;quot;订单处理失败&amp;quot;,     &amp;quot;data&amp;quot;:{         &amp;quot;orderId&amp;quot;:&amp;quot;1407727321389207552&amp;quot;, &amp;quot;proxyPrice&amp;quot;:&amp;quot;9.9000&amp;quot;     } } </code></pre> <ul> <li>错误码</li> </ul> <table> <thead> <tr> <th style="text-align: left;">错误码</th> <th style="text-align: left;">注释</th> </tr> </thead> <tbody> <tr> <td style="text-align: left;">200</td> <td style="text-align: left;">充值成功</td> </tr> <tr> <td style="text-align: left;">421</td> <td style="text-align: left;">充值中</td> </tr> <tr> <td style="text-align: left;">400</td> <td style="text-align: left;">参数错误</td> </tr> <tr> <td style="text-align: left;">412</td> <td style="text-align: left;">白名单校验失败</td> </tr> <tr> <td style="text-align: left;">420</td> <td style="text-align: left;">&lt;font color=LightCoral &gt;订单不存在(超过10分钟可以当充值失败处理)&lt;/font&gt;</td> </tr> <tr> <td style="text-align: left;">422</td> <td style="text-align: left;">验签失败(请检查加签参数与顺序是否正确)</td> </tr> <tr> <td style="text-align: left;">500</td> <td style="text-align: left;">服务异常(请检查请求方式,参数格式,类型是否正确)</td> </tr> <tr> <td style="text-align: left;">505</td> <td style="text-align: left;">充值失败</td> </tr> </tbody> </table> <ul> <li>备注:无</li> </ul>

页面列表

ITEM_HTML