社区提问
意见反馈
IoT 小程序服务分发 FAQ
有关服务分发的详细指导可查看 服务分发。
Q：什么是服务分发？
A：服务分发是指将已开发好的小程序或应用服务，通过平台一键下发至自己拥有的设备中，该功能应用于购买量大的设备，可查看 服务分发。
Q：商家进行服务分发是否可以分发别人的小程序到蜻蜓设备？
A：可以，分发的 APPID 是商家自行输入。既可以输入自己的 APPID，也可以输入其它商家的 APPID。比如商家 A 开发了一个 IoT 小程序把 APPID 给到商家 B，商家 B 输入商家 A 的 APPID 就能去拿到商家 A 的小程序版本，然后去分发到自己的 IoT 设备中。
Q：IoT 小程序已下架，但是蜻蜓设备中还存在对应版本，如何清除缓存？
A：分发问题，在分发平台恢复默认后，重启蜻蜓设备即可。可以登录 支付宝服务商平台，点击 运营中心 > 经营工具 > 商家智能设备 > 蚂蚁IoT设备申请入口 > 服务分发，进行恢复默认操作，可查看 清除设备分发记录。
Q：商家确认小程序已下架，为何关机后再开机仍然可以进入到小程序中？
A：下架了蜻蜓设备上还是保留着 IoT 小程序的版本，即使恢复出厂设置，设备启动后也是进入小程序的缓存页面，但此时会是错误页面无法正常运行。必须要清除设备上小程序的缓存，让设备恢复到初始版本，即未被推送小程序的状态。需要登录 支付宝服务商平台，点击 运营中心 > 经营工具 > 商家智能设备 > 蚂蚁IoT设备申请入口 > 服务分发，进行恢复设备操作，可查看 清除设备分发记录。
总结：设备运行全部由支付宝服务商平台管理，想让设备运行小程序或者恢复设备初始版本，需要在分发平台操作。下架只是小程序版本下架，设备缓存中还是保留着小程序。如果设备被分发过小程序，但是启动前该小程序又下架了，则设备启动会报错，如果是启动并进入过 IoT 小程序的设备，那么小程序下架后设备还是能继续使用该小程序。
Q：蜻蜓设备分发 IoT 小程序之后，开机默认的是进入小程序界面还是蜻蜓设备初始界面？
A：进入小程序界面，分发后设备重启，默认启动被分发的小程序。
Q：IoT 小程序发布灰度测试，添加设备后，这些设备如何才能使用小程序？
A：灰度测试完成后上架小程序，最后进行小程序分发，完成分发后的蜻蜓设备就可以使用该 IoT 小程序。IoT 小程序发布灰度测试可查看 IoT 小程序审核上线，分发小程序流程可查看 IoT 小程序分发。
灰度测试仅支持已分发小程序的蜻蜓设备。若设备还未分发过小程序，可以直接将小程序灰度并上架，最后分发。当蜻蜓设备已被分发到小程序后，可以再次进行正式的灰度测试。
Q：为何开放平台一直显示小程序分发中？为何重启设备仍然不支持自动进入到分发的小程序中？
A：确认设备端是否升级到了支持小程序的最新版本，可查看 IoT 小程序开发准备的 设备系统版本要求。
Q：如果 IoT 小程序分发后重置了收银模式，是否会影响分发的小程序？
A：重置收银模式不会影响已分发小程序，设备会自动拉取。
Q：未上线（上架）的 IoT 小程序可以进行分发吗？
A：不可以。开发阶段可以直接使用小程序开发者工具（IDE）的 预览 或 真机调试 功能向蜻蜓设备推送小程序，不需要分发。
Q：需要进行分发操作的设备前置条件是什么？
A：
- 购买设备之后，需要同时完成签约操作（设备列表页显示 签约转移 即表示拥有签约关系），才有权限对自己购买的设备使用服务分发平台进行小程序/应用的小程序分发配置，可查看 购买设备与签约。
非官方推荐渠道售卖的设备，可能已由上游渠道操作过 服务分发，建议先行确认清楚，需要获得 设备所有者 关系才能进行服务分发。 - 服务分发平台 中没有找到我的所有设备：
未看到的部分设备信息可能产生的原因：
- 未在天猫平台上点击 确认收货。
- 厂家渠道购买的设备，需要厂家到支付宝进件填写购买者信息。
- 推送操作因网络等情况可能会有延迟，若推送操作后有延迟请操作：开机 > 待机 > 推送，30 秒后重启。
Q：什么是设备“所有者身份”？
A：
- 天猫渠道蚂上官方渠道购买：将自动获得设备的所有者关系，可进行小程序或应用的服务分发。
- 指定工厂渠道（禾苗、天波、商米、蚂里奥）购买：工厂进件后会在支付宝平台反馈所有者关系，方可进行小程序或应用对自己拥有的设备进行投放。
- 其它服务商渠道购买：官方不能保证设备的所有者关系，所以需要上游服务商转移签约关系至该开发者，才可以有设备的小程序取消操作功能权限。
Q：服务商如何进行服务分发操作？
A：可查看 服务分发。
Q：商家如何进行服务分发操作？
A：没有开发小程序产品的商家（已成为设备所有者），想用其它合作伙伴的小程序，需要先对合作伙伴的账号进行授权操作，再进行 服务分发。
- 对企业账号进行授权，可查看企业账号授权流程 服务分发的邀约授权。
- 对个人账号进行授权，可查看个人账号授权流程 服务分发的邀约授权。
Q：服务分发入口在哪里？
A：设备所有者登录 支付宝服务商平台，点击 运营中心 > 经营工具 > 商家智能设备 > 蚂蚁IoT设备申请入口 > 服务分发，进行恢复设备操作，可查看 服务分发。
Q：哪些情况不能进行服务分发？
- 该流程仅限于服务商 / 开发者对自己购买的设备（设备所有者）进行小程序配置进行推送。
- 当设备在平台转签约给其它客户后（即所有者转移后），不能自行再次推送小程序。
- 如对其它合作伙伴的设备上需要推送服务商 / 开发者开发的小程序，需要进行邀约合作方可推送。
Q：为什么我的后台设备搜不到小程序？
A：需要满足以下三点要求：
- 需要先查看设备购买渠道是否为官方指定渠道购买，设备所有者身份方可搜索小程序。
- 确认是否为开发小程序的邀约合作方，并已被邀约成功方可进行搜索。
- 需确认该小程序是否已经被审核通过并上架成功。
Q：如何恢复小程序之前的设备标准版本？
A：可查看 清除设备分发记录。
Q：小程序调试完成后如何发布配置到每台机器？
A：可查看 IoT 小程序分发。
Q：如何将服务配置到机器上需要注意什么？
A：推送操作的时候，请务必谨慎，建议按设备总量的 10% ~ 20% ~ 30% ~ 40% 的节奏（百分比可以自行调整）进行分发操作，进入下一阶段之前，请谨慎确认已推送的机器上小程序的状态，确认没有问题之后再进行下一阶段的推送。
Q：为何我的设备没有出现在可以配置小程序的设备列表中？
A：可查看下列问题 设备从什么渠道购买。
Q：设备从什么渠道购买？
A：可以联系生产厂家直接购买设备，或拨打 4007585858 咨询购买渠道，可查看 智能设备。
Q：关机时是否可以进行服务分发？
A：目前支持关机状态下推送小程序，设备启动时将自动配置。若设备在线状态下推送小程序，下发服务后需要设备重启方可生效。
Q：设备服务分发后的几种状态是什么意思？
A：
- 服务分发成功：设备已成功运行小程序，即设备端已运行成功。
- 服务分发中：云端配置成功，待设备端重启或开机生效。
Q：设备服务分发失败可能的几种原因？
A：
- 设备目前未升级成最新的版本。
- 云端配置已成功，因网络干扰等不可控因素导致设备服务分发失败，可尝试重启设备生效。
Q：推送服务后，多久生效？
A：推送服务提示成功后，可能需要 30 秒左右（具体时间参照网络情况）重启开机确认是否生效。
Q：商家自己购买的设备，可以安装开发者的小程序吗？
A：可以，需要先完成设备的邀约合作，方可由开发者推送设备。邀约合作可查看 企业账号授权流程。
Q：如何防止别人改动自己的设备中的小程序？
A：如不是设备的所有者无法更换设备的小程序配置：所有者=设备购买/申请者+签约者。
如需要自行改动小程序，可以登录 智能设备专区 > 服务分发，指定小程序配置到自己购买的设备上。
注意：请不要随意将自己的设备 SN 和 PID 透露给第三方。
Q：设备可以获取 root 权限吗？
A：不可以。为了设备的刷脸支付安全性，设备限制不能获取到设备的root权限。
Q：什么是邀约合作？
A：邀约合作：是指商家向服务商申请合作，双方达成合作意向后在自己拥有的设备上使用对方的开发服务。目前邀约成功后，支持商家对自有设备进行小程序分发（服务商已开发并上架的）。
Q：什么是设备分组？
A：设备分组：提供了将多台设备放置在一个群组的功能，以便于客户对该分组进行管理。目前支持新增分组、将设备移至分组、分组命名的功能。服务商或商家可对该分组的设备进行不同的小程序服务分发精细化管理。
Q：二次开发更新了小程序的版本后，需要再次分发吗？
A：服务分发后设备上将自动拉取最新版本，若需要回退原版本；需要小程序更新为原始版本。
Q：设备恢复时输入设备会提示设备无效？
A：目前该操作有些问题，可以采用 excel 文件批量上传的方式。
IoT 小程序刷脸 FAQ
Q：哪些用户可以使用刷脸支付？
A：根据国家相关政策要求，目前刷脸支付暂时仅对支付宝大陆实名用户开放，且账号需要绑定中国大陆的手机号。
Q：刷脸支付额度（日限额）是多少？
A：单个支付宝账号单笔单日刷脸支付金额上限 5000 元。
Q：刷脸支付的扣款顺序是什么？
A：按照用户设置的付款顺序进行轮询支付，如果用户没有设置则按照系统默认的付款顺序进行轮询。具体扣款顺序请参照实际扣款为准。系统默认的付款顺序：信用卡快捷（如支持）、余额、借记卡快捷、余额宝、花呗、亲密付、信用卡快捷（未存卡）（如支持）、借记卡快捷（未存卡）。
Q：为什么刷脸支付有时候需要输入手机号，有时候不需要？
A：为了给用户更极致的刷脸付款体验，在安全的前提下系统会综合评估当次付款是否需要校验手机号。
Q：刷脸支付需要输入的手机号是什么手机号？
A：请输入支付宝账号绑定的手机号，可以打开支付宝客户端，点击 我的 > 设置 > 账号与安全 > 手机号 查看。
Q：如果支付宝账号更换了绑定手机号，刷脸支付时是不是需要马上输入新的手机号？
A：不需要，手机号更换是同步生效的。
Q：有多个支付宝账号，支付宝客户端如何选择刷脸支付的付款账号？
A：在没有选择某个账号为 到店刷脸支付 的付款账号的前提下，会扣除支付宝客户端最近一次登录的账号；也可以在支付宝客户端中设置：我的 > 设置 > 账号与安全 > 生物识别 > 刷脸设置 > 到店刷脸支付 > 设置当前账号为付款账号 后，当前登录账号即为刷脸支付的付款账号。
Q：支付宝刷脸支付的安全性如何，会存在用照片或视频盗刷的情况吗？
A：支付宝能率先推出刷脸支付，一是基于其多年来人脸识别技术的积累（支付宝是最早实现刷脸登录的金融级 App）；同时其技术团队也为刷脸支付商用做了很多独创的优化。通过软硬件的结合，智能算法与风控体系综合保证金融级准确性和安全性，目前识别的准确率为99.99%。支付宝在刷脸支付设备上配备了3D红外深度摄像头，在进行人脸识别前，会通过软硬件结合的方法进行验证，来判断采集到的人脸是否是照片、视频或者软件模拟生成的，能有效避免各种人脸伪造带来的身份冒用情况。
Q：刷脸为什么一直刷不过？为什么无法识别人脸？
A：可能由以下原因导致用户刷不过，可以引导用户做相应调整后再做尝试：
- 确认本人操作：输入手机号对应的支付宝账号，确实为用户本人。用户可通过打开支付宝客户端，点击 我的 > 设置 > 账号与安全 > 实名认证 查看，账号实人身份是否为本人
- 确认操作正常：尽量保持正面，抬头看摄像头，并且脸部无帽子、墨镜等遮挡。
- 确认证件照片质量合格：极少部分用户可能会因为证件照片质量问题，无法完成比对。
Q：如何开通或关闭到店刷脸支付？
A：手机端开通与关闭入口：打开支付宝客户端，点击 我的 > 设置 > 账号与安全 > 生物识别 > 刷脸设置，将 到店刷脸付 选项关闭即可。
蜻蜓开通入口：
首次使用授权即开通。关闭则还需要查看手机端关闭的路径。如果用户已经在钱包端主动关闭了到店刷脸支付，在机具端无法开通，必须在手机端开通，页面会提示到店刷脸支付已关闭，请扫描二维码开启。
IoT 小程序其它 FAQ
Q：IoT 小程序是否支持花呗分期？
A：IoT 小程序扫码支付支持花呗分期。IoT 小程序刷脸支付暂不支持花呗分期。
Q：实现小程序 IoT 刷脸支付需要签约什么权限？
A：需要签约 当面付。详细调用方法可查看 my.ix.startApp（启动收银台）。
Q：为什么 IoT 小程序内时间获取不准确？
A：建议使用 my.getServerTime 获取时间。
Q：支付宝小程序可以使用 IoT 小程序的 API 吗？IoT 小程序可以使用支付宝小程序的 API 吗？
A：支付宝小程序不可以调用 IoT 小程序的 API，而 IoT 小程序可以调用支付宝小程序的通用 API，具体可查看 IoT 小程序 API 概述。
Q：IoT 小程序是否支持会员卡？如何调用？
A：IoT 小程序可以在 刷脸支付结果页 进行会员开卡无需小程序开发对接，详细操作可查看 支付成功页产品介绍，也可以在小程序开发过程中调用 商家会员卡 接口实现。详细信息可查看 IoT 设备支付结果页配置会员卡、优惠券和小程序。
Q：IoT 小程序接入 my.chooseImage API 为什么不能唤起蜻蜓设备摄像头拍照功能？
A：出于数据安全考虑，IoT 小程序禁止调用摄像头，请勿在 IoT 小程序上调用 my.chooseImage API。
Q：IoT 小程序如何获取商户信息？
A：IoT 小程序不支持获取商户信息。
Q：蜻蜓设备如何转移给其他开发者？需要重新签约吗？
A: 具体可查看 商家平台 IoT 阵地政策签约、政策主体变更SOP.docx。
Q：个人开发者可以开发 IoT 小程序吗？
A：不可以，目前支付宝 IoT 小程序仅支持企业账号发布，个人账号可以用于开发和调试，但不能提审和发布。
Q：蜻蜓设备与 IoT 小程序的绑定关系如何？
A：一个小程序 AppID 最多绑定10台蜻蜓设备作为开发机，但向蜻蜓设备分发同一个 IoT 小程序时的蜻蜓设备数量无限制。一个蜻蜓设备能绑定的小程序 APPID 无限制，但一个蜻蜓设备同时只能运行一个小程序。
Q：对于没有开发能力的商家如何接入 IoT 小程序？
A：在 服务市场 > 小程序 > IoT 小程序 类目下可以找到 IoT小程序服务商。
Q：IoT 小程序是否支持定位功能？
A：不支持，IoT 设备暂不支持获取位置的能力。
IoT 小程序收银台接口实现刷脸支付和扫码支付
刷脸和扫码支付场景介绍
IoT 小程序的刷脸和扫码支付功能在设备展示是在同一页面，在支付页面可以选择刷脸或者展示付款码支付。
在支付页面下，设备摄像头默认开启 扫码支付 功能，直接出示付款码对准摄像头即可完成支付；若点击页面上的 刷脸支付 设备摄像头就切换为刷脸模式。
说明：IoT 小程序支付获取返佣无需开发对接，可查看 蜻蜓系列设备奖励政策方案公告。
小程序开发刷脸和扫码支付
第一步：完成 IoT 小程序接入。
第二步：在小程序调用 my.ix.startApp（刷脸支付/扫码支付） API。
IoT 小程序实现刷脸核身
刷脸核身场景介绍
刷脸核身功能是通过刷脸来获取用户的支付宝 user_id 来核实用户身份的功能。与刷脸支付不同，刷脸核身同样应用于酒店等这类需要验证身份的行业。
支付宝目前已提供 酒店自助入住解决方案。
刷脸核身功能开发
第一步：完成 IoT 小程序接入。
第二步：在小程序中调用 my.ix.faceVerify API。
可查看 IoT 小程序快速示例 接入 刷脸核身 功能。
IoT 小程序版本相关说明
IoT 设备系统与小程序容器的关系
IoT设备系统 是 IoT 设备的基本运行系统，小程序容器 是用于支持 IoT 小程序在 IoT 设备系统内运行的 APP，即 小程序容器 是 IoT设备 的系统应用。其中，蜻蜓设备系统在 2.1.0.20190727XXXXXX 及以上版本集成了 小程序容器。
系统版本
IoT设备系统 是 IoT 设备的基本运行系统。设备在开机联网状态下会自动下载最新的系统软件包。设备在开机和重启时，检测到已下载完成的系统包将自动进入安装升级流程。此外，每日凌晨，处于开机状态的设备会自动进入安装升级流程。自动升级暂不支持手动关闭。
IoT 设备系统版本获取
以蜻蜓设备为例：
IoT 小程序可以通过可点击蜻蜓小键盘 设置，进入系统设置页面 > 关于本机 查看系统版本号。
小程序容器版本
小程序容器 是用于支持 IoT 小程序在 IoT 设备系统内运行的 APP。蜻蜓设备系统在 2.1.0.20190727XXXXXX 及以上版本集成了 小程序容器。蜻蜓设备开机、重启或闲置 30 分钟后会自动检查最新软件版本并下载安装。自动升级暂不支持手动关闭。
小程序容器版本获取
IoT 小程序可以调用 my.ix.getVersion 查询当前设备小程序容器版本，也可以调用 my.ix.getVersionSync 同步查询程序容器版本，或者查看 IoT 设备系统版本获取 查看小程序容器版本。
蜻蜓应用版本
蜻蜓应用 是承载蜻蜓标准收银（包括独立收银和连接收银机收银）和电子海报等功能的 APP。蜻蜓设备每 30 分钟自动检查最新软件版本，若检查到新版本则在闲置 5 分钟后下载安装，开机或重启则会直接检查更新并下载安装。自动升级暂不支持手动关闭。
蜻蜓应用版本获取
IoT 小程序可以调用 my.ix.getVersionSync 查询蜻蜓应用版本，或者查看 蜻蜓设备系统版本获取 蜻蜓应用版本。
蜻蜓设备和 IoT 小程序与收款账号之间的关系
蜻蜓设备是 IoT 小程序的载体。蜻蜓设备出厂具有一定的功能，而 IoT 小程序可以开发更多的功能，在蜻蜓设备上体现。IoT 小程序通过 服务分发 接入到蜻蜓设备上，一旦完成分发，蜻蜓设备就只能使用 IoT小程序的功能。但在分发 IoT 小程序之前，蜻蜓设备也具有收银功能。
蜻蜓独立收银模式和连接收银机模式
蜻蜓独立收银模式和连接收银机模式 就是蜻蜓设备在分发 IoT 小程序之前具有的两种收银功能。这两种模式可以直接绑定收款账号，通过蜻蜓刷脸或扫码完成收银。
蜻蜓设备与收款账号
蜻蜓设备在未分发 IoT小程序之前，也就是初始状态时，也具有收银能力，同时还拥有 独立收银 和 连接收银机 两种收银模式。如下图：
在这两种模式下，蜻蜓设备需要绑定一个收款账号作为收银入账的账号。可以在蜻蜓设备上进入 设置 > 绑定账号 进行收款账号的绑定。如下图：
IoT 小程序与收款账号
蜻蜓设备一旦接入 IoT 小程序，那么所有功能都将由 IoT 小程序实现，包括收银功能。那么 IoT 小程序实现 my.ix.startApp（刷脸支付/扫码支付） 的收款账号就是是小程序服务端/收银机服务端调用支付宝当面付 alipay.trade.pay（统一收单交易支付接口）的账号。
IoT 设备支付结果页配置会员卡、优惠券和小程序
简介
IoT 设备支付结果页支持通过业务配置添加会员卡、优惠券和小程序作为推荐内容。对于 IoT 设备的刷脸支付结果页 可以通过 支付成功页产品 配置会员卡，该 刷脸支付结果页 包括已 分发 IoT 小程序和未分发 IoT 小程序的支付结果页。
IoT 设备在支付结果页上的推荐内容与 IoT 小程序进程无关，不属于小程序进程。比如：IoT 小程序也有 商家会员卡，接入后可以在小程序页面上添加商家会员卡功能，两个会员卡是相同的功能。可以同时在小程序页面和支付结果页同时添加会员卡开通的入口。
说明：IoT 设备目前仅蜻蜓设备支持会员卡。
准入条件
- 请确认要配置的签约 PID下是否有支付场景（请与公司财务核对）。
- 请确认已签约 当面付 的产品（ 点我查询/与公司财务核对）。
- 请确认小程序是自己公司开发的，非天猫/口碑/饿了么等提供的小程序模板。
IoT 设备支付后推荐会员卡、优惠券和小程序配置
有关 IoT 设备在支付结果页配置会员卡、优惠券和小程序推荐内容的详细配置步骤可查看 支付后推荐。注意在配置过程中选择 推荐渠道 为：蜻蜓 IoT 设备。
如何获取 IoT 设备序列号、设备型号、设备 ID
- IoT 设备序列号 又称设备编号、设备 SN 号。
- 设备型号 即设备的产品名称（可以访问 IoT 官网 了解）。
- 设备 ID 即设备号，也是设备的全球唯一识别号。
获取这些信息的主要方式有 IoT 小程序接口获取 和 IoT 设备本身获取 两种方式。
说明：建议开发者用 设备 ID 作为设备唯一标识，应用于 设备-商户 绑定等场景。
IoT 小程序接口获取 IoT 设备序列号、设备型号、设备 ID
IoT小程序只需要调用 my.ix.getSysProp 即可获取 IoT 设备序列号、设备型号、设备 ID等信息。
IoT 设备本身获取 IoT 设备序列号、设备型号、设备ID
获取设备序列号
以蜻蜓设备为例：
方式一：长按电源键进入系统 设置 页，点击 关于本机 即可获取设备编号。
方式二：长按电源键进入系统 设置 页，点击 关于本机 > 系统信息 > 手机打开支付宝客户端扫码即可获取设备信息，包含设备序列号。
方式三：长按电源键进入系统 设置 页，点击 帮助中心 > 手机打开支付宝客户端扫码后在帮助中心页面显示设备序列号。
获取设备型号
以蜻蜓设备为例：长按电源键进入系统 设置 页，点击 帮助中心 > 手机打开支付宝客户端扫码后在帮助中心页面显示设备型号。
获取设备 ID
以蜻蜓设备为例：长按电源键进入系统 设置 页 > 关于本机 > 连续点击小程序容器8次 > 打开小程序配置 > 显示系统信息， 手机打开支付宝客户端扫码获取设备号（01010开头）。
支付宝小程序如何开通 IoT 小程序类目
使用 支付宝企业账号 登录 支付宝开放平台控制台 > 点击要开通 IoT 类目的小程，进入小程序详情页 > 设置 > 多端发布支持 > 点击 开通 IoT 端的发布权限。
说明：支付宝小程序支持多端发布，IoT 小程序属于支付宝小程序的 IoT 端，所以一个 APPID 只需要在管理后台开通了 IoT 端就可以在此发布 IoT 小程序。
此操作步骤为 IoT 小程序开发准备的 小程序后台开通支付宝 IoT 端发布 的步骤。
