芒果API接口
    芒果API接口
    • 对接必读
    • 回调通知
    • API兼容说明(仅旧版本查看)
    • 接口列表
      • 全国所有城市
        POST
      • 城市的行政区/县
        POST
      • 热映电影&待上映电影
        POST
      • 搜索影片或影院
        POST
      • 影片信息&某城市下的影片排期
        POST
      • 影院列表
        POST
      • 查询某影院所属院线
        POST
      • 影片近期有排期的影院
        POST
      • 影院信息&影院排期的电影数据
        POST
      • 影院的电影场次数据
        POST
      • 影院的电影场次座位数据
        POST
      • 锁座下单
        POST
      • 释放座位
        POST
      • 确认下单
        POST
      • 查询订单详情
        POST
      • 查询账户余额
        POST
      • 获取H5+Token链接
        POST
      • 批量拉取影院数据
        POST
      • 批量拉取场次数据
        POST
    • 其他
      • APP/微信小程序嵌入H5

    回调通知

    一、订单回调通知#

    1.由接入方提供回调通知接口#

    填写路径:芒果代理后台—应用管理—编辑
    image.png

    2.芒果方通过 POST JSON 发送回调通知#

    3.回调参数:#

    字段名称说明类型
    success成功信息,Success 表示成功,Error 出票失败字符串
    message错误信息文字字符串
    code000 表示成功,反之出现错误
    056 出票失败,退款(详细原因请以订单详情接口refundmes为准)
    050 系统错误导致出票失败
    026 订单结算(出票成功观影结束后两小时后的回调,默认关闭,如需开启请告知芒果人员)
    022 客户支付成功(app或小程序对接存在
    029 锁定出票商(无需展示给用户,默认不回调)
    字符串
    order_number订单号字符串
    attach订单提交时的附加(“H5嵌入”对接方式该参数为“unique_id”值)字符串
    rebate分佣总佣金数字
    ticket_update出票时间戳数字
    请注意:出票成功后可能存在修改票根的情况,会再次进行回调。回调状态为:出票成功 000 !#

    4.接入方需响应:JSON数据#

    字段名称说明类型
    code1 表示成功,反之0或其他数字则表示出现错误数字
    {"code":1}
    请注意:每种状态最多回调4次,请务必按照格式及时响应,以免出现修改票根后未及时更新导致用户无法观影!

    二、影院更新回调通知#

    解释:当发生上游数据变化或影院价格变动等情况时会单独更新某个影院数据,因此我方提供影院更新回调通知,对接方接收到回调时按回调信息中的影院进行同步即可,无需同步全部场次数据,既能保证数据的一致性又节省资源。

    1.配置影院变动更新回调#

    填写路径:芒果代理后台—应用管理—编辑
    image.png

    2.芒果方通过 POST 发送回调通知#

    3.回调参数#

    字段名称说明类型
    cinemaId影院ID字符串
    cinemaName影院名称字符串
    cinemaCode影院转资编码字符串
     Array
    (
        'cinemaId' => 4283,
        'cinemaName' => '北京百老汇电影中心(万国城店)',
        'cinemaCode' => 11011001
    )

    4.接入方无需响应#

    此回调只会发送一次,不会补发。
    上一页
    对接必读
    下一页
    API兼容说明(仅旧版本查看)
    Built with