开放平台
    开放平台
    • 首页
    • App/H5对接流程:
    • API开放接口对接流程
    • 小程序对接流程v1.0
    • 数据推送说明
    • 基础信息
      • 获取接口访问令牌
        POST
      • 更改密码
        POST
      • 企业用户信息 v1.1
        GET
      • 获取会员token
        POST
    • 电影票接口
      • 电影票回调通知
      • 获取城市列表
        GET
      • 热映电影(pageIndex从0开始)
        GET
      • 即将上映电影
        GET
      • 获取影院列表
        GET
      • 获取影院过滤列表(获取城市影院品牌和区域信息)
        GET
      • 获取电影的影院列表
        GET
      • 获取电影详情
        GET
      • 获取影院某个电影的排片列表
        GET
      • 获取电影场次(座位)详情
        GET
      • 创建订单
        POST
      • 订单简要信息(字段较简洁,用于发起订单支付)
        GET
      • 支付订单(用户付款成功后调用)
        GET
      • 订单列表(管理)
        POST
      • 订单详情
        GET
      • 获取广告列表
        GET
    • 吃喝玩乐接口
      • GroupBuy
        • 城市列表
        • 商品列表
        • 商品详情
      • GroupBuyOrder
        • 下单(自己做产品展示,才需要下单接口)
        • 订单支付通知
        • 订单列表
        • 订单详情
        • 订单详情(管理)
    • 购物接口
      • FanLiOrder
        • 订单列表
        • 订单详情(管理)
    • 卡券接口
      • GiftCard
        • 卡券商品分类列表
        • 卡券商品列表
        • 商品详情
        • 下单(自己做产品展示,才需要下单接口)
        • 订单支付通知
        • 订单列表
        • 订单详情
        • 卡券商品按类别列表(共二级分类)
    • 点餐接口
      • 点餐回调通知
      • 城市列表
      • 平台店铺列表
      • 店铺详情,如果传了经纬度,返回距离
      • 菜单
      • 商品详情(不同品牌商品详情会有所不同)
      • 创建订单(不同品牌的商品详情下单的参数会有所不同)
      • 订单支付通知(用户付款成功后调用)
      • 订单列表
      • 订单详情
      • 订单上传文件列表
    • 礼金接口
      • PayCouponBind
        • 通过手机号发放优惠劵

    App/H5对接流程:

    💡
    APP/H5对接只需要嵌入H5地址即可。可分为使用我方收款和使用方收款两种情况。
    使用我方收款只需要对接步骤1
    使用方收款需对接1/2/3/4

    详细步骤#

    参数说明
    参数名说明
    entid唯一id标识
    appSecret密钥
    source同appId,主要用在前端url参数
    entpara自定义参数,回传数据时原样返回
    token我方与对接方用户数据对接依据,从接口/api/oauth/member_token获取,用对接方的userId或者手机号来换取member_token,接口文档获取会员token
    show自定义大牌点餐集合页按品牌显示对应入口,例如"show=kfc,mdl,xbk",不填则不过滤,按默认显示,多个用英文逗号分隔(kfc肯德基、mdl麦当劳、xbk星巴克、nx奈雪的茶、rx瑞幸咖啡、xc喜茶、ct库迪)
    pushUrl回调推送地址(非必填),用于订单状态变化时推送订单信息到对接方的地址,带上这个参数将覆盖全局配置里的推送地址。 该参数目前仅支持点餐业务场景,电影的推送地址需要联系运营配置推送地址。 示例:&pushUrl=xxxx 注:回调推送的URL链接一定要做编码处理
    lat lng经纬度 (非必填)注:虽然是非必填但是小程序对接进来一定要传坐标。 示例值:&lat=xxx&lng=xxx
    域名地址请与业务人员联系
    1、使用方在H5或者APP里嵌入H5页面
    注:在使用以下链接时,请确保对动态参数进行 URL 编码(URL Encoding),以避免因特殊字符(如 &, =, % 等)导致链接解析错误。
    💡
    页面 地址
    首页 /h10/#/?entid={entid}&source={appId}&entpara={entpara}&token={member_token}
    电影 /h10/#/pages/movie/index?entid={entid}&source={appId}&entpara={entpara}&token={member_token}
    吃喝玩乐 /h10/#/pages/groupbuy/index?entid={entid}&source={appId}&entpara={entpara}&token={member_token}
    电影订单 /h10/#/pages/order/movie/index?entid={entid}&source={appId}&entpara={entpara}&token={member_token}
    大牌点餐集合页 /h10/#/pages/food/index?entid={entid}&source={appId}&entpara={entpara}&token={member_token}&show={show}
    肯德基单页 /h10/#/pages/food/kfc/index?entid={entid}&source={appId}&entpara={entpara}&token={member_token}
    麦当劳单页 /h10/#/pages/food/mdl/index?entid={entid}&source={appId}&entpara={entpara}&token={member_token}
    瑞幸单页 /h10/#/pages/food/rx/index?entid={entid}&source={appId}&entpara={entpara}&token={member_token}
    星巴克单页 /h10/#/pages/food/xbk/index?entid={entid}&source={appId}&entpara={entpara}&token={member_token}
    喜茶单页 /h10/#/pages/food/xc/index?entid={entid}&source={appId}&entpara={entpara}&token={member_token}
    奈雪单页 /h10/#/pages/food/nx/index?entid={entid}&source={appId}&entpara={entpara}&token={member_token}
    点餐订单详情页 /h10/#/pages/pay/kfcDetailPay?orderId={xx}&entid={entid}&source={appId}&entpara={entpara}&token={member_token}
    电影购买页 /h10/#/pages/movie/cinema?coming=0&movieId={电影id}&movieName={电影名称}&entid={entid}&source={appId}&entpara={entpara}&token={member_token}
    电影详情页 /h10/#/pages/movie/movieInfo?coming=0&movieId={电影id}&entid={entid}&source={appId}&entpara={entpara}&token={member_token}
    卡券 /h10/#/pages/giftcard/index?entid={entid}&source={appId}&entpara={entpara}&token={member_token}
    库迪单页 /h10/#/pages/food/ct/index?entid={entid}&source={appId}&entpara={entpara}&token={member_token}
    2、使用方自己创建H5支付页面,用于发起用户支付。创建好后把该地址告诉我方对接人员配置。
    用户下单后,我方H5会跳转到这个地址,并带上参数:?orderId=xxx&type=xxx&returnUrl=xxx
    跳转参数说明
    参数名 说明
    orderId 订单id,拿到订单id后请调用订单详情接口获取订单应付金额等信息
    type 订单类型,0电影订单,1卡券订单,4吃喝玩乐订单,5肯德基/麦当劳/星巴克
    returnUrl 订单详情页,如果入款完成,跳转回此页面
    用户支付完成,使用方调用我方的支付通知接口
    如需下测试单,在调用支付通知接口的时候传参数test=true的时候订单会自动拦截,不会产生正式订单。
    电 影 票订单支付通知:支付订单(支付成功后调用)
    吃喝玩乐订单支付通知: 订单支付通知
    卡 券 订 单支付通知: 订单支付通知
    大牌点餐支付通知: 订单支付通知
    3、成功调用我方支付通知接口后,使用方重定向页面到returnUrl
    4、对接方提供一个接收数据推送的接口,当订单成功或失败后,推送相关数据到此接口。接口文档:数据推送说明
    上一页
    首页
    下一页
    API开放接口对接流程
    Built with