特惠下单api
<p>流程说明: </p>
<ul>
<li>通过此api下单, 必传回调地址,且接入方需保证回调地址稳定可用。 下单后, 一段时间内将以回调的方式通知订单竞价后的价格</li>
<li>
<p>成功出票时,也将通过此回调地址通知接入方,并将取票码一并传入。</p>
</li>
<li>
<p>特殊情况,若取票码有误,更新取票码的同时也会根据此回调地址通知,并传入新取票码,接入方自行存储取票码。此时可通知用户查看取票码。</p>
</li>
<li>
<p>因影院场次临时变更,等特殊情况导致订单关闭, 将通过此回调地址通知接入方, 接入方须自行处理给用户退款并关闭订单等操作。</p>
</li>
<li>
<p>由于出票模式具有延迟性, 平台不保证座位与下单座位完全一致,会以就近原则进行调座,若偏差太远,则会关闭订单,并发送通知到接入方。 (重要)</p>
</li>
<li>
<p>详情请看【回调api】接口</p>
</li>
<li>下单请在排期字段 stopSellTime 时间前下单</li>
<li>正常出票事件顺序: WAIT_TICKET->TICKET_SUCCESS->TICKET_SYNC(取票码变更才会有)->ORDER_FINISH</li>
</ul>
<h5>请求URL</h5>
<ul>
<li><code>api/order/create</code></li>
</ul>
<h5>请求方式</h5>
<ul>
<li>POST </li>
<li>入参方式: Content-Type:application/x-www-form-urlencoded</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;">showId</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>排期的showId,由影院接口得来</td>
</tr>
<tr>
<td style="text-align: left;">seat</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>用户所选的座位,例:1排1座,1排2座 以英文的逗号 " , "隔开。 如果座位是情侣座,请传入 : 1排1座(情侣座),1排2座(情侣座)</td>
</tr>
<tr>
<td style="text-align: left;">reservedPhone</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>下单时预留的手机号,方便问题沟通(夜间订单出票需要)</td>
</tr>
<tr>
<td style="text-align: left;">thirdOrderId</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>接入方的订单号, 接入方须保证此订单号唯一性</td>
</tr>
<tr>
<td style="text-align: left;">notifyUrl</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>回调地址,各个场景发生时,将通过此地址通知接入方,详情请看【回调api】</td>
</tr>
<tr>
<td style="text-align: left;">acceptChangeSeat</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">int</td>
<td>是否允许调座,1-允许,0-不允许</td>
</tr>
<tr>
<td style="text-align: left;">area</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td><code>v2版本</code> 座位接口的area字段(若没值请用空字符串或0代替) ,要与下单座位对应(下单几个座位就有几个area),多个 则以竖线分割,如果处理座位分区则必传</td>
</tr>
<tr>
<td style="text-align: left;">seatId</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">string</td>
<td><code>v2版本</code> 座位接口的seatId字段, 如果有多个,则以竖线分割</td>
</tr>
<tr>
<td style="text-align: left;">seatNo</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">string</td>
<td><code>v2版本</code> 座位接口的seatNo字段,如果有多个,则以竖线分割</td>
</tr>
<tr>
<td style="text-align: left;">netPrice</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">int</td>
<td><code>v2版本</code> 所有座位市场的总和(单位:<code>分</code>) 传入此值则会做价格校验,如果失败会返回价格不一致的错误;如果有处理座位分区,需传入area字段校验分区价格,否则以排期默认价格进行校验<code>(2022-08-22)</code></td>
</tr>
<tr>
<td style="text-align: left;">orderPrice</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">int</td>
<td><code>v2版本</code> 总限价(单位:<code>分</code>),对接方可按需求设置此价格,当价格高于此价格时订单会失败,例如两张票市场价共8000,此字段传入7500,则最后成本不会高于7500<code>(2023-03-21)</code></td>
</tr>
</tbody>
</table>
<p><code>注1: 当reservedPhone、seatId、seatNo,area 都有传递时,接口将自动锁座,锁座失败则会返回错误。</code></p>
<h4>请求示例</h4>
<p><img src="https://www.showdoc.com.cn/server/api/attachment/visitFile?sign=d20e3522b3491882feabf1adfc009058&amp;file=file.png" alt="" /></p>
<h5>返回示例</h5>
<pre><code>{
&quot;code&quot;: 200,
&quot;message&quot;: &quot;操作成功&quot;,
&quot;data&quot;: {
&quot;third_order_id&quot;: &quot;202204221447BCC&quot;,
&quot;order_id&quot;: &quot;20220622094838100000000009178978284&quot;
},
&quot;success&quot;: true
}
</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;">third_order_id</td>
<td style="text-align: left;">String</td>
<td>第三方(接入方自己)单号</td>
</tr>
<tr>
<td style="text-align: left;">order_id</td>
<td style="text-align: left;">String</td>
<td>对应的守兔单号</td>
</tr>
</tbody>
</table>
<h5>备注</h5>
<ul>
<li>更多返回错误代码请看首页的错误代码描述</li>
</ul>