淘宝云码-扫脸支付场景接口说明

小提示：您能找到这篇{淘宝云码-扫脸支付场景接口说明}绝对不是偶然，我们能帮您找到潜在客户，解决您的困扰。如果您对本页介绍的淘宝云码-扫脸支付场景接口说明内容感兴趣，有相关需求意向欢迎拨打我们的服务热线，或留言咨询，我们将第一时间联系您！

一、方案

1.1 扫脸机具交互链路

蜻蜓官方页面：二、三

运营商页面：一、四（支付完成页）、六（权益提醒/展示）

云码官方页面：五（CPA页，当前仅引流平台怎么做支持竖屏）

1.2 交互流程

1.支付完成页（第四个页面）

在进入 支付完成页时，运营商调用判断用户是否命中投放任务API（tmall.stella.cc.task.charge.launch），如果命中了投放任务，则显示云码权益的banner位。

必传参数：channel_id、device_sn、ftoken

2.支付完成页（第四页） -> CPA页（第五页）

直接跳转tmall.stella.cc.task.charge.launch接口返回的url即可进入CPA页面

3.CPA页（第五页）->权益提醒/展示页（第六页）

1）如果消费者点击了CPA页面的“关注”按钮，那么平台会通过奇门接口（qimen.taobao.cloudcode.alifacepay.business.notif上央视一套广告1周收费报y）通知运营商

2）运营商收到通知消息后，给消费者派一个0.5元红包（可以使用运营商自己的红包体系，也可以使用支付宝开放平台的“无资金商户优惠券”产品）

支付宝无资金商户优惠券产品接入：https://docs.open.alipay.com/201705151舆情监控什么意思怎么做80730063964/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( 查询设备状态 )

三、接口说明

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/