本文指导您在支付宝端外 H5 页面中集成金融级实人认证服务。如果您希望在支付宝端内 H5 页面中进行集成,参看支付宝 H5 页面接入

前提条件

客户端安装的支付宝版本必须是 10.1.32+。
说明 您可以参考以下代码获取支付宝版本号,并做好 startBizService 版本的兼容处理:
const matchResult = window.navigator.userAgent.match(/AliApp\(AP\/([\d\.]+)\)/i);
const apVersion = (matchResult && matchResult[1]) || ''; // 如: 10.1.58.00000170

操作步骤

  1. 唤起支付宝客户端,在支付宝客户端中进行认证。
    1. 服务端发起请求时获取的认证流程入口 url 的基础上拼接支付宝唤端逻辑:const certifyUrl = alipays://platformapi/startapp?appId=20000067&url=encodeURIComponent(url);
    2. 在 H5 页面中通过 location.href=certifyUrl 唤起支付宝并进入实名认证流程。认证结束后,支付宝认证结果页会回调前置条件入参中指定的回调地址。
  2. 回跳原应用。
    1. 准备您的应用的 Scheme。
      • 对于 iOS 平台,在 info.plist 文件中可以设置 URL Schemes(URL types -> URL Schemes)。如图所示:

        如果您设置正确,在 Safari 浏览器中输入 <您设置的 Scheme 名>://,就可以打开 APP了。

      • 对于 Android 平台,您可以在配置清单文件 AndroidManifest.xml 中,设置 URLScheme。如图所示:

        如果您设置正确,您可以在 .html 文件中写入超链接 href="<您设置的 Scheme 名>://index"。然后在 Android 手机上使用浏览器打开 .html 文件,点击链接,即可打开 APP。

    2. 在服务端发起请求时,在 returnUrl 中传入您的应用的 Scheme。详情参看 发起认证请求