场景说明
开发者通过内嵌e签宝H5签署/认证页面方式进行APP集成。当用户选择支付宝人脸识别方式进行实名/意愿操作时,用户会从开发者APP跳转到支付宝APP进行人脸识别,刷脸识别通过后,自动返回开发者APP完成本次操作。
对接流程图
集成对接示例DEMO
点击下载:App认证和签署内嵌H5对接Demo_V3.zip(更新时间:2024年11月7日)
步骤简要说明
1.后端接口获取签署/认证的H5地址
- 通过接口【基于文件发起签署】时,需要字段:availableSignClientTypes(签署终端类型) 传:1 (网页端)。
- 通过接口【获取签署页面链接】获取签署H5地址;appScheme字段传入开发者自己的app的scheme地址,demo参考示例值:esign://demo/signBackdemo
- 通过接口【获取个人认证&授权页面链接】或【获取机构认证&授权页面链接】获取认证H5地址;appScheme字段传入开发者自己的app的scheme地址,demo参考示例值:esign://demo/realBack
2.开发者APP webview 加载url
3.加载url后显示签署/认证页面(签署需选择印章再提交)
4.点击提交后会出现实名/意愿认证界面,选择支付宝人脸识别方式
5.跳转到支付宝中进行认证,认证后从支付宝回到开发者APP
app通过拦截webview加载的地址进行相关处理:
- 需要监听url的scheme如果是alipays,要跳到支付宝进行认证;
- 从支付宝认证结束后从返回的uri里获取对应的地址进行加载,拦截到url的scheme是开发者APP的,通过url上拼接的字段值来获取签署/认证结果。
注:4.2版本以上的纯血鸿濛系统暂时不支持支付宝刷脸后自动返回开发者App(目前支付宝暂未支持后续会持续跟进),需要用户手动从支付宝返回开发者App内,App内的e签宝H5会监听刷脸完成状态做后续跳转。
(详细代码说明可以参考DEMO内文档)