锁座下单

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

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

4、情侣座说明：

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

5、关于隔空选座问题

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

请求参数

Body 参数application/json

示例

{
    "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": 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、关于隔空选座问题#