1.    IOT机具设备管控介绍

IOT设备平台提供智能机具全流程管理，为机具提供统一的智能化运营平台。本指南适合于非刷脸设备的接入。

合作机具厂商或ISV通过开放平台入驻蚂蚁金服物料平台，获取蚂蚁金服的内部产品定义，并集成蚂蚁IOT SDK，并在交易收单请求中完成交易加签。ISV和服务商通过第三方应用授权或者代商户签约的方式进行商户拓展，ISV帮助商户在蚂蚁开放平台上创建门店、确定机具和门店的绑定关系。本指南不涉及机具申请、审批等供应管理环节。

2.    接入蚂蚁IOT设备管控平台

在整个接入SOP过程中，依赖如下获取到的关键信息：

信息定义	信息描述
PID	partner_id的简称，合作伙伴身份，签约的支付宝账号对应的支付宝唯一用户号，以2088开头的16位纯数字组成。ISV、机具设备厂商和商户都需要有自己的PID
item_id	由蚂蚁物料平台分配给机具设备的唯一标识，即便是同一款设备，不同的行业场景下分配各自场景的物料ID
supplier_sn	由蚂蚁物料平台分配给机具设备提供商的唯一标识，一款设备对应一个供应商id
device_id	机具设备厂商内部分配的唯一标识设备的id或sn，不同机具设备厂商的分配规则不同，但需要机具设备厂商确保厂商内部id唯一、不重复
isv_id	角色定义。基于机具厂商提供的硬件开发支付应用的系统服务商。服务商可以为自己拓展的商户进行代签约，并通过开放平台管理拓展的商户。如果机具厂商同时开发应用，则该厂商也是ISV。ISV的id，等同于开放平台分配的PID
shop_id	角色定义。服务商为商户代创建门店，对商户每一个摆放机具的场所进行精细化管理。 例如一个食堂是一个门店，学校财务处是一个门店等， 一个澡堂是一个门店等。详见门店管理（创建商户门店，只能为当前服务商下的商户创建门店，服务商和商户的绑定关系可见服务商一栏描述）
app_id	application id的简称，开发者创建应用后，支付宝分配给开发者的应用ID即应用身份标示，值为以日期开头的16位纯数字组成。一个账号(PID)可创建多个应用(APPID)。

 

机具设备接入IOT，总体会经历以下几个步骤组成：

2.1步骤：请见如何入驻开放平台获取PID和APP_ID

2.2步骤：请见如何让机具设备入驻蚂蚁物料平台

2.3步骤：请见IOT业务技术接入调试

2.4步骤：请见如何创建门店

2.5步骤：请见机具和设备如何绑定

2.6步骤：请见机具设备注册激活

2.7步骤：请见数据验证

2.8步骤：请见整机验收

 

2.1.  如何入驻开放平台获取PID和APP_ID

不管是设备提供商、ISV集成服务商，还是商户，都需要在开放平台签约注册企业支付宝账号，入驻开放平台，申请并获取支付宝分配的PID。PID会伴随整个业务过程，是蚂蚁金服用来唯一标识合作伙伴对象。具体签约联系对应的行业业务接口。

如果ISV需要小程序接入入驻支付宝开放平台，需要创建应用成为开发者获取分配的app_id，生成小程序信息。一个小程序APP对应一个app_id，一个ISV可以有多个小程序app_id。注意：调用IOT绑定接口的应用类型必须是网页或小程序类型，不能为第三方开发类型。

2.2.  如何让机具设备入驻蚂蚁物料平台

第一步：机具供应商联系支付宝人员获取《蚂蚁金服IOT设备信息录入模板》，完善相关信息及产品信息，并同时在邮件中提供如下几项信息一并提交到如下邮箱地址：iot_campus@service.alipay.com。

• 机具设备提供方公司名称
• 机具设备提供方和ISV集成服务商是否为一体
• 设备的操作系统、文件系统读写，以及能提供给支付宝SDK可运行的剩余内存（RAM）和存储（ROM）；

第二步：物料信息经过审核后生成产品类目定义，物料平台会分配支付宝内部定义的供应商id（supplier_sn）和物料id（item_id），供应商id用来唯一标识支付宝的供应商，物料id用来唯一标识定义的设备。分配的信息请合作方务必保存。

第三步：支付宝确定对接方案：统一SDK方式 或者 IOT云端接入方式。

2.3.  IOT业务技术接入调试（集成iot sdk、交易加签）

IOT 接入的对外开放指南已经在开放平台上线，内容会不定期跟新，具体集成和开发要求，详细参阅：

支付宝IoTSDK（厂商）集成指南   ：该指南适合于iot sdk集成接入方式，一定要确保现场环境能够有访问公网的网络。

IOT设备云云接入集成指南            ：该指南适合于云云接入方式，IOT云云对接API的接口需要联系支付宝人员授权。接口权限申请流程：合作方向业务BD提出申请，业务BD邮件发送到iot_campus@service.alipay.com。邮件内容需包括：ISV名称、ISV PID、ISV APPID（调用iot绑定接口的应用）、业务合作背景

具体的技术配合内容有：

• 如果方案采用集成iot SDK理方式，需要双方配合完成设备端SDK的开发、联调和出厂预置；如果方案确定采用IOT云端接入方式，需要双方配合完成ISV服务侧的开发、联调；
• 合作方配合完成行为数据埋点上报；
• 如果业务场景涉及支付收单，需要ISV服务集成商在收单接口（当面付、代扣等）上配合完成设备SDK生成的签名信息加签（统一SDK方式）或设备信息（IOT云端接入方式）等传参，具体请见收单传参说明；

2.5.  如何创建门店

ISV服务集成商登录开放平台，进入“运营中心 - 商家管理”，选择“我的商家门店”，代商家创建门店。对学校每一个摆放机具的场所进行精细化管理。将每个摆放机具的场所都可以当成一个门店来进行管理。

门店创建归则：

服务商进行过代签约或者第三方应用授权关系的商户，就是服务商的商户，都会出现在商户列表中。如果服务商拓展的商户是学校（跟学校合作），在创建门店时选择教育类目：教育-学校。如果服务商拓展的商户是餐饮公司（跟餐饮公司合作），则在创建门店时选择美食类目：美食-团餐。门店名称和地址需要按照下面的格式填写：门店名称的格式必须为：XX大学-XX食堂；门店备注地址处必须填写：XX大学、详细街道地址。

商户是ISV已经签约或获得授权的名下商家，需要在创建申请信息中提交授权资质证明和门店实景图片（门店外景、内景、档口）。

2.6.  机具和门店如何绑定

通过OpenApi接口完成绑定。无论是置入统一SDK方式，还是云端对接方式，设备和门店关系的绑定都通过云端OpenAPI接口完成。在接口参数中，需确保isv_id、shop_id、商户pid的准确性，确保业务政策能够正确返还到激励方。

绑定前提条件：需要在开放平台创建门店，获取shopid，见“如何创建门店”部分

如果需要解绑设备和门店的关系，调用同样该接口完成关系解绑。

接口说明请见：地址

调用绑定接口的应用要求：应用appid已上线，类型必须是网页或小程序类型，不能为第三方开发类型。

2.7.  机具设备注册激活

注册激活可以通过两种方式完成：

1. 集成IOT统一SDK的设备，在设备开机点亮联网的情况下，机具设备自助完成激活
2. 对于非集成IOT统一SDK的设备提供云端api方式，ISV服务侧通过OpenApi接口调用完成注册激活。

每个设备只需注册一次，通过统一SDK自助完成激活绑定流程示意如下：

通过ISV侧OpenApi完成激活绑定流程示意如下：

 

2.8.  数据验证

为确保数据和返佣的准确性，需要在实际环境下按照全流程完成门店创建、设备绑定、产生实际交易，通过后台监测交易数据和设备数据是否准确落入数据。

• 机具设备是否注册激活，注册激活方式是否正确
• 机具设备是否绑定，绑定信息是否正确
• 机具设备心跳是否正常
• 如果有交易，那机具设备交易加签和传参等信息是否正确
• 机具设备行为数据上传是否正常

在验证时，需要提供如下信息来完成验证。

在设备上产生三笔交易	支付宝交易号	机具SN	门店ID	是否正常
1
0.1
0.01

 

2.9.  整机验收

为保证最终正式上线商用设备的接入质量，需要从整机角度验收下设备的可靠性、安全性、稳定性。具体流程如下：

 

验收流程：

ISV自测 -> ISV向业务BD发起验收预约 -> 支付宝创建验收项目 -> 双方现场验收 -> 支付宝发布验收结论

验收所需材料：

• ISV验收人提供手机端登录支付宝APP的支付宝账号

创建验收项目后，在手机支付宝app下面，搜索“云验收”，执行验收任务。

                                                                                                    End                                                   

FAQ

关于此文档暂时还没有FAQ