回调接口
<p><strong>简要描述:</strong></p>
<ul>
<li>回调接口:放单状态变更时通知接入方,接入方可做相应操作</li>
</ul>
<p><strong>请求URL:</strong></p>
<ul>
<li><code>放单接口callBackUrl字段传入</code></li>
</ul>
<p>请求方式:</p>
<ul>
<li>POST</li>
</ul>
<p><strong>回调参数:</strong></p>
<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;">time</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>时间戳</td>
</tr>
<tr>
<td style="text-align: left;">status</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>状态</td>
</tr>
<tr>
<td style="text-align: left;">outId</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>接入方单号</td>
</tr>
<tr>
<td style="text-align: left;">note</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">string</td>
<td>关闭原因</td>
</tr>
<tr>
<td style="text-align: left;">confirmPrice</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">Bigdecimal</td>
<td>成交价</td>
</tr>
<tr>
<td style="text-align: left;">realseats</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">string</td>
<td>实际出票座位,当实际出票与购票不一致时会有该字段</td>
</tr>
<tr>
<td style="text-align: left;">tickets</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">obj</td>
<td>出票信息</td>
</tr>
</tbody>
</table>
<table>
<thead>
<tr>
<th style="text-align: left;">tickets</th>
<th style="text-align: left;">-</th>
<th style="text-align: left;">-</th>
<th>-</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">ticketsInfo</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">string</td>
<td>影票券信息</td>
</tr>
<tr>
<td style="text-align: left;">ticketsImg</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">string</td>
<td>影票券图片</td>
</tr>
</tbody>
</table>
<p><strong>状态说明:</strong></p>
<table>
<thead>
<tr>
<th style="text-align: left;">tickets</th>
<th style="text-align: left;">-</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">drawSuccess</td>
<td style="text-align: left;">已出票</td>
</tr>
<tr>
<td style="text-align: left;">updateTicket</td>
<td style="text-align: left;">更新票(该状态因票信息和票图片的更新会存在多次回调的情况,请做好相应处理)</td>
</tr>
<tr>
<td style="text-align: left;">drawClose</td>
<td style="text-align: left;">出票失败,退款</td>
</tr>
<tr>
<td style="text-align: left;">confirmScuccess</td>
<td style="text-align: left;">确认收货</td>
</tr>
</tbody>
</table>
<p>返回说明:
若接收到信息并处理,请返回以下json格式字符串</p>
<pre><code>{
"rtnCode": "000000",
"rtnMsg": "成功!"
}</code></pre>
<p><strong>回调返回示例:</strong></p>
<pre><code>//出票成功
{
"time": "20220111143152",
"status": "drawSuccess",
"outId": "930466666620538880",
"realSeats": "7排6座,7排7座",
"confirmPrice": 61.20,
"tickets": [
{
"ticketInfo": "53885406",
"ticketImg": "http://image.thdni.com/2022-01-11/aa4b94302ef448f7aa50f5bba27f0c93!img"
},
{
"ticketInfo": "13815467",
"ticketImg": "http://image.thdni.com/2022-01-11/b42eca795b9d4f7280c742e71b03e490!img"
}
]
}
//更新票
{
"time": "20220111133456",
"status": "updateTicket",
"outId": "930448606295642112",
"realSeats": "7排6座,7排8座",
"confirmPrice": 102.00,
"tickets": [
{
"ticketInfo": "15398969",
"ticketImg": "http://image.thdni.com/2022-01-11/8c46f97e36c542d1ac37d0462b09c779!img"
},
{
"ticketInfo": "75349021",
"ticketImg": "http://image.thdni.com/2022-01-11/0648cfec35cb47059f1a1816048ceab0!img"
},
{
"ticketInfo": "35329042",
"ticketImg": "http://image.thdni.com/2022-01-11/85d4f4f0a9384d68a8eaa81e5c4ad272!img"
},
{
"ticketInfo": "75359073",
"ticketImg": "http://image.thdni.com/2022-01-11/af825fb937da4da19fb38dc48114df15!img"
}
]
}
//出票失败
{
"time": "20210429181815",
"status": "drawClose",
"outId": "837388318344892416",
"note": "出票失败"
}
//确认收货
{
"time": "20220111132326",
"status": "confirmSuccess",
"outId": "100246827",
"confirmPrice": 61.20
}</code></pre>
<p>我方接收到以上返回将认为接入方已处理完成,不会再进行回调。
若返回其他的一律认为没有收到应答,将继续回调,回调频率按照
<code>15s/15s/30s/3m/10m/20m/30m/30m/30m/60m/3h/3h/3h/6h/6h - 总计 24h4m</code></p>