# 青蛙刷脸会员接入文档

# 一、青蛙刷脸会员介绍

青蛙App2.20版本起支持“刷脸会员”能力，用户在青蛙刷脸后可以“开通会员”、“使用会员身份支付”。

# 1. 青蛙刷脸会员流程

# 2. 青蛙刷脸会员能力介绍

刷脸会员拥有“刷脸即会员”、“刷脸识别会员及一键支付”、“刷脸会员互动”三大能力。

1）刷脸即会员

1.1 支付前开卡： 用户可以在支付前开卡，本单享受会员权益，相较于支付后开卡，有助于提升用户的开卡意愿。

1.2 一键开卡： 用户可以免输入一键注册会员卡，支持姓名、手机号、生日、性别4个字段。
姓名 - （考虑到青蛙编辑不方便的情况）不支持修改，默认读取用户在卡包填入的姓名信息，若未曾填入，则以微信昵称代替；
手机号 - （考虑到青蛙编辑不方便的情况）不支持修改，默认读取用户在卡包填入的的手机号，若未曾填入，则填入用户微信绑定的手机号；
生日 - 支持修改，默认读取用户在卡包填入的生日，若未曾填入，则为空；
性别 - 支持修改，默认读取用户在卡包填入的性别，若未曾填入，则为空。

1.3 开卡有礼： 支持商户配置开卡有礼活动，用户在开卡成功后可以领取开卡有礼的优惠券（详细配置流程详见第二章-3.5配置开卡有礼）。

2）刷脸识别会员及一键支付

2.1 刷脸识别会员： 用户刷脸后，青蛙App会识别用户的卡包会员身份，并展示会员的权益以及会员的微信支付代金券。
会员权益 - 会员权益最多展示3个（如下图），会员权益只展示微信卡包中有参数的会员权益，若会员权益为“查看（点击后跳转）”时，刷脸会员不展示。
微信支付代金券 - 会员权益页会默认展示用户微信账户中的微信支付代金券，微信支付代金券按照最大优惠原则自动核销，无需用户主动使用。
2.2 会员一键支付： 用户刷脸识别会员身份后，在1分钟内可以一键支付；出于账户安全考虑，若超过1分钟，用户点击确认支付后需要再刷一次脸。

3）刷脸会员互动

3.1 支付结果页小程序运营位： 商户可在刷脸支付结果页配置"支付结果页小程序"，将刷脸支付的流量沉淀至小程序中；若用户点击小程序，则在用户手机端的使用记录中会出现该小程序。

# 3. 青蛙刷脸会员价值

刷脸会员通过"刷脸即会员"、"刷脸识别会员及一键支付"、"刷脸会员互动"三大能力，助力商户提升会员拉新、会员识别&支付和会员经营的效能。

	传统会员	刷脸会员
会员拉新效率 =会员注册量/支付笔数	“刷脸即会员”功能将刷脸会员的拉新效率提升至传统会员拉新方式的10倍
会员识别&支付效率	会员识别&支付的耗时约5秒	1.突显用户会员权益 2.会员识别&支付的耗时缩短为2秒
会员经营效能	-	沉淀会员流量至公众号、小程序等渠道

# 4. 商户小程序调起刷脸会员组件

青蛙APP2.21版本起将支持商户小程序调起刷脸会员组件。通过调起刷脸会员组件商户可在小程序内使用微信卡包的开卡能力实现一键开卡，同时有效降低商户在会员场景的开发成本。
1）刷脸即会员
若商户仅需应用微信卡包的开卡能力，可调用刷脸会员开卡组件接口，在小程序需要开卡时直接调起会员开卡页面。

有登录态时，直接调起
无登录态时，需用户刷脸后调起

2）刷脸识别会员
小程序可调用刷脸会员组件接口，无需传入参数直接打开刷脸会员组件；刷脸会员组件会通过青蛙APP查询会员信息，向用户展示相关会员权益页面。

# 二、青蛙刷脸会员接入流程

为方便商户接入，青蛙刷脸会员是基于微信卡包系统研发的会员工具，开发成本极低（部分商户可免开发），接入流程分为三步：
步骤一：接入微信卡包 （已接入微信卡包的商户可跳过） 步骤二：适配刷脸会员场景 （普通一键激活的商户可跳过） 步骤三：配置刷脸会员

# 1. 接入微信卡包

微信卡包：接入文档
若是新接入的商家，如若无特殊需求，建议使用"普通一键激活"的激活方式
刷脸会员暂不支持"自动激活"的激活方式

# 2. 适配刷脸会员场景

若商户会员卡的激活方式为：普通一键激活，则无需适配刷脸会员场景
若商户会员卡的激活方式为：跳转型一键激活或者接口激活，则需要适配刷脸会员场景

2.1 激活方式的判断方法

普通一键激活： 使用微信官方的开卡页，且填写完资料点击激活后直接激活成功，无任何页面跳转
跳转型一键激活： 使用微信官方的开卡页，且填写完资料点击激活后会跳转商户页面
接口激活： 使用商户的开卡页
自动激活（暂不支持）： 无激活页面，且base_info中增加"auto_activate": true

2.2 跳转型一键激活和接口激活的适配方法

商户手机端的开卡流程不变，同时兼容刷脸侧的开卡分支流程。
商户只需要兼容用户信息的接收方式，即接收用户激活后通过事件推送的用户注册信息，并在接收到事件推送后，继续进行商户会员系统的其他注册流程，最终调用激活接口来激活会员卡。

接收事件推送的详细流程：
点开链接 - 6.2一键激活 - 6.2.1普通一键激活 - 步骤三接收会员信息事件通知

配置事件推送的地址的方法：
登录公众平台进入【开发者中心设置】- 左侧边栏的基本配置中 - URL配置

# 配置刷脸会员

由于一旦配置，设备即会出现会员卡配置的信息，所以测试阶段请使用测试商户号来绑定测试会员卡进行测试，切勿使用已落地线下运营中的设备进行绑定测试。

3.1 登录商户平台

前往微信支付[商户平台，登录需要操作的商户或者服务商的商户号，登录后点击"营销中心"-"刷脸会员"或者打开新的标签链接：（灰度试点期间，找不到菜单可先使用链接） https://pay.weixin.qq.com/index.php/xphp/cfrog_member_card/manage#/pages/index/index

3.2 绑定会员卡信息

服务商模式： 若是服务商登录后进入"绑定会员卡"的页面，所属商户号需要输入该服务商账号下对应的某个子商户、子商户会员卡的Appid和Cardid。

商户模式： 若是商户自行登录操作，进入"绑定会员卡"的页面，所属商户号需要默认等于商户自己的商户号，需要填写商户自定想运营的会员卡的Appid和Cardid。

具体绑定会员卡流程如下：

注：字段说明
所属商户号：需要运营的会员卡所归属的商户号；服务商模式下只能添加自己的子商户
会员卡Appid： 绑定的是在公众号平台下的会员卡系统，需要填写该会员卡系统所在公众号的账号appid，appid必须和当前登录的商户号有绑定关系（查询Appid的方法：详见Q&A，appid和商户号的绑定流程：详见Q&A）
会员卡Cardid： Cardid是指商户运营的会员卡在公众平台上的唯一识别参数id（查询Cardid的方法：详见Q&A

3.3 绑定运营卡的设备商户号

设置完需要填写需要运营该张会员卡的设备商户号，输入完成之后即可生效，可在青蛙设备上查看具体效果。

此处设备商户号需要与当前登录的商户为同品牌关系。

3.4 设置刷脸会员模式

刷脸会员根据"商户是否会员码"分为两类：积分型刷脸会员、批价型刷脸会员

商户类型	刷脸后	刷脸即会员	刷脸识别会员及一键支付	刷脸会员互动	适合商户类型
积分型	不需要	Y	Y	Y	类型1：只做会员拉新，仍然使用传统的会员识别方法（如报手机号）
积分型	不需要	Y	Y	Y	类型2：不需要在支付前接收会员码，只在支付后做会员积分，可以在接收付款码后，使用付款码反查openid来做会员识别付款码反查openid接口
批价型刷脸会员	需要	Y	Y	Y	类型3：需要会员码的商户，需要搭配青蛙互动助手使用（青蛙互动助手接入详见Q&A）