uni-app本身不支持刷脸支付,小程序端必须用my.biometrics.verify(需manifest声明scope.userface、开放平台开通生物认证、用户主动触发、type为'face'),APP端须原生插件封装支付宝SDK并配置权限与密钥,前后端必须协同完成authcode验签,不可跳过。

uni-app 本身不支持直接调用支付宝刷脸支付,必须区分运行环境:小程序端走 my.biometrics.verify,APP端必须封装支付宝原生 SDK 并通过原生插件桥接,两者完全不可混用。
mp-alipay 小程序端:用 my.biometrics.verify 最简可行
支付宝小程序生态内,my.biometrics.verify 是唯一支持金融级活体检测的官方 API,无需额外 SDK,但硬性前提缺一不可:
- manifest.json 中已声明
"scope.userface"权限 - 支付宝开放平台对应应用已开通「生物认证」功能并审核通过
- 调用必须绑定用户主动触发(如
@click="startVerify"),不能在onLoad或页面初始化时自动执行,否则 iOS 会静默拒绝授权 -
type: 'face'是强制参数,传'fingerprint'或留空会导致静默失败
成功回调中 res.authresult === 'success' 仅代表活体+人脸比对通过,返回的是单次有效的 authcode,不是最终认证结果——后端必须立刻用它调用 alipay.security.risk.face.verify 接口验签,5 分钟过期且不可重放。
APP 端(Android/iOS):必须走原生插件封装
uni-app 的 app-plus 编译目标无法直接调用支付宝人脸 SDK 的 Java/Swift 接口,常见错误是试图用 H5 页面跳转模拟,结果被支付宝拦截或根本无法触发活体检测。
- Android 需集成
alipaysdk-15.8.03.jar及libs/armeabi-v7a/libalipayface.so等 so 文件,并在AndroidManifest.xml声明AlipayFaceActivity - iOS 需在
Info.plist添加LSApplicationQueriesSchemes(含alipayssofacepay),并链接AlipayFaceSDK.framework - 插件初始化时必须传入有效的
appid、应用私钥、支付宝公钥,三者缺一不可;否则initSDK返回失败但无明确错误码 - 调用
startFaceAuth前,必须确保用户已授予camera权限,Android 还需android.permission.RECORD_AUDIO(因活体检测含语音指令)
不能跳过后端验签,这是安全底线
前端拿到的 authcode 是一次性临时凭证,仅用于后端向支付宝发起验签请求。若跳过这步、直接在前端判断“认证成功”,等于完全绕开支付宝风控体系,既不符合《个人信息保护法》对生物特征数据的处理要求,也不满足金融级实名认证的合规底线。
尤其要注意:支付宝不会在前端返回用户真实身份信息,所有敏感字段(如姓名、身份证号)都只在后端验签成功后的响应中返回,且需由服务端完成脱敏与日志留存。











