文档中心 > 校园产品介绍与接入指南

硬件设备开发及接入IOT管控平台

更新时间:2020/03/12 访问次数:2852

1. 硬件设备开发及接入IOT管控平台

硬件合作模式有三种:合作方自有硬件接入、合作方基于海马S1(商米FT1 MINI)接入、合作方基于第三方硬件接入。根据合作模式不同,接入的要求、内容和步骤会有差别。

1).合作方基于自有硬件或第三方硬件接入

具体接入步骤,请见邻客蚁上对应合作方的项目空间上的产品文档:《刷脸团餐设备开发指南 V 1.0》

支付宝内部文档链接:https://linkant.alipay.com/100/document#nm8i9w

 

2. 创建门店&绑定门店

1).创建门店

第一步:ISV登录开放平台(https://open.alipay.com/platform/home.htm),选择运营中心 -> 商家管理 -> 我的商家

第二步:ISV代学校(商户)创建门店,“业务场景”必须选“高校团餐”。如果签约主体是学校,门店类目选择“教育-学校-高校”;如果签约主体是承包商,待与业务,产品确认。

2).绑定门店

第一步:调用云端API接口绑定机具和门店关系,“isv_id”传ISV的PID,该PID是签署返佣销售方案的PID。接

第二步:验证机具设备的注册、绑定数据

具体的绑定接口和说明,请见硬件设备的开发指南(《刷脸团餐设备开发指南 V 1.0》 或 《刷脸设备海马S1(FT1 MINI)开发指南 V 1.1》)中的绑定接口说明。

具体绑定数据取值规则及对应接口可以值定义如下:

分类

传参需求

Key

Value

value来源及使用说明

支付设备

门禁核身

接口连接

设备状态

单双通道

pay_channel

single

single - 单通道,设备仅支持支付宝支付

必需

N/A

https://docs.alipay.com/pre-open/api_pre/alipay.commerce.iot.mdeviceprod.device.initialize

supplier_expansion

Y

Y – 自己采购,合作方自己采购摄像

必需

N/A

绑定ISV

type

COMMON_ISV

在principal中传入ISV PID关系

必需

必需

https://docs.alipay.com/pre-open/api_pre/alipay.commerce.iot.mdeviceprod.device.bind

id

绑定关系id

id来源于要绑定isv的支付宝账号PID

必需

必需

绑定商户

type

COMMON_MERCHANT

在principal中传入商户 PID关系

必需

N/A

id

绑定关系id

id来源于要绑定商户的支付宝账号PID

必需

N/A

绑定门店

type

COMMON_SHOP

在principal中传入门店关系

必需

N/A

id

绑定关系id

id来源于要绑定门店的shop id,shop id在蚂蚁开放平台创建门店分配的id

必需

N/A

绑定学校

school_stdcode

绑定关系id

在扩展字段ext_info中的传入school_stdcode及其对应id值,绑定关系id来源于学校组织机构代码证,ext_info":"{\"school_stdcode\":\"2088200135791293\"}"

必需

必需

 

3).iot传参标准说明(消费、核身场景传参要求,与返佣有关,请合作伙伴认真校对)

  • 与返佣相关的交易及设备状态
  • IOT日志上报参数要求:

分类

传参需求

Key

Value

value来源及使用说明

支付设备

门禁核身

IOT日志

刷脸mdap日志

facemode

人脸sdk工作模式

人脸SDK根据刷脸使用的场景设置的刷脸参数,业务类型:facepay支付/entrance门禁/sign考勤/采集capture

必需

必需

ftoken

刷脸token

人脸sdk刷脸成功后返回biztid+时间戳组合的字符串

必需

必需

cameraSN

摄像头sn

人脸sdk读取机具设备中的摄像头sn

必需

必需

biztid

设备唯一标识

人脸sdk读取iot sdk中的唯一表示

必需

必需

deviceSN

设备序列号sn

人脸sdk读取设备中的sn

必需

必需

uid

刷脸核身通过的用户uid

用户uid随人脸特征加载到机具

FAQ

关于此文档暂时还没有FAQ
返回
顶部