快出下单api
<p>流程说明: </p>
<ul>
<li>通过此api下单, 必传回调地址,且接入方需保证回调地址稳定可用。 下单后, 一段时间内将以回调的方式通知订单竞价后的价格</li>
<li>
<p>成功出票时,快出单将直接返回取票码。</p>
</li>
<li>
<p>特殊情况,若取票码有误,更新取票码的同时也会根据此回调地址通知,并传入新取票码,接入方自行存储取票码。此时可通知用户查看取票码。</p>
</li>
<li>
<p>因影院场次临时变更,等特殊情况导致订单关闭, 将通过此回调地址通知接入方, 接入方须自行处理给用户退款并关闭订单等操作。</p>
</li>
<li>详情请看【回调api】接口</li>
<li>出票事件顺序:TICKET_SUCCESS->RDER_FINISH</li>
</ul>
<h5>请求URL</h5>
<ul>
<li><code>api/order/create-soon-order</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;">seatId</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>座位接口的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>座位接口的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>单位:分</code>,不可随意乱传,必须是真实价格,如座位有分区定价,也许一一计算后得到总价,否则自动出票失败。<code>由于场次价格延迟问题,有可能造成场次价格和最终价格不一致,此时会出票失败。</code></td>
</tr>
<tr>
<td style="text-align: left;">area</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>座位接口的area字段(若没有值请用空字符串或0代替) ,要与下单座位对应(下单几个座位就有几个area),多个 则以竖线分割,<code>此字段必传才可调用秒出</code></td>
</tr>
<tr>
<td style="text-align: left;">testType</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">int</td>
<td>仅当为调用测试环境时候,此字段有用, 可模拟快出票结果。 <code>201 正在出票中结果</code> <code>500出票失败结果</code></td>
</tr>
</tbody>
</table>
<p><code>注1: 仅当下单影院支持快出票下单时,此接口才会正常生效。</code></p>
<p><code>注2: 快出票模式,是实际使用影院接口出票,无退款接口,故在正式环境下的快出票单,出票成功后无法退款, 请谅解。</code></p>
<p><code>注3: (重要) 不用模拟200,目前测试200和201都是返回的201,然后会回调200的结果到下单填写的回调地址</code></p>
<pre><code> 1.当出票成功时候,会直接返回取票码,此时不再另外进行回调,接入方需直接处理自身出票业务逻辑。 可用[testType] = 200 来模拟。
2.当出票失败时,可能参数有误、价格错误、或者影院排期变动,会直接返回出票失败,此时不再另外进行回调,接入方需直接处理自身退款业务逻辑。 可用[testType] = 500 来模拟。
3. 当返回结果为出票中时,系统会不断重试尝试出票,此时,出票成功、出票失败都会进行回调。原因是影院可能卡单,20分钟后如无结果,也会进行回调。 可用[testType] = 201 来模拟。</code></pre>
<h5>请求示例</h5>
<p><img src="https://www.showdoc.com.cn/server/api/attachment/visitFile?sign=fdb6e1753eb77b1eecdf1d456a835452&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;202210101623A144&quot;,
&quot;ticket&quot;: &quot;出票中&quot;,
&quot;ticketStatus&quot;: 201,
&quot;order_id&quot;: &quot;20230316093608100000000005369350786&quot;
},
&quot;success&quot;: true
}
</code></pre>
<h5>备注</h5>
<p>取票码截取,去掉中文,
let newCode = value.replace(/([^\u0000-\u00FF])/g, ''); //中文替换为空
newCode = newCode.replace(/:/g, ''); //冒号替换为空</p>
<ul>
<li>更多返回错误代码请看首页的错误代码描述</li>
</ul>