提交卡券订单
<h5>简要描述</h5>
<ul>
<li>下单操作为异步请求，报文返回成功，则表示受理成功，需要我方发起异步通知，或者下游发起查询请求来判断订单结果。订单成功才可调用获卡接口获取卡券信息</li>
</ul>
<h5>请求URL</h5>
<ul>
<li><code>http://ip:port/cardOrder/submit</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;">productId</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">Long</td>
<td>平台商品id</td>
</tr>
<tr>
<td style="text-align: left;">requestId</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>流水Id，下游生成，不可重复</td>
</tr>
<tr>
<td style="text-align: left;">num</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>购买数量</td>
</tr>
<tr>
<td style="text-align: left;">checkPrice</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">BigDecimal</td>
<td>校验价格，单位元，保留四位小数。我方平台提供该商品的代理价格(售价 x 折扣) 。<font color=LightCoral >校验价格与面额必传其一 </font></td>
</tr>
<tr>
<td style="text-align: left;">faceValue</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">Integer</td>
<td>面额，单位元。<font color=LightCoral >校验价格与面额必传其一 </font></td>
</tr>
<tr>
<td style="text-align: left;">timeOut</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">Integer</td>
<td>超时时间，单位秒。</td>
</tr>
<tr>
<td style="text-align: left;">callbackUrl</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">String</td>
<td>回调地址 (不需要url编码)</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+productId+ requestId + num)</td>
</tr>
</tbody>
</table>
<h5>请求示例</h5>
<pre><code>{
&quot;productId&quot;:&quot;10251&quot;,
&quot;num&quot;: 10,
&quot;faceValue&quot;: 10,
&quot;requestId&quot;:&quot;1234567&quot;,
&quot;callbackUrl&quot;:&quot;http://www.baidu.com&quot;,
&quot;sign&quot;:&quot;0633d0aeb5c8146864f43736ece81d8e&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>返回结果码</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>
</tbody>
</table>
<h5>返回示例</h5>
<pre><code> {
&quot;code&quot;:200,
&quot;msg&quot;:&quot;订单提交成功&quot;,
&quot;data&quot;:{
&quot;orderId&quot;:&quot;1407727321389207552&quot;
}
}</code></pre>
<pre><code> {
&quot;code&quot;:413,
&quot;msg&quot;:&quot;订单号重复&quot;
}
</code></pre>
<ul>
<li>错误码</li>
</ul>
<table>
<thead>
<tr>
<th style="text-align: left;">错误码</th>
<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>
<td style="text-align: left;"><font color=LightCoral >受理成功，但不代理订单下单成功。下单结果以平台回调结果或通过订单查询接口结果为准</font></td>
</tr>
<tr>
<td style="text-align: left;">400</td>
<td style="text-align: left;">失败</td>
<td style="text-align: left;">参数有误(失败)</td>
</tr>
<tr>
<td style="text-align: left;">410</td>
<td style="text-align: left;">失败</td>
<td style="text-align: left;">用户不存在(检查请求头是否传了Authorization-User并且是否正确) (失败)</td>
</tr>
<tr>
<td style="text-align: left;">412</td>
<td style="text-align: left;">失败</td>
<td style="text-align: left;">白名单校验失败(失败)</td>
</tr>
<tr>
<td style="text-align: left;">413</td>
<td style="text-align: left;">人工确认</td>
<td style="text-align: left;"><font color=LightCoral >流水号重复(每次请求都要求唯一) (人工确认，如果确实重复提交了，重复的订单也可以当失败处理) </font></td>
</tr>
<tr>
<td style="text-align: left;">414</td>
<td style="text-align: left;">失败</td>
<td style="text-align: left;">产品不存在(失败)</td>
</tr>
<tr>
<td style="text-align: left;">415</td>
<td style="text-align: left;">失败</td>
<td style="text-align: left;">用户没有配置该产品(请联系平台工作人员进行配置) (失败)</td>
</tr>
<tr>
<td style="text-align: left;">416</td>
<td style="text-align: left;">失败</td>
<td style="text-align: left;">校验价格校验失败，输入价格与实际代理价格不一致(失败)</td>
</tr>
<tr>
<td style="text-align: left;">417</td>
<td style="text-align: left;">失败</td>
<td style="text-align: left;">账户余额不足(失败)</td>
</tr>
<tr>
<td style="text-align: left;">422</td>
<td style="text-align: left;">失败</td>
<td style="text-align: left;">验签失败(请检查加签参数与顺序是否正确) (失败)</td>
</tr>
<tr>
<td style="text-align: left;">423</td>
<td style="text-align: left;">失败</td>
<td style="text-align: left;">受理失败,流控不通过</td>
</tr>
<tr>
<td style="text-align: left;">500</td>
<td style="text-align: left;">人工或者调查单接口确认</td>
<td style="text-align: left;"><font color=LightCoral >服务异常(请检查请求方式，参数格式，类型是否正确) (请求格式没问题需人工确认，或者调订单查询接口查看结果，不可当失败处理)</font></td>
</tr>
<tr>
<td style="text-align: left;">505</td>
<td style="text-align: left;">失败</td>
<td style="text-align: left;">受理失败</td>
</tr>
</tbody>
</table>
<ul>
<li>备注：无</li>
</ul>