# 青蛙刷臉會(huì)員接入文檔

# 一、青蛙刷臉會(huì)員介紹

青蛙App2.20版本起支持“刷臉會(huì)員”能力，用戶在青蛙刷臉后可以“開(kāi)通會(huì)員”、“使用會(huì)員身份支付”。

# 1. 青蛙刷臉會(huì)員流程

# 2. 青蛙刷臉會(huì)員能力介紹

刷臉會(huì)員擁有“刷臉即會(huì)員”、“刷臉識(shí)別會(huì)員及一鍵支付”、“刷臉會(huì)員互動(dòng)”三大能力。

1）刷臉即會(huì)員

1.1 支付前開(kāi)卡： 用戶可以在支付前開(kāi)卡，本單享受會(huì)員權(quán)益，相較于支付后開(kāi)卡，有助于提升用戶的開(kāi)卡意愿。

1.2 一鍵開(kāi)卡： 用戶可以免輸入一鍵注冊(cè)會(huì)員卡，支持姓名、手機(jī)號(hào)、生日、性別4個(gè)字段。
姓名 - （考慮到青蛙編輯不方便的情況）不支持修改，默認(rèn)讀取用戶在卡包填入的姓名信息，若未曾填入，則以微信昵稱代替；
手機(jī)號(hào) - （考慮到青蛙編輯不方便的情況）不支持修改，默認(rèn)讀取用戶在卡包填入的的手機(jī)號(hào)，若未曾填入，則填入用戶微信綁定的手機(jī)號(hào)；
生日 - 支持修改，默認(rèn)讀取用戶在卡包填入的生日，若未曾填入，則為空；
性別 - 支持修改，默認(rèn)讀取用戶在卡包填入的性別，若未曾填入，則為空。

1.3 開(kāi)卡有禮： 支持商戶配置開(kāi)卡有禮活動(dòng)，用戶在開(kāi)卡成功后可以領(lǐng)取開(kāi)卡有禮的優(yōu)惠券（詳細(xì)配置流程詳見(jiàn)第二章-3.5配置開(kāi)卡有禮）。

2）刷臉識(shí)別會(huì)員及一鍵支付

2.1 刷臉識(shí)別會(huì)員： 用戶刷臉后，青蛙App會(huì)識(shí)別用戶的卡包會(huì)員身份，并展示會(huì)員的權(quán)益以及會(huì)員的微信支付代金券。
會(huì)員權(quán)益 - 會(huì)員權(quán)益最多展示3個(gè)（如下圖），會(huì)員權(quán)益只展示微信卡包中有參數(shù)的會(huì)員權(quán)益，若會(huì)員權(quán)益為“查看（點(diǎn)擊后跳轉(zhuǎn)）”時(shí)，刷臉會(huì)員不展示。
微信支付代金券 - 會(huì)員權(quán)益頁(yè)會(huì)默認(rèn)展示用戶微信賬戶中的微信支付代金券，微信支付代金券按照最大優(yōu)惠原則自動(dòng)核銷，無(wú)需用戶主動(dòng)使用。
2.2 會(huì)員一鍵支付： 用戶刷臉識(shí)別會(huì)員身份后，在1分鐘內(nèi)可以一鍵支付；出于賬戶安全考慮，若超過(guò)1分鐘，用戶點(diǎn)擊確認(rèn)支付后需要再刷一次臉。

3）刷臉會(huì)員互動(dòng)

3.1 支付結(jié)果頁(yè)小程序運(yùn)營(yíng)位： 商戶可在刷臉支付結(jié)果頁(yè)配置"支付結(jié)果頁(yè)小程序"，將刷臉支付的流量沉淀至小程序中；若用戶點(diǎn)擊小程序，則在用戶手機(jī)端的使用記錄中會(huì)出現(xiàn)該小程序。

# 3. 青蛙刷臉會(huì)員價(jià)值

刷臉會(huì)員通過(guò)"刷臉即會(huì)員"、"刷臉識(shí)別會(huì)員及一鍵支付"、"刷臉會(huì)員互動(dòng)"三大能力，助力商戶提升會(huì)員拉新、會(huì)員識(shí)別&支付和會(huì)員經(jīng)營(yíng)的效能。

	傳統(tǒng)會(huì)員	刷臉會(huì)員
會(huì)員拉新效率 =會(huì)員注冊(cè)量/支付筆數(shù)	“刷臉即會(huì)員”功能將刷臉會(huì)員的拉新效率提升至傳統(tǒng)會(huì)員拉新方式的10倍
會(huì)員識(shí)別&支付效率	會(huì)員識(shí)別&支付的耗時(shí) 約5秒	1.突顯用戶會(huì)員權(quán)益 2.會(huì)員識(shí)別&支付的耗時(shí)縮短為2秒
會(huì)員經(jīng)營(yíng)效能	-	沉淀會(huì)員流量至公眾號(hào)、小程序等渠道

# 4. 商戶小程序調(diào)起刷臉會(huì)員組件

青蛙APP2.21版本起將支持商戶小程序調(diào)起刷臉會(huì)員組件。通過(guò)調(diào)起刷臉會(huì)員組件商戶可在小程序內(nèi)使用微信卡包的開(kāi)卡能力實(shí)現(xiàn)一鍵開(kāi)卡，同時(shí)有效降低商戶在會(huì)員場(chǎng)景的開(kāi)發(fā)成本。
1）刷臉即會(huì)員
若商戶僅需應(yīng)用微信卡包的開(kāi)卡能力，可調(diào)用刷臉會(huì)員開(kāi)卡組件接口，在小程序需要開(kāi)卡時(shí)直接調(diào)起會(huì)員開(kāi)卡頁(yè)面。

有登錄態(tài)時(shí)，直接調(diào)起
無(wú)登錄態(tài)時(shí)，需用戶刷臉后調(diào)起

2）刷臉識(shí)別會(huì)員
小程序可調(diào)用刷臉會(huì)員組件接口，無(wú)需傳入?yún)?shù)直接打開(kāi)刷臉會(huì)員組件；刷臉會(huì)員組件會(huì)通過(guò)青蛙APP查詢會(huì)員信息，向用戶展示相關(guān)會(huì)員權(quán)益頁(yè)面。

# 二、青蛙刷臉會(huì)員接入流程

為方便商戶接入，青蛙刷臉會(huì)員是基于微信卡包系統(tǒng)研發(fā)的會(huì)員工具，開(kāi)發(fā)成本極低（部分商戶可免開(kāi)發(fā)），接入流程分為三步：
步驟一：接入微信卡包 （已接入微信卡包的商戶可跳過(guò)） 步驟二：適配刷臉會(huì)員場(chǎng)景 （普通一鍵激活的商戶可跳過(guò)） 步驟三：配置刷臉會(huì)員

# 1. 接入微信卡包

微信卡包：接入文檔
若是新接入的商家，如若無(wú)特殊需求，建議使用"普通一鍵激活"的激活方式
刷臉會(huì)員暫不支持"自動(dòng)激活"的激活方式

# 2. 適配刷臉會(huì)員場(chǎng)景

若商戶會(huì)員卡的激活方式為：普通一鍵激活，則無(wú)需適配刷臉會(huì)員場(chǎng)景
若商戶會(huì)員卡的激活方式為：跳轉(zhuǎn)型一鍵激活或者接口激活，則需要適配刷臉會(huì)員場(chǎng)景

2.1 激活方式的判斷方法

普通一鍵激活： 使用微信官方的開(kāi)卡頁(yè)，且填寫(xiě)完資料點(diǎn)擊激活后直接激活成功，無(wú)任何頁(yè)面跳轉(zhuǎn)
跳轉(zhuǎn)型一鍵激活： 使用微信官方的開(kāi)卡頁(yè)，且填寫(xiě)完資料點(diǎn)擊激活后會(huì)跳轉(zhuǎn)商戶頁(yè)面
接口激活： 使用商戶的開(kāi)卡頁(yè)
自動(dòng)激活（暫不支持）： 無(wú)激活頁(yè)面，且base_info中增加"auto_activate": true

2.2 跳轉(zhuǎn)型一鍵激活和接口激活的適配方法

商戶手機(jī)端的開(kāi)卡流程不變，同時(shí)兼容刷臉側(cè)的開(kāi)卡分支流程。
商戶只需要兼容用戶信息的接收方式，即接收用戶激活后通過(guò)事件推送的用戶注冊(cè)信息，并在接收到事件推送后，繼續(xù)進(jìn)行商戶會(huì)員系統(tǒng)的其他注冊(cè)流程，最終調(diào)用激活接口來(lái)激活會(huì)員卡。

接收事件推送的詳細(xì)流程：
點(diǎn)開(kāi)鏈接 - 6.2一鍵激活 - 6.2.1普通一鍵激活 - 步驟三接收會(huì)員信息事件通知

配置事件推送的地址的方法：
登錄公眾平臺(tái)進(jìn)入【開(kāi)發(fā)者中心設(shè)置】- 左側(cè)邊欄的基本配置中 - URL配置

# 配置刷臉會(huì)員

由于一旦配置，設(shè)備即會(huì)出現(xiàn)會(huì)員卡配置的信息，所以測(cè)試階段請(qǐng)使用測(cè)試商戶號(hào)來(lái)綁定測(cè)試會(huì)員卡進(jìn)行測(cè)試，切勿使用已落地線下運(yùn)營(yíng)中的設(shè)備進(jìn)行綁定測(cè)試。

3.1 登錄商戶平臺(tái)

前往微信支付[商戶平臺(tái)，登錄需要操作的商戶或者服務(wù)商的商戶號(hào)，登錄后點(diǎn)擊"營(yíng)銷中心"-"刷臉會(huì)員"或者打開(kāi)新的標(biāo)簽鏈接：（灰度試點(diǎn)期間，找不到菜單可先使用鏈接） http://www.tg885.com/index.php/xphp/cfrog_member_card/manage#/pages/index/index

3.2 綁定會(huì)員卡信息

服務(wù)商模式： 若是服務(wù)商登錄后進(jìn)入"綁定會(huì)員卡"的頁(yè)面，所屬商戶號(hào)需要輸入該服務(wù)商賬號(hào)下對(duì)應(yīng)的某個(gè)子商戶、子商戶會(huì)員卡的Appid和Cardid。

商戶模式： 若是商戶自行登錄操作，進(jìn)入"綁定會(huì)員卡"的頁(yè)面，所屬商戶號(hào)需要默認(rèn)等于商戶自己的商戶號(hào)，需要填寫(xiě)商戶自定想運(yùn)營(yíng)的會(huì)員卡的Appid和Cardid。

具體綁定會(huì)員卡流程如下：

注：字段說(shuō)明
所屬商戶號(hào)：需要運(yùn)營(yíng)的會(huì)員卡所歸屬的商戶號(hào)；服務(wù)商模式下只能添加自己的子商戶
會(huì)員卡Appid： 綁定的是在公眾號(hào)平臺(tái)下的會(huì)員卡系統(tǒng)，需要填寫(xiě)該會(huì)員卡系統(tǒng)所在公眾號(hào)的賬號(hào)appid，appid必須和當(dāng)前登錄的商戶號(hào)有綁定關(guān)系（查詢Appid的方法：詳見(jiàn)Q&A，appid和商戶號(hào)的綁定流程：詳見(jiàn)Q&A）
會(huì)員卡Cardid： Cardid是指商戶運(yùn)營(yíng)的會(huì)員卡在公眾平臺(tái)上的唯一識(shí)別參數(shù)id（查詢Cardid的方法：詳見(jiàn)Q&A

3.3 綁定運(yùn)營(yíng)卡的設(shè)備商戶號(hào)

設(shè)置完需要填寫(xiě)需要運(yùn)營(yíng)該張會(huì)員卡的設(shè)備商戶號(hào)，輸入完成之后即可生效，可在青蛙設(shè)備上查看具體效果。

此處設(shè)備商戶號(hào)需要與當(dāng)前登錄的商戶為同品牌關(guān)系。

3.4 設(shè)置刷臉會(huì)員模式

刷臉會(huì)員根據(jù)"商戶是否會(huì)員碼"分為兩類：積分型刷臉會(huì)員、批價(jià)型刷臉會(huì)員

商戶類型	刷臉后	刷臉即會(huì)員	刷臉識(shí)別會(huì)員及一鍵支付	刷臉會(huì)員互動(dòng)	適合商戶類型
積分型	不需要	Y	Y	Y	類型1：只做會(huì)員拉新，仍然使用傳統(tǒng)的會(huì)員識(shí)別方法（如報(bào)手機(jī)號(hào)）
積分型	不需要	Y	Y	Y	類型2：不需要在支付前接收會(huì)員碼，只在支付后做會(huì)員積分，可以在接收付款碼后，使用付款碼反查openid來(lái)做會(huì)員識(shí)別付款碼反查openid接口
批價(jià)型刷臉會(huì)員	需要	Y	Y	Y	類型3：需要會(huì)員碼的商戶，需要搭配青蛙互動(dòng)助手使用（青蛙互動(dòng)助手接入詳見(jiàn)Q&A）