文档中心>人脸核身

H5(支付宝小程序)

最近更新时间:2024-08-22 15:14:11

我的收藏

接入说明

支付宝小程序环境中,接入身份认证 H5 比较特殊,需要使用支付宝小程序web-view组件的方式来承载 H5 页面。




接入流程

配置业务域名

由于小程序加载的 H5 页面有域名访问限制,因此需要配置业务域名:
登录支付宝开放平台的控制台 > 小程序详情页 > 开发设置 > H5 域名配置(联系慧眼小助手添加授信文件)



将以下域名配置到业务域名白名单
// 慧眼域名
faceid.qq.com
// 业务侧redirect_url跳转域名
如果有任何问题可以查询官方的配置文档:支付宝小程序 web-view 组件官方文档

支付宝小程序加载访问

1. web-view 打开核身链接
2. 认证结束跳转到 redirect_url 页面,业务侧监听该参数的变化,决定后续逻辑。
代码示例:
<web-view :src="src" @load="handleLoad" @message="handleMessage"></web-view>
handleLoad(e){
const src = e.detail.src;
console.log('webview IntentionLoad', 'src=>',src)
// 处理业务逻辑,例如退出小程序等
}

常见问题

开启支付宝授权相机和麦克风

因人脸核验、上传身份证证件需要用户开启相机、麦克风等授权,否则将无法进行正常核验。
验证前建议先检查用户设备是否给支付宝授权相机和麦克风权限,如没有授权,可参考如下设置方式开启:
打开手机设置>支付宝设置>开启麦克风、相机权限。