智慧门店
一、方案
1.1 扫脸机具交互链路
蜻蜓官方页面：二、三
运营商页面：一、四（支付完成页）、六（权益提醒/展示）
云码官方页面：五（CPA页，当前仅支持竖屏）
1.2 交互流程
1.支付完成页（第四个页面）
在进入 支付完成页时，运营商调用判断用户是否命中投放任务API（tmall.stella.cc.task.charge.launch），如果命中了投放任务，则显示云码权益的banner位。
必传参数：channel_id、device_sn、ftoken
API文档：https://open.taobao.com/api.htm?docId=44318&docType=2&scopeId=15276
2.支付完成页（第四页） -> CPA页（第五页）
直接跳转tmall.stella.cc.task.charge.launch接口返回的url即可进入CPA页面
3.CPA页（第五页）->权益提醒/展示页（第六页）
1）如果消费者点击了CPA页面的“关注”按钮，那么平台会通过奇门接口（qimen.taobao.cloudcode.alifacepay.business.notify）通知运营商
2）运营商收到通知消息后，给消费者派一个0.5元红包（可以使用运营商自己的红包体系，也可以使用支付宝开放平台的“无资金商户优惠券”产品）
支付宝无资金商户优惠券产品接入：https://docs.open.alipay.com/20170515180730063964/xbbfsd/
4.降低平行越权概率
平行越权场景：消费者A扫脸支付进入CPA页后未关注然后离开，消费者B直接替A完成关注动作。
以上场景无法绝对避免，建议运营商在CPA页左上角增加一个返回按钮，并显示倒计时信息，比如15秒后自动返回首页。
二、基础数据
2.1 运营商入驻
如果已经接入过云码，可以直接使用原appkey，忽略这一步。
https://open.taobao.com/doc.htm?docId=112264&docType=1
2.2 云码平台注册设备
如果扫脸设备本身就集成在一个扫码设备上（比如售货机），如果扫码设备已注册进云码平台，共用同一个deviceSn即可，可忽略这一步。
1）设备注册
需要将现有的设备信息注册到天猫云码平台
API名称：tmall.stella.cc.device.register( 码上抢设备注册接口 )
API文档：https://open.taobao.com/api.htm?docId=46684&docType=2
参数说明：
device_sn：设备外部编码，运营商自己的设备编码
device_type：设备类型，枚举值见附录 https://open.taobao.com/doc.htm?docId=118309&docType=1
primary_scene：设备点位所属的一级场景，枚举值见附录 https://open.taobao.com/doc.htm?docId=118309&docType=1
secondary_scene：设备点位所属的二级场景，枚举值见附录 https://open.taobao.com/doc.htm?docId=118309&docType=1
address：设备点位所在的详细地址（需包含省市区街道门牌号，确保高德地图可识别）
2）设备查询API（可选实现）
API名称：tmall.stella.cc.device.status.query( 查询设备状态 )
API文档：https://open.taobao.com/api.htm?docId=46017&docType=2
三、接口说明
3.1 判断用户是否被命中
先判断是否命中，若命中，才进入cpa页面
不需要传Alipay Uid，只需传ftoken即可，平台会根据token查AlipayUid。
API名称：tmall.stella.cc.task.charge.launch
API文档：https://open.taobao.com/api.htm?docId=44318&docType=2
device_sn：必传。运营商设备编码（见2.2步骤）
channel_id：必传。传入运营商的渠道ID（在这里就是appkey，见2.1步骤）
ftoken：必传。
alipay_open_id：可选
url_id：可选，urlID
extra：可选，服务商附加url参数
2.2 CPA页面链接
请直接使用tmall.stella.cc.task.charge.launch返回的URL
2.3 通知运营商消费者行为
天猫云码将消费者的行为动作同步给运营商，两种情况下会发送通知：
1）当运营商调用判断用户是否命中接口是，平台会发送一次消息，phase参数值为“scan”
2）当消费者点击了CPA页面的“关注”按钮时，平台发送一次消息phase参数值为“action”
SPI名称：qimen.taobao.cloudcode.alifacepay.business.notify( 扫脸接口业务通知 )
SPI文档：https://open.taobao.com/api.htm?docId=46445&docType=2
SPI场景名称：码上抢刷脸支付开放
version：请求唯一标识
holderId：用户openId，用户在淘宝的唯一标识
deviceCode：平台设备编码
phase：消费者行为枚举。scan("scan", "进入云码"), action("action", "授权入会/关注")
promotionPrice：平台权益金额
outerCode：对应1.2中传入的deviceSn
ftoken：云码扫脸付token
queryStr：云码url参数透传，eg：channelId=${channelId}&deviceSn=${deviceSn}&ftoken=${ftoken}
注意：这是是奇门SPI接口，由运营商实现，天猫仅提供接口定义以及负责调用。
奇门SPI接入文档：https://open.taobao.com/doc.htm?docId=116667&docType=1
2.4 权益发放
只有消费者点击了CPA页的“关注/入会”按钮后，运营商才发放权益。
可以使用运营商自己的红包体系，也可以用支付宝的能力。
推荐使用支付宝开放平台的“无资金商户优惠券”产品：https://docs.open.alipay.com/20170515180730063964/xbbfsd/