回调说明

接口说明：订单状态发生变更时通知商户，需在【提交购票需求生成订单】接口中携带 notifyUrl 参数。
通知方式：采用 HTTP POST 方式传输 JSON 数据；渠道处理完成后需返回字符串 success，否则将重复通知。

回调请求体

字段名称	字段描述	字段类型
type	1:出票成功 3:更新影票 6:已取消（未出票退单）7:订单完成 8:订单退单	number
orderData	订单数据	Object

订单数据

字段名称	字段描述	字段类型
outOrderNo	周边订单号	String
channelOrderNo	渠道订单号	String
orderTitle	订单标题	String
orderSubTitle	订单副标题	String
orderDesc	订单描述	String
originPrice	门市价	Double
salePrice	销售价	Double
settlePrice	结算价	Double
quantity	购买数量	Integer
totalSettleAmount	总结算价	Double
status	0：待接单 1：已接单 2：已出票 3：已完成 6：已取消（未出票退单） 7：已退单（出票成功后退单）	Integer
tickets	电影票集合

电影票集合

字段名称	字段描述	字段类型
ticketId	电影票票号	String
ticketSecret	电影票验证码	String
ticketQrCode	电影票取票二维码内容	String
seatNo	座位名称，多个座位“,”隔开	String

回调处理规则

📌

综合 type + orderData.status

目标流程：

下单成功 → 出票中 → 出票成功 / 出票失败（退款）

一、处理优先级

先判断 退单 / 取消

再判断 是否已出票

更新类回调不改变主状态

二、出票成功态（Success）

满足任一条件即视为出票成功：

type = 1（出票成功）

type = 3（更新影票）

type = 7（订单完成）

orderData.status = 2（已出票）

orderData.status = 3（已完成）

处理逻辑：

保存 / 更新电影票信息
ticketId / ticketSecret / ticketQrCode / seatNo

订单状态置为：出票成功

三、出票失败 / 退单态（Fail）

满足任一条件直接失败：

type = 6（已取消，未出票退单）

type = 8（订单退单）

orderData.status = 6（未出票取消）

orderData.status = 7（已退单，出票后退单）

处理逻辑：

订单状态置为：出票失败

若已支付，执行自动退款

四、出票中（Processing）

以下状态仅表示处理中：

orderData.status = 0（待接单）

orderData.status = 1（已接单）

处理逻辑：

保持状态：出票中

等待后续回调或主动查询

五、补充说明

type = 3 仅用于 更新影票信息，不改变成功状态

回调处理需幂等（以 outOrderNo / channelOrderNo 为唯一键）

所有终态只允许处理一次

回调请求体#

订单数据#

电影票集合#

回调处理规则#

一、处理优先级#

二、出票成功态（Success）#

三、出票失败 / 退单态（Fail）#

四、出票中（Processing）#

五、补充说明#

回调请求体

订单数据

电影票集合

回调处理规则

一、处理优先级

二、出票成功态（Success）

三、出票失败 / 退单态（Fail）

四、出票中（Processing）

五、补充说明