小程序对接流程v1.1

📌

1、在小程序后台添加业务域名：
https://www.qipiao.net
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

3、小程序里面创建WebView，src赋值为我方的页面地址
注：在使用以下链接时，请确保对动态参数进行 URL 编码（URL Encoding），以避免因特殊字符（如 &, =, % 等）导致链接解析错误。

注意事项
除了获取接口访问令牌/api/oauth/token），其余所有接口调用都需要带上token，也就是在header里带上Authorization:Bearer {access_token}，注意，Bearer后面有空格
请求参数使用json格式，在header里带上：Content-Type:application/json,返回数据也是json格式，code=0表示接口调用成功，其余为失败，返回数据统一格式：

获取页面地址Url里面的{member_token}参数，需调用我方的接口

获取会员token：

订单有超时未付取消机制，电影订单时10分钟，其他订单时20分钟；要注意，超时的订单就不要让用户支付了，如果超时支付，会照成你们收了用户的钱，但在我们这边支付订单失败。

5、创建小程序页面
01、创建支付页面
创建以下名称的小程序页面，用于发起用户微信支付：

小程序支付页面地址：

用户支付完成，对接方收到微信支付通知成功后，调用我方的的支付通知接口
如需下测试单,在调用支付通知接口的时候传参数test=true的时候订单会自动拦截，不会产生正式订单。

电影票订单支付通知：支付订单(支付成功后调用)/api/movie/pay_order
吃喝玩乐订单支付通知：订单支付通知/api/groupbuy_order/pay_order
卡券订单支付通知：订单支付通知/api/gift_card/pay_order
肯德基/麦当劳/星巴克单支付通知：订单支付通知/api/kfc/pay_order

跳转参数说明
参数名说明
orderId 订单id，拿到订单id后请调用接口获取订单应付金额等信息
type 订单类型，0电影订单，1卡券订单，4吃喝玩乐订单，5肯德基/麦当劳/星巴克
returnUrl 我方的订单详情页，如果入款完成，可以选择跳转回此页面
02、创建点餐外卖地址选择页面：

用户选择完地址后，会拿到经纬度和具体地址信息，然后赋值给address的lat lon addr 最后拼接在returnUrl的address返回给我们，完成地址的选择
另外微信小程序还需要申请开通 “打开地图选择位置” 权限接口
目前点餐外卖功能暂时只支持星巴克/麦当劳/肯德基
6、创建后台接口对接我方的数据推送
详细的推送数据说明查看小程序数据推送那篇文档。