卡券订单查询
<h5>简要描述</h5>
<ul>
<li>下游在订单状态不确定或者没收到回调的时候可调用该接口查询订单结果
<h5>请求URL</h5></li>
<li><code>http://ip:port/directCardOrder/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;">requestId</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>下单时请求平台的requestId</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+requestId)</td>
</tr>
</tbody>
</table>
<h5>请求示例</h5>
<pre><code>{
&quot;requestId&quot;:&quot;1407350763952541696&quot;,
&quot;sign&quot;:&quot;c1e918e5c0e9da66c0391614671f8076&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订单不存在超过十分钟可当失败处理，<font color=LightCoral >其他不处理</font></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.proxyPrice</td>
<td style="text-align: left;">string</td>
<td>扣款金额，保留4位小数</td>
</tr>
<tr>
<td style="text-align: left;">data.cardList</td>
<td style="text-align: left;">List</td>
<td>卡券信息(提单时sendType为3不返回)</td>
</tr>
<tr>
<td style="text-align: left;">data.cardList.faceValue</td>
<td style="text-align: left;">Integer</td>
<td>面额</td>
</tr>
<tr>
<td style="text-align: left;">data.cardList.account</td>
<td style="text-align: left;">String</td>
<td>卡号(密文) ，可能为空</td>
</tr>
<tr>
<td style="text-align: left;">data.cardList.accountKey</td>
<td style="text-align: left;">String</td>
<td>卡密(密文)，可能为空</td>
</tr>
<tr>
<td style="text-align: left;">data.cardList.link</td>
<td style="text-align: left;">String</td>
<td>链接(密文) ，可能为空</td>
</tr>
<tr>
<td style="text-align: left;">data.cardList.validCode</td>
<td style="text-align: left;">String</td>
<td>验证码/激活码 (密文)，可能为空</td>
</tr>
<tr>
<td style="text-align: left;">data.cardList.enableEndTime</td>
<td style="text-align: left;">String</td>
<td>有效期，yyyy-MM-dd HH:mm:ss</td>
</tr>
</tbody>
</table>
<p>备注：<font color=LightCoral >提单时sendType为3不返回cardList卡券信息</font>。卡号，卡密，链接，验证码只要返回不为空，即为组合关系。例如卡号和卡密不为空，其他为空则组合关系是卡号+卡密；链接和验证码不为空，其他为空则组合关系是链接+验证码，以次类推。<font color=LightCoral >卡券信息采用的是AES(ECB/PKCS5Padding)对称加密算法(解密的key为提单时签名用的key的前16位字符)</font></p>
<h5>返回示例</h5>
<pre><code>{
&quot;code&quot;: 200,
&quot;msg&quot;: &quot;订单处理成功&quot;,
&quot;data&quot;: {
&quot;orderId&quot;: &quot;1787025703049498624&quot;,
&quot;proxyPrice&quot;: 20,
&quot;cardList&quot;: [
{
&quot;faceValue&quot;: 10,
&quot;account&quot;: &quot;A1m5h2zUhfEb2x1kr1vINfAzw==&quot;,
&quot;accountKey&quot;: &quot;AjnD7hfEb2x1kr1vINfAzw==&quot;
},
{
&quot;faceValue&quot;: 10,
&quot;account&quot;: &quot;1m5h2zU/T16EPbcwxFLDOQ==&quot;,
&quot;accountKey&quot;: &quot;DqLfdUDNvhEsy4zA2hZSEQ==&quot;
}
]
},
&quot;success&quot;: true
}</code></pre>
<pre><code> {
&quot;code&quot;:505,
&quot;msg&quot;:&quot;订单处理失败&quot;,
&quot;data&quot;:{
&quot;orderId&quot;:&quot;1407727321389207552&quot;,
&quot;proxyPrice&quot;:&quot;9.9000&quot;
}
}
</code></pre>
<p>数据加密与解密</p>
<p>卡券信息采用的是AES(ECB/PKCS5Padding)对称加密算法(解密的key为提单时签名用的key的前16位字符),加密/解密代码段（JAVA版）如下:</p>
<pre><code>/**
* AES加密
* @param data
* @return
* @throws Exception
*/
public static String encrypt(String data, String keyStr) throws Exception {
Cipher cipher = Cipher.getInstance(&quot;AES/ECB/PKCS5Padding&quot;);
SecretKeySpec key = new SecretKeySpec(keyStr.getBytes(&quot;UTF-8&quot;), &quot;AES&quot;);
cipher.init(1, key);
return (new BASE64Encoder()).encode(cipher.doFinal(data.getBytes(&quot;UTF-8&quot;)));
}
/**
* AES解密
* @param data
* @return
* @throws Exception
*/
public static String decrypt(String base64Data, String keyStr) throws Exception {
Cipher cipher = Cipher.getInstance(&quot;AES/ECB/PKCS5Padding&quot;);
SecretKeySpec key = new SecretKeySpec(keyStr.getBytes(&quot;UTF-8&quot;), &quot;AES&quot;);
cipher.init(2, key);
return new String(cipher.doFinal((new BASE64Decoder()).decodeBuffer(base64Data)));
}</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;">505</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;"><font color=LightCoral >订单不存在(超过10分钟可以当充值失败处理)</font></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>
</tbody>
</table>
<ul>
<li>备注：无</li>
</ul>