开发者社区
社区提问意见反馈
开发者钉组织
扫描二维码
加入支付宝开发者钉组织
android 开发文档
windows 开发文档
linux 开发文档
iot 小程序开发文档
其它
api
收银台
刷脸核身
刷脸登录
会员与授权
发送付款码
发送和接收小指令
版本查询
获取系统属性
系统设置页面
二维码识别
生成二维码
ui 控制
语音播报
本地数据库
本地图片存储
串口通信
外设管理
打印指令
监听按键事件
身份证读卡器适配
电子秤
钱箱
非接卡通信
ic 卡通信
红外测温仪
消息服务
日志服务
前后屏通信
更多使用指南
开发 > 开放能力接入 > 其它 > api >  > my.ix.facelogin
收藏
订阅更新
我的文档
设置
简介
my.ix.facelogin 是刷脸登录接口,刷脸登录是指通过刷脸获取用户支付宝 user_id 来核实用户身份,同时保持用户 90s 登录状态的功能。
场景介绍
调用该接口对用户核身成功后,将保持用户 90s 登录状态的功能。在登录状态下商家调用小程序操作用户身份相关的api时无需再次刷脸获取授权,如 商家会员卡 等,可以实现快速拉新的效果。需要注意的是涉及付款的接口依旧需要再次刷脸。
刷脸登录后将保持用户 90s 内的登录状态(不支持自定义),90s 后将自动退出登录状态。也可主动调用 接口进行登出。
刷脸登录分为两种模式:
单一刷脸登录模式:此模式下无需传入特定参数(verifytype、certno、certname),刷脸成功即能登录。
刷脸登录 核身模式:此模式下需要传入 verifytype,certno,certname 三个参数,用于比对人脸 姓名 身份证号码三项是否匹配,只有上述三项完全匹配,才能登录成功。
使用限制
单一刷脸登录模式:要求小程序容器 10.1.80.16 及以上版本。
刷脸登录 核身模式:要求小程序容器 10.1.80.40 及以上版本。
接口调用
.js 示例代码
单一刷脸登录
javascript
复制代码
// .js
my.ix.facelogin ({
success: (r) => {
console.log("success");
},
fail: (r) => {
console.log("errorcode:" r.error);
}
});
刷脸登录 核身模式
入参
参数
类型
必填
描述
certno
string

用户身份证号,verifytype=idcard 时填写。
certname
string

用户姓名,verifytype=idcard 时填写。
verifytype
string

idcard
success
function

成功的回调函数。
fail
function

失败的回调函数。
complete
function

结束的回调函数:
成功时,先回调 success 再回调 complete。
失败时,先回调 fail 再回调 complete。
出参
成功
参数
类型
描述
success
boolean
是否成功。
buyerid
string
买家支付宝 user_id。
devicesn
string
机具 sn。
ftoken
string
目前无效,请勿使用 ftoken 进行支付。
失败
参数
类型
描述
error
number
错误码。
errormessage
string
失败的具体原因。
内容没有解决您的问题?您还可以前往 或 寻求帮助
凯发k8官方网娱乐官方 copyright © 支付宝(杭州)信息技术有限公司  | icp证浙b2-20160559
该文档对你是否有帮助?
当前页面目录
网站地图