小程序对接流程v1.0
https://www.youpiaopiao.cn
https://7moor.youpiaopiao.cn （如果有自己的独立客服系统，不需要添加）
https://static.aihecong.com/ （如果有自己的独立客服系统，不需要添加）
2、和有票票对接人员获取接口参数，在接口调用，URL拼接等地方会使用到这些参数 注：有特殊参数符号的参数要通过urlencode来处理
| 参数名 | 说明 |
|---|---|
| entid | 唯一id标识 |
| appSecret | 密钥 |
| appId | 应用id，可以创建多个 |
| source | 同appId，主要用在前端url参数 |
| entpara | 自定义参数，回传数据时原样返回 |
| token | 我方与对接方用户数据对接依据，从接口/api/oauth/member_token获取，用对接方的userId或者手机号来换取member_token，接口文档获取会员token |
| pushUrl | 回调推送地址（非必填），用于订单状态变化时推送订单信息到对接方的地址，带上这个参数将覆盖全局配置里的推送地址。 示例：&pushUrl=xxxx 注：回调推送的URL链接一定要做编码处理 |
| lat lng | 经纬度 (非必填)注：虽然是非必填但是小程序对接进来一定要传坐标。示例值：&lat=xxx&lng=xxx |
| redirectType=h5 | 在小程序环境定向到H5收银台页面。示例：&redirectType=h5 注：这个参数一般是对接方小程序内嵌H5的应用才使用。如不清楚青联系对接人员。 |
注：在使用以下链接时，请确保对动态参数进行 URL 编码（URL Encoding），以避免因特殊字符（如 &, =, % 等）导致链接解析错误。
首页 https://www.youpiaopiao.cn/h10/#/?entid={entid}&source={appId}&entpara={entpara}&token={member_token}
电影 https://www.youpiaopiao.cn/h10/#/pages/movie/index?entid={entid}&source={appId}&entpara={entpara}&token={member_token}
吃喝玩乐 https://www.youpiaopiao.cn/h10/#/pages/groupbuy/index?entid={entid}&source={appId}&entpara={entpara}&token={member_token}&ig=0
电影订单 https://www.youpiaopiao.cn/h10/#/pages/order/movie/index?entid={entid}&source={appId}&entpara={entpara}&token={member_token}
大牌点餐集合页 https://www.youpiaopiao.cn/h10/#/pages/food/index?entid={entid}&source={appId}&entpara={entpara}&token={member_token}
K记单页（可外卖） https://www.youpiaopiao.cn/h10/#/pages/food/kfc/index?entid={entid}&source={appId}&entpara={entpara}&token={member_token}
麦记单页（可外卖） https://www.youpiaopiao.cn/h10/#/pages/food/mdl/index?entid={entid}&source={appId}&entpara={entpara}&token={member_token}
瑞辛单页 https://www.youpiaopiao.cn/h10/#/pages/food/rx/index?entid={entid}&source={appId}&entpara={entpara}&token={member_token}
奈小雪单页 https://www.youpiaopiao.cn/h10/#/pages/food/nx/index?entid={entid}&source={appId}&entpara={entpara}&token={member_token}
喜小茶单页 https://www.youpiaopiao.cn/h10/#/pages/food/xc/index?entid={entid}&source={appId}&entpara={entpara}&token={member_token}
星爸爸单页（可外卖） https://www.youpiaopiao.cn/h10/#/pages/food/xbk/index?entid={entid}&source={appId}&entpara={entpara}&token={member_token}
酷迪单页 https://www.youpiaopiao.cn/h10/#/pages/food/ct/index?entid={entid}&source={appId}&entpara={entpara}&token={member_token}
披萨客单页（仅外卖） https://www.youpiaopiao.cn/h10/#/pages/food/bsk/index?entid={entid}&source={appId}&entpara={entpara}&token={member_token}
点餐订单详情页 https://www.youpiaopiao.cn/h10/#/pages/pay/kfcDetailPay?orderId={xx}&entid={entid}&source={appId}&entpara={entpara}&token={member_token}
电影购买页 https://www.youpiaopiao.cn/h10/#/pages/movie/cinema?coming=0&movieId={电影id}&movieName={电影名称}&entid={entid}&source={appId}&entpara={entpara}&token={member_token}
电影详情页 https://www.youpiaopiao.cn/h10/#/pages/movie/movieInfo?coming=0&movieId={电影id}&entid={entid}&source={appId}&entpara={entpara}&token={member_token}
卡券 https://www.youpiaopiao.cn/h10/#/pages/giftcard/index?entid={entid}&source={appId}&entpara={entpara}&token={member_token}
地址URL参数说明
参数名 说明
entid 唯一id标识,有票票提供的接口参数
source 应用id，有票票提供的接口参数
entpara 自定义参数，此参数会体现在用户订单里面
token 双方用户数据对接依据，从接口/api/oauth/member_token获取，用对接方的userId或者手机号来换取member_token
lat 坐标参数，如果没有传坐标参数，将使用ip地址来模糊定位
lng 坐标参数，如果没有传坐标参数，将使用ip地址来模糊定位
4、接口对接
实时在线接口文档，可在线调试，包含有完整的参数样例、返回参数模型，CURL调用样例等
我方接口更新，本说明文档可能不会第一时间更新，但是会实时反馈到在线接口文档
除了获取接口访问令牌/api/oauth/token），其余所有接口调用都需要带上token，也就是在header里带上Authorization:Bearer {access_token}，注意，Bearer后面有空格
请求参数使用json格式，在header里带上：Content-Type:application/json,返回数据也是json格式，code=0表示接口调用成功，其余为失败，返回数据统一格式：
01、创建支付页面
创建以下名称的小程序页面，用于发起用户微信支付 ：
如需下测试单,在调用支付通知接口的时候传参数test=true的时候订单会自动拦截，不会产生正式订单。
吃喝玩乐订单支付通知： 订单支付通知/api/groupbuy_order/pay_order
卡 券 订 单支付通知：订单支付通知/api/gift_card/pay_order
K记/麦记/星爸爸 等点餐 订单支付通知：订单支付通知/api/kfc/pay_order
参数名 说明
orderId 订单id，拿到订单id后请调用接口获取订单应付金额等信息
type 订单类型，0电影订单，1卡券订单，4吃喝玩乐订单，5 点餐 K记/麦记/星爸爸
returnUrl 有票票的订单详情页，如果入款完成，可以选择跳转回此页面
02、创建点餐外卖地址选择页面：
另外微信小程序还需要申请开通 “打开地图选择位置” 权限接口
目前点餐外卖功能暂时只支持星巴克/麦当劳/肯德基
6、创建后台接口对接有票票的数据推送
详细的推送数据说明查看数据推送说明那篇文档。
修改于 2025-07-16 04:06:34