硬件合作模式有三种:合作方自有硬件接入、合作方基于海马S1(商米FT1 MINI)接入、合作方基于第三方硬件接入。根据合作模式不同,接入的要求、内容和步骤会有差别。
1).合作方基于自有硬件或第三方硬件接入
具体接入步骤,请见邻客蚁上对应合作方的项目空间上的产品文档:《刷脸团餐设备开发指南 V 1.0》
支付宝内部文档链接:https://linkant.alipay.com/100/document#nm8i9w
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传参标准说明(消费、核身场景传参要求,与返佣有关,请合作伙伴认真校对)
分类 |
传参需求 |
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随人脸特征加载到机具 |