微信支付門(mén)店智能硬件支持運(yùn)行小程序。目前我們已對(duì)「微信青蛙」系列設(shè)備提供了較豐富的能力支持，其他軟硬件請(qǐng)耐心等待。如有建議，歡迎反饋。

最近更新

青蛙 App 2.12 版本 [2019.11.28]

新增

• 開(kāi)機(jī)自啟、首屏常駐運(yùn)行小程序
• 小程序內(nèi)接收刷臉付款碼
• 小程序監(jiān)聽(tīng)鍵盤(pán)輸入、掃碼器輸入
• 前屏小程序運(yùn)行中請(qǐng)求登錄
• 背屏小程序掃碼登錄
• 商戶平臺(tái)自助配置小程序（商戶號(hào)維度批量下發(fā)，后續(xù)支持設(shè)備SN維度）

# 1. 關(guān)鍵概念

# 1.1 門(mén)店智能硬件上的小程序

小程序可以運(yùn)行在不同終端上。在門(mén)店智能硬件或手機(jī)微信 App 上運(yùn)行的小程序，本質(zhì)相同，有著相同的技術(shù)原理、帳號(hào)體系。開(kāi)發(fā)者可以直接將現(xiàn)有小程序配置到門(mén)店智能硬件中，也可以根據(jù)門(mén)店智能硬件的特性作差異化的設(shè)計(jì)。

在不同運(yùn)行環(huán)境，確有部分能力差異，但更重要是應(yīng)用場(chǎng)景的差異。例如：

• 從個(gè)人手機(jī)場(chǎng)景，到門(mén)店智能硬件的場(chǎng)景
• 從僅由用戶操作，到成為商家的經(jīng)營(yíng)工具，由店員與顧客實(shí)時(shí)互動(dòng)
• 從只能通過(guò)二維碼作單次信息交換，到可以登錄微信身份，從而連接起物理世界與數(shù)字世界

硬件運(yùn)行小程序，容易獲得以下特性：

• 連接微信

  微信身份（ 用戶帳號(hào)體系 / 用戶信息授權(quán) / 連接關(guān)系鏈）
  微信能力（ 訂閱服務(wù)通知 / 連接公眾號(hào) / 連接卡券 ）

• 多端融合

  跨終端 - 跨場(chǎng)景 - 線上線下：服務(wù)融合 流量互通

• 開(kāi)發(fā)運(yùn)營(yíng)成本

  開(kāi)發(fā)簡(jiǎn)單 / 敏捷更新 / 存量應(yīng)用遷移 / 用戶認(rèn)知成熟 / 易于傳播

以上可能帶來(lái)創(chuàng)新機(jī)會(huì)。如何連接微信，構(gòu)建多端融合的服務(wù)場(chǎng)景，值得思考探索。

# 1.2 軟硬件適用范圍

# 軟件

青蛙 App（僅支持 Android 系統(tǒng)）

# 硬件

單屏：青蛙 及 開(kāi)放平臺(tái)設(shè)備
雙屏：僅支持青蛙 Pro，暫不支持開(kāi)放平臺(tái)雙屏設(shè)備

# 建議配置

四核2GHz CPU
內(nèi)存2GB RAM+8GB ROM
安卓7.1及以上

# 1.3 軟件架構(gòu)

青蛙 App 與 小程序 的關(guān)系如下：

# 2. 關(guān)鍵能力說(shuō)明

# 2.1 小程序調(diào)起方式

# 2.2 登錄能力

手機(jī)微信 App，提供了一個(gè)持續(xù)保持用戶微信登錄態(tài)的小程序運(yùn)行環(huán)境（所有用戶都會(huì)先登錄微信帳號(hào)才能進(jìn)入和使用微信）。因此在手機(jī)微信 App 中，小程序可以輕松調(diào)用 wx.login、wx.getUserInfo 等 API 請(qǐng)求到當(dāng)前登錄用戶的 OpenID、手機(jī)號(hào)授權(quán)等。

與此不同的是，門(mén)店智能硬件上的青蛙 App在缺省狀態(tài)是以「無(wú)登錄態(tài)」運(yùn)行的，僅在有需要時(shí)才會(huì)請(qǐng)求用戶「臨時(shí)登錄」。用戶可通過(guò)「刷臉」或「手機(jī)掃碼」，讓青蛙 App 短暫獲得登錄態(tài)。

登錄過(guò)程開(kāi)發(fā)者無(wú)需理解或維護(hù)，登錄態(tài)由青蛙 App 管理。登錄后，小程序即可如常調(diào)用依賴用戶身份的 API 。

青蛙 App 請(qǐng)求用戶登錄的時(shí)機(jī)：

1. 打開(kāi)小程序之前，先請(qǐng)求用戶登錄（將小程序配置至設(shè)備時(shí)可設(shè)置）
2. 小程序運(yùn)行過(guò)程中，請(qǐng)求用戶登錄（由小程序調(diào)用 API 實(shí)現(xiàn)）

青蛙 App 清空登錄態(tài)的時(shí)機(jī)：

1. 登錄態(tài)超時(shí)后，自動(dòng)清空登錄態(tài)并關(guān)閉小程序（彈窗詢問(wèn)）

2. 小程序可調(diào)用 API 請(qǐng)求清空登錄態(tài)并自我關(guān)閉

特殊

雙屏的青蛙 Pro 設(shè)備，青蛙 App 可為前后屏環(huán)境獲取 2 個(gè)獨(dú)立的登錄態(tài)，登錄方式有別：

1. 前屏（帶有刷臉攝像頭的一面）：僅支持刷臉登錄；登錄態(tài)有效期較短

2. 背屏：僅支持在背屏桌面點(diǎn)擊「登錄」圖標(biāo)，由手機(jī)掃碼登錄；登錄態(tài)有效期較長(zhǎng)

# 2.4 支付能力

青蛙設(shè)備支持通過(guò)「刷臉」或「被掃」的方式獲取用戶付款碼，藉由商戶后臺(tái)經(jīng)「付款碼支付」通道下單支付。上述支付途徑，同樣可被運(yùn)行在青蛙中的小程序調(diào)用。

小程序可調(diào)用 API 通知青蛙發(fā)起刷臉支付（僅支持前屏小程序），類型如下：

1. 刷臉支付：付款碼去向可選（回傳至小程序，或經(jīng) USB-HID 外傳給收銀機(jī)）
2. 免刷臉快速支付：用戶刷臉登錄小程序后，在短暫時(shí)間內(nèi)，小程序可免刷臉獲取付款碼，付款碼去向可選（回傳至小程序，或經(jīng) USB-HID 外傳給收銀機(jī)）

小程序亦可調(diào)用 API 監(jiān)聽(tīng)青蛙的掃碼器輸入，掃碼類型不限。

至于小程序原有的「小程序支付」，將彈出二維碼組件，轉(zhuǎn)由手機(jī)掃碼完成支付。

針對(duì)使用小程序接收付款碼，實(shí)現(xiàn)「獨(dú)立收銀」的特別說(shuō)明：

• 業(yè)務(wù)流程：

  1. 青蛙上運(yùn)行小程序
  2. 小程序調(diào)起青蛙的刷臉支付
  3. 用戶刷臉、確認(rèn)支付后，青蛙把付款碼傳給小程序
  4. 小程序拿到付款碼后，傳給商家后臺(tái)
  5. 商家后臺(tái)按常規(guī)的「付款碼支付」流程下單支付

• 刷臉支付返回的付款碼，對(duì)收款商戶號(hào)有限制，只可由青蛙設(shè)備所綁定的商戶號(hào)收款（青蛙 App 的設(shè)置頁(yè)面可檢查綁定狀態(tài)）

# 2.4 外部通訊能力

當(dāng)青蛙連接外部設(shè)備（如收銀機(jī)）使用的時(shí)候，可對(duì)外部設(shè)備作單向或雙向通訊。上述通訊能力，運(yùn)行在青蛙中的小程序均可調(diào)用或響應(yīng)。

1. 傳出：調(diào)用 API 通過(guò) USB-HID 以模擬鍵盤(pán)輸入的方式，對(duì)外部設(shè)備傳輸自定義數(shù)據(jù)信息，如付款碼、會(huì)員識(shí)別碼、手機(jī)號(hào)等（外部設(shè)備無(wú)需開(kāi)發(fā)）
2. 傳入：外部設(shè)備可對(duì)青蛙發(fā)起「啟動(dòng)小程序」指令，也可以經(jīng)由青蛙透?jìng)髯远x信息至正在運(yùn)行的小程序（外部設(shè)備需提前接入指令 SDK ）

# 2.5 雙屏聯(lián)動(dòng)能力

這是青蛙 Pro 的獨(dú)有能力。

1. 前后雙屏，支持同時(shí)運(yùn)行小程序（相同或不同 AppID 均可，可指定要打開(kāi)的頁(yè)面）
2. 運(yùn)行于前屏的小程序，可在任意時(shí)機(jī)在背屏聯(lián)動(dòng)打開(kāi)特定小程序的特定頁(yè)面
3. 運(yùn)行于前后屏的 2 個(gè)小程序之間，可實(shí)時(shí)前后通訊，通訊內(nèi)容由開(kāi)發(fā)者自由約定

全部硬件擴(kuò)展能力，詳見(jiàn)附錄《硬件運(yùn)行小程序的擴(kuò)展 API 接口文檔》。

# 3. 開(kāi)發(fā)、調(diào)試、下發(fā)

# 3.1 基礎(chǔ)屬性

屏幕分辨率

微信青蛙基礎(chǔ)版、微信青蛙Pro（前屏、背屏）
800 × 1280 px

場(chǎng)景值

當(dāng)小程序在手機(jī)微信 App 以外的環(huán)境運(yùn)行，場(chǎng)景值 ID=1133
參考：https://developers.weixin.qq.com/miniprogram/dev/reference/scene-list.html

# 3.2 小程序的準(zhǔn)備

1. 準(zhǔn)備 企業(yè)主體的小程序（獲取小程序 AppID）
2. 開(kāi)發(fā) 使用微信開(kāi)發(fā)者工具，開(kāi)發(fā)小程序
3. 調(diào)試 現(xiàn)階段小程序在硬件上的調(diào)試存在一定限制

• 由于開(kāi)發(fā)者工具暫無(wú)法模擬運(yùn)行、調(diào)試本文檔介紹的「硬件擴(kuò)展 API」，請(qǐng)完成代碼編寫(xiě)后，上傳生成「體驗(yàn)版」小程序，將其配置到硬件上作真機(jī)調(diào)試
• 由于「體驗(yàn)版」小程序需要校驗(yàn)使用者權(quán)限，因此僅支持以「先請(qǐng)求登錄后打開(kāi)小程序」的方式運(yùn)行
• 暫不支持「開(kāi)發(fā)版」

4. 發(fā)布
1）提交審核，發(fā)布「正式版」小程序

• 小程序?qū)徍薚ips
  在小程序提交正式版審核時(shí)，可參考以下建議，幫助小程序過(guò)審：

在備注中清晰說(shuō)明：此小程序的哪個(gè)功能需要配合刷臉設(shè)備使用，無(wú)法在移動(dòng)端體驗(yàn)
上傳小程序在設(shè)備內(nèi)使用流程的視頻

2）將「正式版」配置到硬件

# 3.3 青蛙設(shè)備準(zhǔn)備

# 3.3.1 激活青蛙設(shè)備

青蛙設(shè)備啟用前，需完成設(shè)備序列號(hào) SN 與收款商戶號(hào) MchID 的綁定。
現(xiàn)支持方式：

1. 連接收銀機(jī)激活，完成一筆微信付款碼支付

# 3.3.2 將小程序配置下發(fā)到青蛙設(shè)備

1）準(zhǔn)備微信開(kāi)放平臺(tái)的移動(dòng)應(yīng)用AppID

• 移動(dòng)應(yīng)用 AppID 用于標(biāo)記運(yùn)行小程序的硬件所屬的主體信息，以獲得運(yùn)行和登錄小程序的權(quán)限
  • 已注冊(cè)移動(dòng)應(yīng)用AppID的服務(wù)商或商戶，需完成商戶號(hào)(MCHID)與移動(dòng)應(yīng)用AppID的綁定(簡(jiǎn)稱MA綁定）
  • [限制] 移動(dòng)應(yīng)用AppID主體必須與用于配置下發(fā)小程序的商戶號(hào)主體一致
• 如果移動(dòng)應(yīng)用AppID為服務(wù)商所有，請(qǐng)通過(guò)郵件方式進(jìn)行MA綁定申請(qǐng)，郵件模版如下：

收件人：facepay_help@tencent.com
郵件標(biāo)題：[服務(wù)商MA綁定申請(qǐng)]+商戶名稱
正文需包含以下內(nèi)容：
移動(dòng)應(yīng)用AppID（最多三個(gè)）
服務(wù)商號(hào)
是否認(rèn)證
移動(dòng)應(yīng)用AppID主體名稱（認(rèn)證的企業(yè)名稱）
商戶主體名稱
是否開(kāi)通微信支付

2）登錄微信支付商戶平臺(tái)

3）前往小程序配置下發(fā)頁(yè)面

4）配置操作說(shuō)明

• 直連商戶、特約商戶、普通服務(wù)商、渠道商，均可登錄配置
• 服務(wù)商（普通服務(wù)商或渠道商）需要把設(shè)備綁定到設(shè)備列表，才能獲得配置權(quán)限
• 商戶（直連商戶或特約商戶）需確認(rèn)設(shè)備未被服務(wù)商綁定，才能獲得配置權(quán)限
• 小程序可以提前預(yù)裝到設(shè)備
• 可按多種維度下發(fā)小程序至設(shè)備：按設(shè)備類型/設(shè)備型號(hào)/商戶號(hào)（最多500個(gè)）/設(shè)備號(hào)（最多500個(gè)）

5）硬件上的小程序代碼將保持最新，但「體驗(yàn)版」「正式版」版本不會(huì)變
6）備用流程：人工申請(qǐng)下發(fā)小程序到硬件

• 注意：通過(guò)人工申請(qǐng)配置將覆蓋自助配置，如發(fā)現(xiàn)自助配置無(wú)效，請(qǐng)檢查是否曾經(jīng)提交過(guò)人工配置

# 附錄

# 相關(guān)文檔鏈接

• 硬件小程序的擴(kuò)展 JSAPI 接口文檔
• 疑問(wèn)或建議反饋
• 常見(jiàn)問(wèn)題（滾動(dòng)更新）

# 硬件運(yùn)行小程序的應(yīng)用場(chǎng)景舉例

• 使用小程序?qū)崿F(xiàn)獨(dú)立收銀
• 小程序授權(quán)手機(jī)號(hào)，開(kāi)通會(huì)員
• 半自助 POS 機(jī)
• 自助收銀 / 點(diǎn)餐
• 排隊(duì)取號(hào) / 核驗(yàn)
• 整體場(chǎng)景方案
  • 商場(chǎng)導(dǎo)覽屏，品牌服務(wù)：餐飲自助點(diǎn)餐取號(hào) / 品牌營(yíng)銷導(dǎo)流
  • 線上沉淀
• 整體工具方案
  • 線上：小程序商城、關(guān)系鏈?zhǔn)跈?quán)
  • 前屏：刷臉會(huì)員、自助收銀、券核銷
  • 背屏：連接 CRM 展示會(huì)員信息、接待建議、ERP、收銀系統(tǒng)