小Y聚合收银台接入说明

一、申请半屏调用权限

1. 打开 微信公众平台，商户扫码登录。
2. 商户前往【设置】—>【第三方设置】—>【添加】，搜索框内输入小Y聚合收银台AppID，等待审核通过。

二、打开收银台

半屏打开：wx.openEmbeddedMiniProgram

普通（全屏）打开：wx.navigateToMiniProgram

1. （2.23.1及以上版本起无需配置） 配置跳转的AppID。 2.23.1以下版本基础库，开发者需要在全局配置app.json的embeddedAppIdList字段中声明需要半屏跳转的小程序，若不配置将自动切换为普通的全屏小程序跳转。
   示例：

    {
        "embeddedAppIdList": ["小Y聚合收银台AppID"]
    }

1. 预下单接口(参见-接口文档)请求成功后调用wx.openEmbeddedMiniProgram

1. 是否立即支付。默认情况下，打开收银台后，用户需要手动点击“立即支付”按钮才会拉起支付控件。如果希望省略点击动作，可以传入参数isFastPay='01'，即可在进入收银台后自动拉起支付控件。详细说明可参考预下单接口

2. 支付完成回调参数（仅小程序打开收银台场景下适用）。用户支付成功并且在微信支付结果页面点击完成按钮后，将自动返回商户小程序，并传递参数payResult。商户小程序可在app.js的onShow方法里获取该参数(若小程序由uni-app开发，则在App.vue的onShow方法里获取)。
   若用户支付完成后没有点击完成按钮，而是退出小程序，此时不会触发回调。是否支付成功应以服务端结果为准。
   若开启了点金计划，也不会触发回调，可联系运营申请关闭

   wx.navigateBackMiniProgram({
    extraData: {
        payResult: 'success',//仅当支付成功并点击“完成”按钮情况下为success,其余情况为fail或空
    },
    success(){},
    fail(){}
   })
   

半屏打开参考代码：

wx.request({
  url: '预下单接口',
  data: {},
  header: {},
  success (res) {
    // 预下单成功后再打开收银台
    if(res.subCode === '0'){
        businessData.data.isFastPay = '01' // 需要省略点击支付动作才传该参数
        wx.openEmbeddedMiniProgram({
            appId: '小Y聚合收银台AppID',
            path: 'pages/index/index', //打开的页面路径
            extraData: { 
                //解密后的数据，Object类型。直接将接口返回的businessData转换成Object后传入即可
                businessData: {
                    "data": {
                        "reqMsgId": "",
                        "amount": "",
                        "mercId": "",
                        "orderId": "",
                        "orderCreateTime": "",
                        "orderEfficientTime": "",
                        "encryData": "",
                        "payUrl": "",
                        ...其它参数
                    },
                    "resultCode": 0,
                    "message": "下单成功",
                    "suffixCode": 0,
                    "rpcError": false
                }, 
            } 
        })
    }
  }
})

全屏打开参考代码

若不满足半屏跳转将自动切换为普通的小程序跳转，不影响用户使用。 如需全屏打开可调用以下api

wx.navigateToMiniProgram({
    appId: '小Y聚合收银台AppID',
    path: 'pages/index/index',  //打开的页面路径
    extraData: { 
        businessData: '解密后的数据，Object类型',
    }  
})

成功打开示例(左-半屏，右-全屏)