智能机具平台解决方案
名词解释
| 名词 | 描述 |
| 开放平台 | 支付宝开放平台(open.alipay.com)，通过开放平台网关(openapi.alipay.com/gateway.do)提供开放api给第三方调用 |
| 合作伙伴 | 通过开放平台注册入驻蚂蚁合作伙伴，主要分三种角色（系统服务商ISV，线下服务商，自研开发者商户） |
| 服务商 | 主要分为线下服务商和系统服务商ISV，一般为系统服务商ISV，服务商可以为自己拓展的商户进行代签约，并通过开放平台管理拓展的商户，详见服务商-商户管理 |
| ISV | 基于机具厂商提供的硬件开发支付应用的系统服务商。如果机具厂商同时开发支付应用，则该厂商也是支付应用ISV。 |
| PID | partner_id的简称，合作伙伴身份，签约的支付宝账号对应的支付宝唯一用户号，以2088开头的16位纯数字组成。 请点此查看合作伙伴身份ID（PID）。 |
| APPID | application id的简称，开发者创建应用后，支付宝分配给开发者的应用ID即应用身份标示,值为以日期开头的16位纯数字组成。一个账号(PID)可创建多个应用(APPID)。 请点此查看应用列表(含APPID)。 |
| 机具厂商 | 提供机具硬件、生产机具硬件的厂商，机具厂商接入蚂蚁智能机具平台主要对接蚂蚁金服物料平台和机具SDK两个集成事项。 |
| 物流供应商(商户) | 负责物流的供应商，机具厂商再对接物料平台时，调用机具配送接口也可选自选物料。 |
| 物料平台 | 支付宝物料设计、生产、运输的信息平台. |
| 门店 | 服务商为商户代创建门店，对商户每一个摆放机具的场所进行精细化 详见门店管理（创建商户门店，只能为当前服务商下的商户创建门店，服务商和商户的绑定关系可见服务商一栏描述） |
| 机具SDK | 蚂蚁金服提供的用于进行机具管理的SDK，需要嵌入机具的操作系统内，目标是配合服务端完成机具设备的识别、激活、状态同步等功能。
|
业务介绍
蚂蚁金服智能机具平台可以提供机具全流程的管理能力，消除人肉统计机具信息的工作，在未来为机具提供统一的智能化运营平台。合作机具厂商可通过开放平台API接口打通蚂蚁金服物料平台能力，从而串联起机具申请、审批、生产、调拨和使用的全流程。ISV和服务商可自助在蚂蚁金服开放平台为自己拓展的商户申请机具。业务操作的主要角色为使用开放平台的ISV以及服务商（统一简称ISV），他们通过第三方应用授权或者代商户签约的方式进行商户拓展，对于满足行业需求的商户，ISV可以自助代商户操作机具的申请工作，而在申请机具之前，ISV需要帮助商户创建门店、申请机具、并且确定机具和门店的绑定关系，这样绑定过后，商户收到的机具就能确认是否是ISV为其申请的机具（机具每次开机时会发起激活指令，完成业务信息一致性的确认），并且机具交易的计算也有规可循（通过机具支付报文中的业务签名信息保证）。
准备工作
机具厂商
1、按照《机具供应商信息提交模板》和《物料模板配置表-机具》完善自己的信息，并邮件至相应支付宝业务经理并抄送机具业务邮件组<iot-biz@list.alibaba-inc.com>。
2、邮件说明系统版本、硬件平台处理器架构、并通过附件或下载链接提供交叉编译工具链，发送至机具sdk邮件组<iot-sdk@list.alibaba-inc.com>，用于进行支付宝机具SDK的适配工作。支付宝相关同学会邮件回复开发版SDK。
支付应用ISV
1、签约注册企业支付宝账号，入驻开放平台，进行当面付技术对接。
业务流程
一、业务合作
机具厂商通支付宝业务经理达成合作协议后，机具厂商可开始准备接入支付宝的机具管控平台，接入后再行投放生产进行交易。其中机具管控对接主要分三步：开发联调、预发验证、上线运营。若合作厂商之前有存量机具接入，由于存量机具已真实发货并投入运营，在对接上接口调用流程一致，仅部分区别，具体可集合存量机具接入方案来看。
二、开发联调
1、机具SDK的开发版联调：
a、机具厂商同支付宝BD业务经理达成协议后，需提供以下信息进行联调：
- 机具系统版本：android或Linux内核版本；
- 硬件平台：处理器架构，如armeabi-v7a、mips等
- 交叉编译工具链：对于Linux系统需以附件文件或下载URL形式提供工具链，工具链必须是linux版本且包含gcc和g++；
机具SDK和物料平台两者可并行开发联调。
三、上线前预发验证
预发验证即只能在生产环境上指定服务器上验证，所用数据包括APPID和密钥同生产环境一致。
1、机具厂商通支付宝业务商定好之后，机具厂商进行入驻蚂蚁合作伙伴，并创建应用，自行给创建的应用添加“第三方应用授权”功能。
见第2步提交 《机具供应商信息提交模板》时，需填些应用的APPID 用于支付宝给厂商开通"支付宝物料平台生产配送接口"功能进行预发验证和线上接口调用权限。
2、机具厂商通支付宝系统对接好之后，提供《机具供应商信息提交模板》和《物料模板配置表-机具》邮件至相应支付宝业务经理并抄送机具业务邮件组<iot-biz@list.alibaba-inc.com>。进行支付宝开放平台厂商机具信息录入展示，并反馈厂商各机具型号所对应的模板ID[即物料接口的item_id]。
3、机具厂商通过支付宝系统分配的线上机具模板ID以及厂商对应的线上机具SDK连接预发环境进行验证。
a.物料平台接口的验证，参考机具厂商接入指南将相关接口流程走完。
b.机具sdk的交易验证(机具激活，交易签名)，参考管控SDK接入指南 将相关接口流程走完。
c.预发环境服务请求预发网关地址为：https://openapipre.alipay.com/gateway.do(https://openapi.alipay.com/gateway.do是生产环境网关地址)
访问签需修改客户端服务器的hosts文件如下:
45.113.40.147 fuwu.alipay.com
45.113.40.147 appstore.alipay.com
45.113.40.147 myfw.alipay.com app.alipay.com play.koubei.com fuwu.koubei.com fw.alipay.com
45.113.40.147 openhome.alipay.com open.alipay.com ar.open.alipay.com wuye.open.alipay.com
45.113.40.147 a.alipayobjects.com as.alipayobjects.com gw.alipayobjects.com
45.113.40.147 luopan.alipay.com mdataprod.alipay.com
45.113.40.147 gw.alipayobjects.com as.alipayobjects.com a.alipayobjects.com
45.113.40.147 spcenter.alipay.com
103.52.199.48 openapipre.alipay.com
4、支付宝正式开启线上流量，供服务商ISV申请该厂商机具。
四、上线后流程
1、服务商ISV的支付系统同机具厂商的机具两方进行联调。
2、服务商同机具厂商联调通过后，服务商ISV可通过钉钉申请"机具申请系统白名单"，并通过开放平台为其商户完成当面付代签约、第三方应用授权、开门店、机具申请、机具门店绑定、正式投入机具进行交易。
整体技术接入流程
由于对接智能机具平台存在不同的角色，为方便合作伙伴对整体流程有所了解，我们按各角色的实际操作进行流程说明。系统对接按角色可分为机具厂商和支付应用ISV，机具厂商负责提供机具，支付应用ISV负责在机具上提供支付程序。如果一个机具厂商完全包办机具生产以及支付程序的开发和对接支付宝当面付的工作，那么他同时也是一个支付应用ISV。对于机具厂商，需要分别对接蚂蚁金服物料平台API接口（打通机具物料的生产、调拨等状态信息），对接智能机具SDK（在机具系统嵌入支付宝机具安全SDK，为上层应用暴露业务签名接口。目前支持Android和Linux版本）。完成上述对接后，机具就具备了生产、调拨的管理能力和开机确认机具门店绑定关系的基础。对于支付应用ISV，需要做的是在机具的基础上对接支付宝当面付产品，并按智能机具的业务要求获取业务签名信息，并通过支付接口上送至支付宝完成交易的业务信息校验。（即确认该笔交易是否由该商户下的该机具发起）
机具厂商
机具厂商至少需要进行两方面技术对接。对接物料平台，同步机具生产、调拨等状态管理信息；以及在机具中嵌入支付宝机具SDK，为使用机具的应用暴露SDK的业务签名接口，为后续将用户的付款码加签为业务签名做准备工作。这两部分对接工作可并行进行，对接物料平台API方案点此访问，对接机具SDK方案点此访问。
支付应用ISV
支付应用ISV需要基于机具厂商的设备开发能够完成支付宝当面付支付的应用。根据业务要求，ISV对接当面付条码支付接口时（alipay.trade.pay），需要根据机具暴露的业务签名接口，将每一笔用户付款码的信息进行业务加签，并且通过条码支付接口的terminal_params字段上传。点此访问详细方案
遇到问题
- 系统上线前遇到问题可通过如下方式优先寻求帮助：
- 系统上线正式运营后可通过如下渠道寻求售后保障帮助：
- 在线咨询：https://cschannel.alipay.com/newPortal.htm?scene=mt_zczx （注意输入partner或签约支付宝账号，进入大客户通道）
- 邮箱：techservices@alipay.com(工作日支持)
- 电话咨询：0571-88158090
相关文档
1、第三方应用授权（点击访问，当系统商帮商户开发系统对接支付宝，并且系统由系统商维护时，商户可通过第三方应用授权，将商户的支付宝账号权限授权给系统商进行当面付交易而无需向系统商提供账号密码）
2、第三方应用授权管理，商户可取消向ISV授权，会导致ISV无法使用商户授权进行当面付交易（慎用）
3、生成签名（点此访问）
4、公共错误码：（点击访问）基于法律法规、监管政策等原因，我公司有权采取变更或暂停接口使用、终止合作等措施。