开发者社区
社区提问意见反馈
开发者钉组织
扫描二维码
加入支付宝开发者钉组织
 > 刷脸会员登录与支付
收藏
订阅更新
我的文档
设置
产品介绍
本文主要介绍 刷脸会员登录刷脸会员支付 产品。
刷脸会员登录
刷脸会员登录以 支付宝商户会员卡 为基础,在 iot 设备上提供了一种通过刷脸核身的便捷手段,可以一键进行刷脸入会、会员登录的能力。
刷脸会员支付
刷脸会员支付是在刷脸会员登录的基础上,结合支付宝的支付能力,实现会员一键刷脸支付。
产品介绍.png

商户会员卡能力在 iot 刷脸会员卡中的支持情况:
-
商户会员卡
刷脸会员卡
在 iot 设备上不展示
通用能力
通用能力
iot 不需要
通用能力
通用能力
极速版开卡(spi)
通用能力
通用能力
通用能力
通用能力
通用能力
通用能力
仅会员积分、余额信息在 iot 展示
通用能力
在 iot 不展示
在 iot 不展示
在 iot 不展示
在 iot 不展示
不推荐与刷脸会员同时使用
在 iot 不展示
产品价值
刷脸会员卡产品是商家营销的基础能力,满足商家对持有会员卡用户的营销需求。
商家可以根据自己的需求,在支付宝客户端和 iot 设备上自由组合实现电子会员卡功能:引导用户开卡、积分查询、交易记录、卡会员等级查询、卡权益展示、卡适用门店展示等。
商家可以便捷的在 iot 设备上实现刷脸入会 支付。
适用场景
刷脸会员登录
适用于会员登录与支付分开的场景,例如:
自助收银场景,用户先刷脸登录会员,再扫商品,最后完成支付。
自助点餐设备场景,用户先刷脸登录会员,再选择商品,最后完成支付。
双屏 pos 设备,店员引导用户刷脸登录会员,进行商品录入,最后完成支付。
刷脸会员支付
适用于会员登录与支付一体场景,例如:
自助售卖机,用户选取商品后,刷脸会员支付。
蜻蜓设备,用户先购买商品,店员扫完商品后,刷脸会员支付。
注意:必须给用户刷脸会员支付/刷脸支付的选项。
准入条件
该能力对 支付宝企业账号个体工商户 开放。
商户会员卡只获取用户 uid、头像、昵称三项会员信息。
获取会员敏感信息(例如:姓名、手机号、证件号等)需加入 ,联盟成员可使用 获取会员信息 功能包,在线申请开通获取敏感会员信息的授权接口。联盟成员需要严格遵守个人信息保护相关法律法规及监管要求,确保具备隐私保护及数据安全能力;联盟成员须遵守 用户信息处理规范应用安全开发指南 等规则,谨慎使用授权接口。目前敏感信息暂不对个人账号开放。申请加入蚂蚁数据安全与隐私保障联盟的流程如下:
准入条件.png

刷脸会员支付需要商家签约 当面付
接入准备
1使用 支付宝企业账号 入驻 ,可查看
2创建 abcp 应用,应用类型选择 iot移动应用,应用平台选择 android,可查看
3按照需求添加服务,可查看
服务名称
服务编码
刷脸会员登录
bpaassmilecard
刷脸会员支付
bpaassmilecardpay
系统要求
依赖项
版本说明
获取/安装方式
设备系统
≥ android 4.4
设备提供商/系统开发商预装
iot sdk
≥ 3.7.0
登录 abcp 平台 > 开发工具 > ,下载 iot sdk 最新版本。
工程配置可查看
abcp sdk
≥ 5.2.1
登录 abcp 平台 > 开发工具 > ,下载 abcp sdk 最新版本。
可查看 进行开发准备。
abcp api
≥ 2.0.1
接入指南
在对接 刷脸会员登录 / 刷脸会员支付 前,商家需先 接入商户会员卡接入发券能力。
接入商户会员卡
未对接过商户会员卡的商家,可查看 商户会员卡接入准备,支付宝提供了 帮助快速接入,也可以通过页面右侧咨询入口获取凯发app官方网站的技术支持。
商户会员卡接入.png

已在支付宝客户端对接过商户会员卡的商家,iot 刷脸会员提供了 openapi 开卡spi 极速版开卡 两种开卡方式。二者的区别为极速版开卡耗时相较 openapi 开卡降低一半,且极速版开卡支持商家在用户入会后判断用户刷脸入会商家纯新会员发券。
说明
iot 开卡默认为 spi 开卡,若希望使用 openapi 开卡,则需要在刷脸会员组件调用时通过入参进行设置。
在 iot 上实现 spi 极速版开卡,支付宝客户端内仍然可以使用 openapi 开卡,商家也可以选择在支付宝客户端内进行开卡链路优化。若需要接入 spi 极速版开卡,需通过页面右侧咨询入口联系凯发app官方网站的技术支持,获取接入文档。
接入发券能力
iot 会员发券提供了三种发券能力:
入会有礼:支付宝卡包新会员发券能力。
刷脸入会时商家纯新会员发券:区分支付宝卡包新会员、商家系统新会员的发券能力。
支付宝商户会员卡老会员发券。
注意:会员发券能力只是一个分发逻辑,不一定在当笔完成核销。
入会有礼
支付宝为 iot 接入会员卡的商家提供标准的入会有礼配置,支持商家通过配置入会有礼活动进行会员拉新。商家可在支付宝商家中心自行配置入会有礼活动,并通过 iot 刷脸机具进行展示,引导用户进行权益领取及授权开卡。
1登录 > 运营中心 > 营销工具
营销工具.png

2在营销工具页面点击 会员卡管理 > 在我的会员卡列表选择要配置的会员卡,点击 管理。
会员卡管理.png

3 在会员卡详情页点击 添加入会有礼 进行配置,可查看 拉新:配置入会有礼
添加入会有礼.jpg

领券展示
入会有礼2.png

入会有礼投放规则
只能通过调用刷脸会员组件时入参传入 benefitid(活动 id)进行指定,若不传,默认展示为创建时间最早的开卡有礼活动。
入会有礼领取规则
卡包侧未开卡用户在活动有效期内开卡可领取。
一个用户同一个入会礼只能领取一次,并且同一个卡下的不同入会礼 6 个月内只能领取一次。
刷脸入会商家纯新会员发券
入会有礼仅针对支付宝商户会员卡新用户,商家无法判断是否是商家 saas 系统新 / 老会员。因此在 iot 设备上,提供了一种可以让商家区分 支付宝商户会员卡新会员商家 saas 系统老会员支付宝商户会员卡新会员商家 saas 系统新会员(即商家纯新会员)的发券方式,并且针对这两种情况,区分不同发券链路。
注意:刷脸入会时商家纯新会员发券和入会有礼逻辑互斥,二者只能使用其一。
1登录 > 运营中心 > 营销工具 > 优惠券管理 > 创建优惠券
创建优惠券.jpg

2选择全场券或者单品券,点击 立即创建 进行优惠券配置。商家纯新会员发券具体配置可查看
创建优惠券2.jpg

说明:商家实现 spi 开卡时,根据开卡人信息与卡模板动态决定,发券的 pid 需要与卡模板相同。
领券展示
刷脸入会商家纯新会员发券2.png

刷脸入会时商家纯新会员发券领取规则
入会有礼和刷脸入会商家纯新会员发券展示逻辑互斥,商家纯新会员发券仅在无入会有礼活动、返回有效活动 id 时展示。
商家侧根据新老会员可能返回不同的活动 id,或者不返回。
支付宝商户会员卡老会员发券
1登录 > 运营中心 > 营销工具
营销工具.png

2在营销工具页面点击 会员卡管理 > 在我的会员卡列表选择要配置的会员卡,点击 管理。
会员卡管理.png

3 在会员卡详情页点击 添加卡详情优惠 进行配置。
添加卡详情优惠.jpg

领券展示
支付宝商户会员卡老会员发券2.png

老会员卡详情优惠领取规则
仅已开卡情况下在卡详情展示,不支持指定活动 id。
配置商家权益展示
iot 刷脸会员在 iot 设备给商家提供了一个权益展示的阵地,可以展示商家的积分、余额权益,以及在卡包里配置的权益。
积分及余额展示配置
可查看 定制化展示
卡包权益展示配置
1登录 > 运营中心 > 营销工具
营销工具.png

2在营销工具页面点击 会员卡管理 > 在我的会员卡列表选择要配置的会员卡,点击 管理。
会员卡管理.png

3在会员卡详情页找到会员权益,点击旁边的 修改 进行配置。
会员权益修改.jpg

商家权益展示
会员权益展示逻辑:如有权益,则展示(权益最多展示 3 个);如无权益,则展示默认页面。
配置商家权益展示2-1.png
配置商家权益展示2-2.png

刷脸会员登录/支付接入
接入流程图
刷脸会员登录 支付接入.svg

接入步骤
1商家 app 启动时完成 bpaasapi.int(接入流程图步骤 1 ~ 3),仅需在 app 启动时调用一次,可查看
2按照需求调用刷脸会员服务(bpaassmilecard 或者 bpaassmilecardpay)并返回用户开卡信息(接入流程图步骤 4 ~ 20)。
3商家服务端扩展 (会员卡开通,获取会员卡信息)spi 接口,通过该接口返回相关的会员卡信信息。
服务入参
参数
类型
是否必填
描述
serviceparams
jsonstring

会员卡参数,详情可查看下表。
displaymode
int

双屏设备刷脸是否显示到副屏。
1:显示到副屏。
0:显示到主屏。
默认值:0。
extinfo
jsonstring

预留扩展字段。
serviceparams 对应数据类型,jsonstring 格式:
参数
类型
是否必填
描述
cardproviderid
string

配置会员卡模板对应的商家 pid。
cardappid
string

用于配置会员卡模板的开放平台应用 appid。
templateid
string

会员卡模板 id。
isvpid
string

会员开卡对应服务商(isv)pid。
isvappid
string

用于配置会员卡模板的 isv 应用 appid。
benefitid
string

会员开卡页面展示入会有礼权益,如不传,则不展示入会有礼。
callbacktype
string

开卡方式。
spi:spi 开卡方式。
openapi:openapi 开卡方式。
如不传或输入非法参数,默认使用spi 开卡方式。
服务出参
参数
类型
是否必填
描述
code
int

刷脸状态码。
1000:成功。
subcode
string

刷脸错误码,z 码。
submessage
string

错误信息。
code==1000 代表刷脸成功,出参会包含以下参数:
barcode
string

刷脸支付 28 码,需要根据场景来配置。
ftoken


刷脸 ftoken。
alipayuid


用户 uid。
openresult
int

开卡结果。
0:求知
1:成功
2:失败
示例代码
内容没有解决您的问题?您还可以前往 或 寻求帮助
凯发k8官方网娱乐官方 copyright © 支付宝(杭州)信息技术有限公司  | icp证浙b2-20160559
该文档对你是否有帮助?
当前页面目录
网站地图