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

下单(自己做产品展示,才需要下单接口)

POST
/api/gift_card/create_order
GiftCard

请求参数

Body 参数application/json
appId
string 
必需
当前使用的公众号、小程序、移动应用的appid
giftCardId
string <uuid>
卡券商品id
必需
count
integer <int32>
数量
必需
phone
string  | null 
可选
用户电话(下单人的号码)
remark
string  | null 
实际充值的账号
可选
entPara
string  | null 
对接方自定义参数
可选
userId
string <uuid>
不用传
可选
pushUrl
string 
可选
回调推送地址(如果有值,订单相关回调我方将推送到这个地址)
示例
{
  "appId": "string",
  "giftCardId": "9c83b4f5-280c-4968-8797-b9fdb3bd911c",
  "count": 0,
  "phone": "string",
  "remark": "string",
  "entPara": "string",
  "userId": "2c4a230c-5085-4924-a3e1-25fb4fc5965b",
  "pushUrl": "string"
}

返回响应

🟢200Success
application/json
code=0为成功,非0为失败,具体错误原因参看message文本描述。
code=96代表对接方预存余额不足,请尽快联系我方对接充值。
Body
code
integer <int32>
code
可选
message
string  | null 
message
可选
data
object (GiftCardOrderResult) 
可选
state
enum<integer> <int32>
可选
卡券订单状态

0:ReadyToPay,等待支付;

1:Paid,订单已付;

2:ReadyToLock,等待抢单;

3:Locked,正在充值;

4:Success,订单成功;

5:Failed,订单失败;

6:Canceled,订单取消;

7:Refunded,订单退款;

8:NopayCancel,未付取消;
枚举值:
012345678
orderId
string  | null 
可选
msg
string  | null 
可选
title
string  | null 
可选
totalPrice
number <double>
可选
giftAmount
number <double>
可选
payPrice
number <double>
可选
count
integer <int32>
可选
orderCustomId
string  | null 
可选
createTime
string <date-time>
可选
payUrl
string  | null 
可选
示例
{
  "code": 0,
  "message": "string",
  "data": {
    "state": 0,
    "orderId": "string",
    "msg": "string",
    "title": "string",
    "totalPrice": 0,
    "giftAmount": 0,
    "payPrice": 0,
    "count": 0,
    "orderCustomId": "string",
    "createTime": "2019-08-24T14:15:22Z",
    "payUrl": "string"
  }
}
上一页
商品详情
下一页
订单支付通知
Built with