锁座下单

对接方务必重视以下几点，若因此影响客户体验后果自负！

1、seat_data字段说明：

①SeatCode必传！
②座位存在分区时area_id参数必传，不传会导致订单溢价并退款，影响用户体验
json格式：
[{"area_id":"存在分区座位时必传该字段","SeatCode":"座位ID","lovestatus":"0为非情侣座 1为情侣座左 2为情侣座右","seatNo":"座位名称"},{"SeatCode":"MjQ3MzZAX0AxMjQ4NjRAX0AxNjEwMzYyMjAwQF9AMUBfQDYxQF9AMDMwMDAwMDMwMTIwMDYwMUBfQDYxQF9AMEBfQDXmjpI35bqn","lovestatus":0,"seatNo":"5排6座"}]

2、锁座下单后时效为【10分钟】，需要在时效内调用【确认下单】接口，超过【10分钟】未确认下单判定为支付超时

可通过【查询订单详情】接口查看订单状态和支付剩余时间。为了保障用户体验，建议用户在支付前调用【查询订单详情】接口，若为“支付超时”状态时应当及时拦截用户付款行为

3、订单溢价：

当code返回10040时表示订单溢价，对接方可延迟2-3分钟后重新拉取该影院场次。
对接方可在调用锁座下单接口时将我方锁座价格与对接方付款价格对比，若不一致则需要重新拉取本影院场次，以免出现因场次同步延迟导致的价格问题

4、情侣座说明：

①判断为情侣座时，计算情侣座位数是否为双数，如果为单数返回提醒：情侣座必须成对购买
②判断为情侣座时，根据lovestatus字段判断是否为相邻座位，如果不是相邻返回提醒：情侣座必须相邻购买

5、关于隔空选座问题

当一排连续的有效座位大于五个以上时，对当前选择座位所在的一排座位检测，只要所选座位左右两边任意一边存在一个未选择的有效座位，就不可以选择，遇到非有效座位（过道、空、墙等）时停止

请求参数

Body 参数application/json

tel

string

订票手机号

必需

room_id

string

场次ID

必需

seat_data

string

座位数据

必需

座位分区时需要加area_id参数，json格式：[{"area_id":"存在分区座位时必传该字段","SeatCode":"座位ID","lovestatus":"是否情侣座位 0否 1是 2 相邻座位","seatNo":"座位名称"},{"SeatCode":"MjQ3MzZAX0AxMjQ4NjRAX0AxNjEwMzYyMjAwQF9AMUBfQDYxQF9AMDMwMDAwMDMwMTIwMDYwMUBfQDYxQF9AMEBfQDXmjpI35bqn","lovestatus":0,"seatNo":"5排6座"}]

auto_check_seat

string

是否允许自动换座

可选

0 不允许/1 允许，默认为0

attach

string

附加参数

可选

限制300字节内

cinema_id

integer

（可不传）影院ID

可选

禁止从场次列表接口中读取该字段

film_id

integer

（可不传）影片ID

可选

禁止从场次列表接口中读取该字段（film_id和film_code二选一，同时存在优先取film_code）

film_code

string

（可不传）影片专资编码

可选

专资办影片统一编码11位（film_id和film_code二选一，同时存在优先取film_code）

supplier_max_price

string

限价金额

可选

示例

{
  "agent_id": "101097",
  "app_id": "2931",
  "tel": "13444046807",
  "room_id": "a10560ea0f954071270b233c8fca145a-5724-0",
  "seat_data": "[{\"columnNo\":\"1\",\"rowNo\":\"4\",\"lovestatus\":0,\"areaId\":\"8369\",\"price\":36.9,\"seatId\":\"000000040727-4-1\",\"seatNo\":\"4排1座\",\"SeatCode\":\"000000040727-4-1\",\"status\":\"N\"}]",
  "signid": "ca703823afe53a4df1e3726be0bd88ef"
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200成功

application/json

Body

success

boolean

必需

code

integer

必需

message

string

必需

data

object

必需

city

string

影院所在城市

必需

maoyan_price

string

网售价（原价/猫眼价）

必需

final_price

string

优惠价格（用户付款价/结算价）

必需

rule_price

string

快速通道价格

必需

show_end_time

string

电影结束时间戳

必需

fast_if

boolean

是否支持快速出票通道

必需

true 支持 / false 不支持

order_info

object

订单信息

必需

示例

{
  "success": true,
  "code": 1,
  "message": "操作成功",
  "data": {
    "city": "影院所在城市",
    "maoyan_price": "网售价（原价）",
    "final_price": "优惠价格（用户付款价）",
    "rule_price": "快速通道价格",
    "show_end_time": "电影结束时间戳",
    "fast_if": "是否支持快速出票",
    "order_info": {
      "order_number": "订单编号",
      "created_at": "订单创建时间"
    }
  }
}

对接方务必重视以下几点，若因此影响客户体验后果自负！#

1、seat_data字段说明：#

2、锁座下单后时效为【10分钟】，需要在时效内调用【确认下单】接口， 超过【10分钟】未确认下单判定为支付超时#

3、订单溢价：#

4、情侣座说明：#

5、关于隔空选座问题#

请求参数

示例代码

返回响应

对接方务必重视以下几点，若因此影响客户体验后果自负！

1、seat_data字段说明：

2、锁座下单后时效为【10分钟】，需要在时效内调用【确认下单】接口，超过【10分钟】未确认下单判定为支付超时

3、订单溢价：

4、情侣座说明：

5、关于隔空选座问题