微信小程序对接签署说明（推荐）

更新时间：2023-09-14 15:07:12

注意：该对接方式是直接跳转到e签宝公证签小程序做的签署，无需与H5页面通信，无需放行域名

后端开发如何传参数？

1.发起签署字段说明（【一步发起签署】接口或者分步的【签署流程创建】接口）

后端发起签署时需要指定签署平台为h5："signPlatform": "1"

签署完成若想自动跳转到贵司小程序中需要传重定向地址："redirectUrl": "wechat://back"

重定向跳转延迟时间redirectDelayTime可根据实际情况传入

重定向跳转及跳转延迟时间逻辑

重定向地址传入(wechat://back), 重定向跳转延迟时间传0 => 签署完成会自动回到贵司小程序

重定向地址传入(wechat://back), 重定向跳转延迟时间非0 => 签署完成到结果页 => 点击返回会自动回到贵司小程序/或者倒计时结束自动回到贵司小程序

重定向地址传空 => 签署完成到结果页 => 点击查看文件到文件详情页 => 左上角手动返回到贵司小程序

以【一步发起签署】接口为例字段所在截图：

微信小程序端接入流程

1.唤起“e签宝上链公证签”小程序完成签署

需要使用第1步发起签署获得的签署流程id：flowId，以及签署传入的签署账号id：accountId。env根据当前使用环境选择，沙箱环境为：sml，正式环境为：prod（默认值）。

// 该方法官方文档使用参考: https://developers.weixin.qq.com/minigame/dev/api/navigate/wx.navigateToMiniProgram.html
wx.navigateToMiniProgram({
  appId: 'wx1cf2708c2de46337',  // 上链公证签小程序APPID
  path: '/pages/index/index', // 上链公证签页面地址
  extraData: {
    requestObj: {  // 必填，入参
        flowId: 'xxxxx', // 必填，签署流程id
        accountId: 'xxxxx', // 签署必填，账号id
        type: 'SIGN',// 非必填，业务类型：签署 SIGN（默认）
        env: 'sml' // 非必填，对接环境：线上 prod(默认）, 模拟 sml(用于对接调试阶段）
    },
    callbackObj: { // 非必填，回传数据：签署完成后会将此数据完整回传
    }
  },
  success(res) {
    // 根据自身需要
  },
  fail(res) {
    // 根据自身需要
  },
  complete(res) {
    // 根据自身需要
  },
})

2.签署后“e签宝上链公证签”小程序会使用以下方式跳回贵司自己的小程序

贵司小程序在 onShow 方法中可接收到上链公证签小程序返回的 extraData 数据，从而完成后续业务逻辑。

// 该方法官方文档使用参考: https://developers.weixin.qq.com/miniprogram/dev/api/navigate/wx.navigateBackMiniProgram.html
wx.navigateBackMiniProgram({
  extraData: {
    isSuccess: true // 签署是否成功，true/false
    msg: 'success'// message，成功 success，失败 fail
    callbackObj: { // 回传之前传入的数据
    }
  }
})

注意：默认签署完成跳回贵司自己的小程序的页面为跳转“上链公证签”小程序前的贵司的初始页面，如果想要签署完成跳到贵司小程序指定页面可以用以下方式：

（1）可以在跳转前设置自定义数据callbackObj，用于后续判断跳回小程序的来源。

（2）跳回小程序时，会触发onShow方法，在该方法中做逻辑判断，确定来源后，进行跳转到指定页面。

onShow方法代码示例：

onShow: function (options) {
    console.log(options,'options');
    if( typeof options.referrerInfo.extraData != 'undefined' ){
      if(options.referrerInfo.extraData.callbackObj.from == 'esign'){
        //如果需要进行跳转的话，可以在这边处理，跳转到自己的小程序某个页面
          wx.navigateTo({
            url: '/pages/logs/logs'
          })
      }
    }
  },

onShow方法中打印的内容：