版本号 |
修改内容 |
日期 |
V2.1 |
设备签约 |
2020/09/02 |
V2.0 |
增加小程序支持 |
2020/07/15 |
适合于有团餐场景开发能力的ISV
适用于校园、园区、社区、企事业单位的食堂和餐厅的消费支付。提供商户一款集刷脸、扫码、刷卡一体的智能收银受理设备,ISV可以在这款设备上进行二次开发,满足商户的个性化结算需求。
针对食堂档口复杂环境设计,支持档口的多种安装方式。采用键盘分离设计方式,采用防油污材和防火阻燃材料设计,支持IP55防水和V0防火等级,机具易于清洁保护。海马S1产品及规格介绍,请查阅。
申请邻客蚁权限:
联系支付宝业务BD或技术支持同学申请开通,需提供要访问邻客蚁平台人员的邮箱账号。在支付宝审批通过后,申请人员会在提交的邮箱里面收到注册邀请邮件,申请人员点击确认后就可以在邻客蚁平台上看到相关的邻客蚁项目。
申请参考DEMO:
在申请到邻客蚁平台权限后,如果开发需要刷脸和扫码的demo进行参考,请联系支付宝技术支持同学。
硬件有4G版和WIFI版两种。为区分行业场景,机具所适用的场景由支付宝分配的物料id进行区分,合作伙伴在采购时根据自身所需采购合适的版本。不同的物料id,不能在行业间错用、乱用。
名称:商米FT1 mini团餐设备 物料id(Item ID):2019071603138886 供应商id(Supplier ID):2018041600054976
名称:商米FT1 mini高校团餐设备 物料id(Item ID):2019091904075657 供应商id(Supplier ID):2018041600054976
设备支持3个接口:RJ45网口、USB2.0*2。同时支持Micro USB和PSAM卡槽。 说明:Micro USB接口使用时不能和RJ45网口/USB口同时使用。
具体接口定义和位置说明,请见文档
设备出厂ROM预置有刷脸smile apk、IOT Sdk、小程序容器xpass。合作方在拿到设备后,即可进行方案的对接和产品开发,开发属于自己的收银应用,实现刷脸支付。
合作方可选择的开发技术:
为了保证设备推送应用内容的准确性,需要ISV服务商在设备管理平台上完成签约操作后,服务商才能提出申请或自主完成应用的分发及运营操作。具体操作流程:
第一步:渠道或服务商购买设备后,通知厂商完成设备出货进件。
渠道或服务商需提供支付宝pid给到厂商(商米),厂商在进件平台完成设备出货进件后,ISV服务商(用设备进件账号的pid登录)在商家智能设备平台(具体路径:服务商平台 -> 运营中心 -> 经营工具 -> 商家智能设备)上能够看到该账号下已完成进件的设备列表,同时每台设备的角色里面能看到”申请者“。如果没有申请者角色,意味着这台设备最初的购买是别的合作方。
注意:平台在厂商进件审批完成后上T+1显示所进件的设备清单。
第二步:设备申请者完成初始化签约,获取设备的”所有者“角色,完成设备的归属。
渠道、服务商或商家是申请者的话,可以在设备管理平台(具体路径:服务商平台 -> 运营中心 -> 经营工具 -> 商家智能设备)上对设备进行初始化签约,获取设备的”所有者“角色。具备”所有者“角色的渠道、服务商或商家有设备的应用分发及设备的运营权。具体:在每台设备对应的操作一栏选择”签约“按钮。
注意:一个进件单下的某一台设备sn签约会自动触发这个单子下的其余设备签约,自动签约会有同步时间,请间隔一段时间刷新查看其它设备的签约情况。如果在未完成自动签约前手动点击签约,平台会报“签约冲突”错误。
如果设备已经签约,设备的”所有者“可以转给其它的合作方。具体:
- 转移方在设备管理页面,点击下方的”批量转签约“按钮,在设备列表页面选择需要转签的设备,选择好后输入接收方的支付宝账号。
- 接收方在设备管理页面,查看被转移进来的设备。
五种安装方式:左侧挂式安装、顶部挂式安装、右侧挂式安装、玻璃挂式安装、台式支架安装。台式支架需要向商米另行采购。具体安装方案,请见文档。
参照就餐人员的平均身高选择安装高度(摄像头距地面的距离)。
高度 |
角度 |
身高范围(距离60cm) |
|
140 |
0 |
125(最低) |
175(最高) |
150 |
0 |
135(最低) |
185(最高) |
160 |
0 |
145(最低) |
195(最高) |
假设安装高度160cm的话, 覆盖145~195cm 身高人群。如果是上下垂直调整的话, 就直接相减即可。比如安装高度下降30cm至 130cm的位置, 则覆盖身高变为115~165cm。如果离得更近,那身高范围会缩小一些。以上是理论计算, 实际测试会比这个范围大。
设备出现故障,可以扫描机身的售后统一维保码进行报修,根据商米的售后维保政策享受售后服务。
维保码示例:
为保障支付的稳定和延续性,在系统检测到有新的版本可升级时,需要现场工作人员手动点击更新。如果需要支付宝强制系统升级,请联系对应的BD。
系统ROM版本的更新,请见海马重要公告。
『设置』-『系统』-『关于设备』-『系统升级』
当前版本:即当前系统的版本号信息
升级版本:即将被升级的版本号信息;
上面的xxxxx表示升级版本号,格式一般为1.2.0.201910229153_RS
为确保上线设备的系统安全,adb接口的使用按照最小访问原则开放,如果需要用到调试功能,需要权限申请。注意:账号仅限于申请公司内部开发使用,不可泄露。发现相关风险,账号将会被封禁。
申请账号参考【ADB账号申请】文档。
参考【ADB使用说明】。
adb devices
,机具系统会弹出授权框,点击授权;- 其它未知问题
在PC的 .android
目录中找到 logfile.txt
文件,单独发给 @伊索 suhao.s@antfin.com进行排查;
设备支持刷脸、扫码和刷卡三种身份识别介质,身份识别出来后,由ISV根据自己的收银、结算的业务逻辑完成收银的端到服务侧开发。扫码和刷脸复用摄像头,刷脸和扫码是互斥行为。在收银结算支付环节,建议UI默认处于扫码支付,刷脸支付由用户或收银人员点击启动进入刷脸。
刷脸支付支持两种模式:封闭场景人脸识别和在线人脸识别两种方案。根据场景的不同,有针对性的方案可供接入:
方案名称 | UI交互视效(建议) | Native应用开发技术 | 小程序应用开发技术 | 说明 |
K12行业封闭场景方案 | 参考 | 基于Android Native开发指南 |
不支持 | 无 |
高校行业本地比对在线付场景方案 | 参考 | 基于小程序开发指南 | 与企业团餐在线方案类似,可以参考企业团餐在线场景方案 | |
企业团餐本地比对在线付场景方案 | 参考 | 基于小程序开发指南 | 目前企业团餐无行业归属,需要isv服务商自行开发接入 | |
云支付版 | N/A | N/A | 云支付版应用,免开发 |
设备IOT注册、绑定具体接口及使用说明,请见链接。
因所属行业对设备的绑定不同,如需对接iot设备绑定需要接口权限申请,具体流程:
合作方向业务BD提出申请,业务BD邮件发送到iot_campus@service.alipay.com。邮件内容需包括:ISV名称、ISV PID、ISV APPID、业务合作背景
为方便合作伙伴快速调试,如果合作方没有正式的学校不能够创建门店,可以在联调阶段使用如下测试门店ID:
- K12:
商户PID:2088211521646673
测试门店id(shop_id):2020011400077000000086853157
测试门店名称:第一中学一餐厅
- 团餐:
商户PID:2088211521646673
测试门店id(shop_id):2020011500077000000086876078
测试门店名称:浙大第一餐厅
常见问题和帮助,点击链接