唤起支付宝小程序(不推荐新接入)

更新时间:2020-09-21 16:47:31

支持以下2种方式,实现客户支付宝小程序直接唤起e签宝支付宝小程序完成签署 。

  • 方法一,使用支付宝官方提供的方法,唤起e签宝支付宝小程序
  • 方法二,使用外部链接唤起e签宝支付宝小程序


方法一:支付宝官方方法

接口描述 

完成签署流程配置后,通过获取到的flowId和signerId使用支付宝小程序my.navigateToMiniProgram方法调用e签宝小程序进行文件签署。小程序跳转方法详见支付宝官方文档(https://docs.alipay.com/mini/api/yz6gnx

请求参数

参数类型是否必填说明
envstring

对接接口环境,默认为prod:
prod=生产环境,sml=模拟环境
pagestring

签署页面路径,签署页固定 'sign'
flowIdstring

签署流程ID
signerIdstring

签署人ID
forwardHomeboolean

签署完成页是否引导前往支付宝首页,默认为true


请求示例

my.navigateToMiniProgram(
   {
    appId:'2019042964339413',(值固定,无需改动)
    path:'pages/startup/index', (值固定,无需改动)         
    extraData:{
        page:'pages/startup/index',                       
        query:{
          env:'prod',
          page:'sign',                       
          flowId:'123456789',                       
          signerId:'ABC123',                       
          forwardHome:'true',
          },
        },
    success:(res) => {
    console.log(res.extraData.code)//{ code, msg, data }
    },
fail:(res) => {
console.log(JSON.stringify(res))
}
});


小程序返回结果 

用户操作完成后,我们会回跳原小程序,可在extraData中获取操作结果。可能出现的操作结果如下表:

code(number)msg(string)data(object)
000签署成功
001等待用印审批
002部分签署失败原因+失败文档
003签署失败原因
004签署中,请稍后查询结果
101支付宝账号未实名,无法签署
102签署人信息不一致,无法签署
103不支持的证件类型
201签署人拒绝签署
202发起人撤回流程


方法二:外部链接唤起方法

也可以基于上述参数拼接支付宝urlscheme,有两种方式进行签署:

  • 生成小程序签署二维码,用户使用支付宝扫码后,可打开e签宝小程序进行签署;
  • 使用url跳转小程序进行签署。
const appId = '2019042964339413'
const page = '/pages/startup/index'
const query = 'env=prod&page=sign&flowId=12346789&signerId=ABC123&forwardHome=true'
`alipays://platformapi/startapp?  appId=${appId}&query=${encodeURIComponent(query)}&page=${encodeURIComponent(page)}`
我要纠错