环境图_(5)备份.png

1.场景说明

为更好的满足商户个性化业务场景需求，帮助商家打造贴合酒店行业场景的IoT智能终端，支付宝正式推出蜻蜓小程序开放能力，为全行业生态合作伙伴赋能，为全行业商户深入细化解决方案。同时欢迎生态伙伴一起联合深耕行业，助力商户数字化智能化蓬勃发展。

2.行业痛点

  • 人工办理入住和收银等待时间长，用户入住体验差，降低对酒店的复住率
  • 笨重的自助入住设备，价格昂贵，增加酒店经营成本
  • 承接高客流的时候，需要更多的人工成本，闲时多余的人力又会浪费

    3.核心能力展示

    编组 3.png

4.方案价值

  • 改变传统的人工收银排队等待时间长问题，利用蜻蜓轻量化硬件设备打造扫脸核身、查询订单、扫脸/扫码支付、扫脸/扫码预授权、办理入住、制作房卡的整体解决方案。
  • 降低酒店人工成本同时提升了用户体验。相比酒店自助入住机具有相同的能力，大大降低采购设备的硬件成本 ，使自助入住服务可以在酒店中得到快速覆盖。

5.产品方案编组 4.jpg

6.设计方案

软件方案

方案一：只接入人证核身部分的竖版方案：酒店-人证核身UI.sketch
竖版.png

方案二：只接入人证核身部分的横版方案：酒店-人证核身UI.sketch
横版.jpg

方案三：人证核身+酒店入住部分
A_cjLoQrJPDvsAAAAAAAAAAABkARQnAQ.png

7.研发接入流程

详细接口开发文档：https://alipay.open.taobao.com/docs/doc.htm?articleId=118355&docType=1

7.1刷脸人证比对—核身产品

如果商户需要实现刷脸人证比对能力，请严格按照以下内容调用扫脸核身组件。目前蜻蜓可外接适配华视电子CVR-100N读卡器，详见：https://opendocs.alipay.com/mini/multi-platform/xiisgz
my.ix.faceVerify({ … });

入参

参数 类型 是否必填 含义
option String 是 传入life
certNo String 是 刷脸支持传入身份证号
certName String 是 刷脸支持传入身份证姓名
verifyType String 是 识别类型，目前仅支持idcard

出参

参数 类型 含义
success bool 是否成功
barCode String 成功返回，支付用
buyerId String 买家支付宝user_id，刷脸成功有返回, 扫付款码不返回
deviceSn String 机具sn
error String 失败错误码[仅错误时返回]
errorMessage String 失败错误信息[仅错误时返回]
ftoken String 目前无效, 请勿使用ftoken进行支付

返回码

名称 描述
102 参数错误

示例代码：

1
2
3
4
5
6
7
8
9
10
11
12
13
14		 my.ix.faceVerify({
``certNo: ``'XXX'``,
``certName: ``'XXX'``,
``verifyType: ``'idCard'``,
``option: ``'life'``,

``success: (r) => {
``console.log(``'faceVerify success'``, r);
``},
``fail: (r) => {
``my.showToast({ content: JSON.stringify(r) });
``console.log(``'faceVerify fail'``, r);
``}
``});

7.2扫脸预授权—收单产品

对于部分酒店商户，普通的当面付收款无法满足其需求，需要使用预授权冻结押金-离店扣除房费的支付产品，支付宝推出了资金预授权。在蜻蜓设备上，用户可以通过刷脸完成资金预授权过程（刷脸预授权功能依赖蜻蜓app2.9.5及以上版本，低于此版本可提供蜻蜓设备sn，支付宝技术支持协助完成升级）。
2.2.1 my.ix.faceVerify({ … });

入参

参数 类型 是否必填 含义
option String 是 传入pay
certNo String 是 刷脸支持传入身份证号
certName String 是 刷脸支持传入身份证姓名
verifyType String 是 识别类型，目前仅支持idcard
needPreAuth String 是 传入true

回参

参数 类型 含义
success bool 是否成功
barCode String 成功返回，支付用
buyerId String 买家支付宝user_id，刷脸成功有返回, 扫付款码不返回
deviceSn String 机具sn
error String 失败错误码[仅错误时返回]
errorMessage String 失败错误信息[仅错误时返回]
ftoken String 目前无效, 请勿使用ftoken进行支付

返回码

名称 描述
102 参数错误

示例代码

1
2
3
4
5
6
7
8
9
10
11		 my.ix.faceVerify({
``option: ``'pay'``,
``needPreAuth: ``'true'``,
``success: (r) => {
``console.log(``'faceVerify success'``, r);
``},
``fail: (r) => {
``my.showToast({ content: JSON.stringify(r) });
``console.log(``'faceVerify fail'``, r);
``}
});

服务端开发

将小程序客户端刷脸授权返回参数中的ftoken作为授权冻结接口的入参，冻结接口和转支付接口调用详见： 当面资金授权技术文档。
其中刷脸授权调用务必满足：
（1）其中alipay.fund.auth.order.freeze(资金授权冻结接口)接口的请求参数中auth_code参数值设置为扫脸sdk返回的FToken的值。
（2）alipay.fund.auth.order.freeze(资金授权冻结接口)接口的请求参数中auth_code_type=security_code，scene_code=HOTEL 。（接口入参说明中无scene_code 参数，可以直接传入）
（3）冻结后的转支付调用接口alipay.trade.pay，其他相关查询、退款等接口调用同当面付。

接口验收

详见IOT刷脸预授权验收文档。

8.案例介绍

—

9.审核机制

验收流程.jpg