卡券下单
<h5>简要描述</h5>
<ul>
<li>下单操作为异步请求,报文返回成功,则表示受理成功,需要我方发起异步通知,或者下游发起查询请求获取结果</li>
</ul>
<h5>请求URL</h5>
<ul>
<li><code>http://ip:port/directCardOrder/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;">sendType</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">int</td>
<td>卡券获取方式,默认1,<font color=LightCoral >无特殊情况不用传 </font>。1:正常获取(API回调通知,主动查询接口)。3:放库存按产品自取(库存提取接口)</td>
</tr>
<tr>
<td style="text-align: left;">num</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>购买数量,最大50</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>