智慧门店
云码-FAQ
一、概念
1.云码商业模式
天猫云码团队（后续简称“平台方”）：
1）提供产品侧能力，实现精准投放、品效合一的营销模式、担保结算
2）依托阿里经济体，整合丰富的品牌资源
3）依托阿里的服务商生态体系，整合线下智能设备，形成规模化的线下流量入口
品牌方：付费完成营销活动。根据品牌调性，基于LBS以及人群标签选择合适的投放规则。
运营商：提供线下流量。平台根据实际的营销效果结算。运营商需要提前上翻点位信息；并且接入云码产品的CPA/CPS营销内容，完成智能设备交互链路的改造。
2.营销模式-CPA
Cost Per Action，按实际行动付费。在这里品牌是按照“关注店铺”这个动作付费。
CPA营销页示例（请用手淘 or 支付宝app扫码）：
3.营销模式-CPS页
Cost Per Sale，按销售提成付费。消费者从运营商的渠道进入CPS营销页，基于CPS页的商品完成成交，运营商即可获得分佣。
CPS营销页示例：
二、奇门接口类
1.qimen.tmall.cloudcode.business.notify 是否必须实现？
必须实现。
作用：qimen.tmall.cloudcode.business.notify的作用是将消费者在CPA页面上的行为数据通知给运营商。
触发动作：消费者打开CPA页面 、 消费者在CPA页面点击关注/入会按钮。
2.奇门SPI接口检测报错 “抱歉，您当前未通过测试地址可用性检测”
发现模拟测试时，并没有按配置的测试地址发起请求。症状如下：
解决方法：重置模拟数据即可。点击“修改模拟数据”->点击“重置”按钮 ->点击“保存”按钮。
3.扫码是显示“优惠已领光”？或者“哎呀，系统开小差了~~
答：1，是因为没被品牌的投放计划覆盖到,2.是因为你们没实现 这个spi接口“qimen.tmall.cloudcode.business.notify”。
4.qimen.tmall.cloudcode.business.notify 这个接口的作用？
答：消费者发生了扫码动作，把这个动作行为数据传给服务商。必须实现。
5.qimen.tmall.cloudcode.alipaytrade.create 这个接口的价格promotionPrice为什么不是必传
答：promotionPrice 是平台的权益金额，并不是消费者实际的支付金额。 消费者的支付金额是 你们通过这个spi接口的返回参数传给平台的，参数：aliPayPrice
6.奇门接口云码业务状态通知里面的holderid指的是什么？
答：是用户在开放平台的ID。
7.在实现奇门接口时测试地址怎么填写？为什么要配置在这里？
答：这是spi接口需要运营商来发布的，需要填运营商发布接口的地址，配置完成后以便于天猫云码来调用。
三、支付类问题（包括订单问题）
1.平台的权益金额是根据我们传的订单金额去判断还是有阿里来设定的？
答：权益金额的值是固定的，是@景豪跟运营商的商务敲定的。至于消费者是否权益金额是根据我们这边的投放任务判断的。
2.是否支持零元付？
答：如果该消费者没有获取到权益金额，我们会传给你们的值是 0元。如果你们商品的实际售价小于权益金额值，这里需要你们做下逻辑判断。最后建议全走 0.01元支付。
3.服务商在下单的时候需要进行价格计算吗？
答：是的：阿里这边只通知你们一个权益金额。消费者的实际支付金额由你们计算商品价格（服务商） - 权益金额（平台通知） = 实际支付金额（服务商）。
3.支付前广告，是百分百命中吗？还是只是一小部分概率会命中。
答：是有概率的， 概率取决于合作品牌的投放规则，当前投放规则主要有：点位LBS场景（比如医院、商场、写字楼等等）人群标签（年龄段、性别等等）
4.如何隐藏掉“放弃优惠，原价支付”？
答：hideSkipBtn=true 这个是用在类似售货机的支付场景中的。 需要在云码url后面多加一个参数，可以把这个链接隐掉。
5. 在云码页面，如果用户先选择 ：原价支付，调起收银台之后，用户没有支付，关闭了收银台页面，再次返回的云码页面； 这时再选择关注店铺0.5 有优惠，然后再次下单就会失败。支付宝小程序支付预下单请求结果：{"code":"40004","msg":"Business Failed","sub_code":"ACQ.CONTEXT_INCONSISTENT","sub_msg":"交易信息被篡改"?
答：(1).点“原价支付”时，阿里奇门接口通知你们创建支付宝订单
(2).第一次原价支付取消，然后点击关注优惠支付方式时，你们创建一笔新的支付宝订单，而不是去改第一笔的金额
6.问题如下 订单原价 1.0元:
用户扫云码后，点击关注店铺了，此时预下单 金额是0.5 预下单对应的 out_trade_no = "a"
调起收银台后，用户关闭收银台，再次选择 原价支付，支付金额1.0 预下单时，out_trade_no = "b"
调起收银台后，用户关闭收银台, 又选择了关注店铺支付 金额是0.5 预下单对应的 out_trade_no = "c"
但是这次天猫好像没有调用我们的接口，导致，我们数据库对应的订单中 out_trade_no = "c" ，
但是支付宝那边 还是out_trade_no = "a" ，然后支付回调时候，查询不到订单信息，导致交易是把。
问题：每次预下单 都是请求了我们实现的奇门接口了吗？ 如果没有，可以设置成，不管怎样每次都请求我们实现的奇门接口？
答：点击“关注店铺” 和 “原价支付”肯定是两次不同的请求，promotionprice也不一样。 2） 重复多次点击同样的按钮，比如重复点击"关注店铺"，奇门请求不会重复发送了，而是通过第一次得到的支付宝订单号直接拉起收银台。 所以按照你上面整理的情况，前两步跟你说法一致，第三步里面用到的 out_trade_no 会是第一步的 “a”，这样设计也是性能最佳的。回调的时候，你们按照这个逻辑做个判断就行了。
7.上线后的promotionPrice金额是固定的吗？
答：是固定的。promotionPrice单位为元。
8.如果切换到正式环境后用户每次点击url后获取的优惠信息都不一样吗？
答：是的。我们是一批品牌同时投放的，会有算法来判断这个用户应该投放哪个品牌的权益。
9.在调用订单同步接口时出现code":15,"msg":"Remote service error","sub_code":"8","sub_msg":"no scan record"？ tmall.stella.cc.record.order.sync
答：意思是该用户的前面没有发生扫码动作， 说明也不是真实的交易信息， 这种情况下不能回传交易信息。
四、平台结算类
1.权益金额怎么返现给服务商
答：目前是线下结算给你们，这个是 景豪 负责。结算金额的依据是你们回传的订单信息，并且会跟我们这边的拉新量比对。
2.平台结算的依据是什么？
答：我们的结算只看给品牌拉了多少关注。
3.请问钱是会打到这个注册的企业淘宝账户上是么？
答：暂时是线下打款，合同上约定打款账户
五、云码业务接口类
1.在调试后端接口时是否可以用沙箱环境？
答：请直接用开放平台的正式api环境测试，云码相关的沙箱环境我们没维护。
2.SPI的实现，我们采用post接口就可以是吧？
答：是的。
3.同一个channelId和deviceSn只能被扫一次吗，换了个用户扫码会返回 "已被其他用户扫过，请重新操作"？
答：这个报错是为了防止售货机出一次码被多人同时扫，通过这个参数控制的。 你们如果是静态码，可以把这个参数去掉。
4.另外，关于业务场景，这个上线后，对于我们自贩机，是所有的商品都可以接入云码么？还是有特殊要求？
答：对平台来说全部商品都可以。你们来控制就好。
5.有个字段这边还有些歧义还，qimen.tmall.cloudcode.business.notify( 云码业务状态通知 )中的version是每次回调答：请求都唯一，还是用户一次打开页面和关注唯一，下次打开页面会不一样?
用户的每次扫码，会分配一个唯一的version，两次扫码的version是不同的，一次扫码，从开始到结束都是相同的version
6.订单同步必须要做吗？
答：这个传不传对整个流程不影响，主要平台这边做数据分析用的，如果时间赶的话，你们可以先把这个接口的优先级排低，上线后做也行的。
7.请问云码的设备编码最长支持多少字节？
答：128字节 最好不要超过32字节
8.调接口是渠道id填什么?
答：渠道id就是appkey。
9.订单回流接口中云码版本号指的是？
答：是奇门通知给你们的version.
10.云码设备圈选命中查询接口返回结果是只会返回有效时间内的吗，还是说也会返回未开始的？
答：只返回有效时间内的。
11.淘宝开放平台的SKD有maven依赖么？
答：这个没有的 ，因为每个开发者的sdk都不一样（根据其拥有的api权限列表 动态生成的）。
12.在拼接云码时自定义的参数需要做特殊处理吗？
答：要的。你们需要对自定义的参数进行decode否则平台解析不到url里面的key和value。因为会存在其他运营商有特殊字符但是不需要decoder的情况所以需要你们自己加密然后再解密，encode只需要encode参数中的key和value，整体不能encode。比如：urlencode(key)=urlencode(value) & urlencode(key)=urlencode(value)。
13.用户取消订单 还用回传订单信息么？
答：不用 因为我们是按照拉关注的数量来给服务商结算佣金的
14.请问用户扫码进入的链路（cpa/cps）是随机的吗？
答：天猫这边有个投放引擎来判断走哪条路。 是否走A链路(命中)主要的判断规则有：消费者人群标签、设备LBS场景属性， 会去跟品牌池里面品牌配置的拉新规则做匹配。
15.如果同一用户在同一时间多次购买，品牌的权益金额是否会被多次命中？
答：会的，一个品牌只能被命中一次，下一次会被其他品牌的投放计划命中到前提是符合品牌的投放规则(比如:性别，年龄等等)。
16.消费者与云码交互的过程中phase(用户当前的操作行为)的这三种阶段是不是可以这样理解1.scan：询问用户是否命。2.no_promotion：用户放弃权益。3.action：用户关注享受权益？
答：qimen.tmall.cloudcode.business.notify 1.触发事件： 1）调用 tmall.stella.cc.task.charge.launch 后。 命中时，特征：phase = scan & promotionPrice = 0.5 未命中时，特征：phase = no_promotion & promotionPrice = 0 2）消费者打开/进入CPA页面。特征：phase = scan & promotionPrice = 0.5 3）消费者在CPA页面点击“关注/入会”按钮。特征：phase = action & promotionPrice = 0.5 一般会根据收到phase = action来作为派发权益的依据。 2.请务必处理好幂等性。当平台未收到该奇门消息的响应时（比如网络丢包的情况），会重试发送同样的消息。
17.云码跳转到小程序是如何透传运营商自定义参数？
答：动态参数直接拼接在云码url后面就行， 我们会向后透传拼在你给的这个小程序页面地址后面。比如：云码url拼参数：https://jupiter.taobao.com/cc/scan?channelId=${channelId}&deviceSn=${deviceSn}&commodityId=xxx&salePrice=100&v=1542858210000&自定义参数=XXX，透传给小程序页面：alipays://platformapi/startapp?appId=XXXX&page=%2Fpages%2Fpay%2FpayPreview%2FpayPreview&自定义参数=XXX
18.奇门回传用户当前操作行为“phase”的这三种阶段是不是可以这样理解scan：询问用户是否命，no_promotion：用户放弃权益，action：用户关注享受权益。？
答：1.触发事件： 1）调用 tmall.stella.cc.task.charge.launch 后。 命中时，特征：phase = scan & promotionPrice = 0.5 未命中时，特征：phase = no_promotion & promotionPrice = 0 2）消费者打开/进入CPA页面。特征：phase = scan & promotionPrice = 0.5 ，3）消费者在CPA页面点击“关注/入会”按钮。特征：phase = action & promotionPrice = 0.5 一般会根据收到phase = action来作为派发权益的依据。 2.请务必处理好幂等性。当平台未收到该奇门消息的响应时（比如网络丢包的情况），会重试发送同样的消息。
六、云码（投放任务相关）配置类
1.已经提交审核的创意里面的图片 后面可以编辑修改吗？
答：审核后就不能改了。 投放任务、创意是一对一的。
可以新建创建、新建投放任务，然后把老的停掉就行 运行中的投放计划可以随时终止
七、云码扫脸付
1.如果消费者点击了CPA页面的“关注”按钮，那么平台会通过奇门接口（qimen.taobao.cloudcode.alifacepay.business.notify）通知运营商” 这个是如何通知我们？你们回调我们API还是我们轮询？
答：天猫回调你们接口， qimen.taobao.cloudcode.alifacepay.business.notify 这个接口就是需要你们实现逻辑并发布的。 文档：https://open.taobao.com/doc.htm?docId=116667&docType=1
2.派给消费者红包金额，在哪个环节,或者哪个接口通知你们？
答： 收到notify接口的消息（其中phase参数值为“action”时），就派红包。 这个不需要通知我们。
3.你们派给消费者的红包金额是在什么地方设置的？如果可以设置，我们按比例比如2/8(用户80%我们留20%)。这个20%是直接到我们淘宝账户上吧？
答：消费者红包是你们垫资派发，天猫事后给你们结算。 比如消费者点击了“关注”，你们派0.5元红包。天猫每个月（具体频率看商务沟通情况）安照关注数跟你们，比如每个关注算1元。
4.运营商派发的0.5元红包是在什么地方设置呢？
答：其中会用到支付宝的这个接口： alipay.marketing.voucher.send(发券接口)
八、云码&小程序类
1.小程序跳转到关注页，这个关注页是跳转到你们小程序还是h5呢？
答：是h5页面
2.我们怎么从你们这个h5页面回到我们自己的小程序页面呢？
答：我们会拉起你们的确认订单页。
3. 现在小程序支付能接入天猫云码吗？
答：支持的云码的几个页面当前都是H5，是支持内嵌到你们小程序里面的。“小程序支付”我理解后端的支付api不会变化，前端收银台仍然是云码拉起。云码h5页面（淘宝域名）内嵌你们小程序，需要我这边走一个内部申请流程，预计2~4个工作日。 所以如果你们是要改造的话，需要提前给我小程序appid、小程序名称。
4.小程序内唤起云码报“页面访问受限的错误”？
答：这是因为小程序H5域名外跳的备案还没审批完成，要等审核完成后在进行测试。请联系小二提交小程序域名白名单申请