微信小程序内集成签署H5对接说明

接入前准备工作及注意事项

配置业务域名

微信小程序中规定必须成功配置业务域名后，才可以加载第三方域名下的网页。因此，开发者需要先配置业务域名，具体配置方法详见小程序配置e签宝OpenAPI业务域名说明。

沙箱模拟环境中也可以设置不校验业务域名进行开发调试，正式生产环境中必须设置业务域名。

注意事项

后端开发如何传参数？

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

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

重定向地址 redirectUrl 支持传入固定值wechat://back或者https协议的地址

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

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

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

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

重定向地址传入(https协议的), 重定向跳转延迟时间传0 => 签署完成会自动跳到重定向地址

重定向地址传入(https协议的), 重定向跳转延迟时间非0 => 签署完成到结果页 => 点击返回跳动重定向地址/或者倒计时结束自动跳到重定向地址

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

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

2.通过接口【获取签署地址】获取到签署地址嵌入到贵司的微信小程序中使用

注意：因只有长链地址才可以配置小程序需放行的自定义域名，所以必须使用长链地址

微信小程序刷脸方式说明

概要说明

1.该对接方式，是贵司小程序通过 web-view 对接签署 H5 页面，在做实名或者签署意愿认证时，可使用小程序刷脸（跳转到e签宝公证签小程序做刷脸，刷脸完成后跳回贵司小程序，完成后续流程）。

2.由于 web-view 网页能力限制，无法实现直接跳转到另一个小程序，需要借助小程序原生页面跳转。所以在实名/意愿页面上发起刷脸时，需要先跳转到当前贵司小程序中间页，再由贵司小程序中间页去跳转到公证签小程序。

3.由于小程序规定需要用户触发（点击小程序页面上任意位置）才能跳转，所以贵司小程序中间页上需要有按钮让用户点击跳转到公证签小程序。

小程序刷脸内部流转流程图

<此图中的客户小程序即为贵司小程序>

接入流程

1.登录e签宝开放平台配置微信小程序刷脸中间页地址。配置方法：点击跳转。

2.在实名/意愿页面上点击发起刷脸认证时，实名/意愿页面会携带 刷脸所需的 bizToken 和 刷脸完成后的重定向地址 redirectUrl 跳转到贵司小程序中间页，跳转的目标地址 url 即为上一步中所配置的贵司中间页地址。

window.wx.miniProgram.navigateTo({
  url: `${url}?bizToken=${bizToken}&redirectUrl=${encodeURIComponent(redirectUrl)}`
})

3.贵司小程序中间页上实现点击跳转至公证签小程序

wx.navigateToMiniProgram({
  appId: 'wx1cf2708c2de46337',  // 公证签小程序APPID
  path: `/pages/face/index?bizToken=${bizToken}`, // 刷脸页面地址
})

4.完成刷脸后，公证签小程序会通过如下方式跳回至贵司小程序，并携带刷脸结果 faceResult

wx.navigateBackMiniProgram({
  extraData: {
    faceResult: res, // 刷脸结果
  }
})

5.贵司小程序在拿到刷脸结果后使用 web-view 重新打开第2步拿到的重定向地址 redirectUrl

用户刷脸流程截图

微信小程序demo

点击下载：esign-wxmini-demo.zip，请参照DEMO中的场景一进行集成对接。