智能终端MIS接入
最近更新时间：2022.12.27
本文档主要描述了汇付数据智能POS同外部设备对接的规范，其中对接方式主要为蓝牙通讯和局域网通讯。
接入流程
开发机申请
开始接入前，需申请联调开发测试终端，所有联调均在生产环境进行调试。业务方联系对应汇付业务对接人员，汇付业务会内部申请专用联调开发机提供给对接方。联调开发机中会有明确图标表示为开发机，仅开发机可自行安装app进行调试且开发机不可用于真实商户收款。
联调开发机中必须装有"MIS通讯"应用，如果没有安装可自行在应用商店中进行下载。
测试商户
终端调试需使用调试商户，生产环境联调中，客户可自行准备生产环境测试商户。如客户无法准备测试商户，可咨询相关运营协助提供开发联调商户。
接入流程图
总体思路如下： 外部设备根据自身设备情况选择通讯方式，并打开汇付智能POS的"MIS通讯"相应服务，外部设备在需要调用收银的时候通过选用的通讯方式向"MIS通讯"发送数据命令，并在命令任务完成之后向外部设备返回任务结果。
接入说明
通讯方式说明
| 通讯方式 | 说明 | 优点 | 缺点 |
|---|---|---|---|
| 传统蓝牙 | 需要先进行配对，配对成功之后进行蓝牙socket通讯 | 对接简单，蓝牙地址固定 | 不支持IOS设备，通讯距离短且穿墙能力弱 |
| 低功耗蓝牙 | 搜索POS的虚拟蓝牙地址，连接虚拟地址，然后搜索虚拟读写服务，通过读写服务发送接收数据 | 支持IOS设备，通讯安全 | 不支持Android4.0以下设备，通讯距离短且穿墙能力弱 |
| 局域网 | 简单理解为同一路由器下的两个设备通讯 | 对接简单，无设备限制 | 网络环境要求较高 |
| 云消息 | 通过IOT进行消息中转 | 对接简单，无设备限制，无终端网络限制 | 交易结果无法同步返回 |
通讯参数配置
传统蓝牙
配置 通讯UUIID 为
String STR_UUID = "00001101-0000-1000-8000-00805F9B34FB";低功耗蓝牙
配置 服务UUID 为
UUID SERVER_UUID = UUID.fromString("F14581B6-7938-45BA-A8E8-4CF5F6DEB648");
ParcelUuid SERVER_PARCE_UUID = ParcelUuid.fromString("F14581B6-7938-45BA-A8E8-4CF5F6DEB648");配置 写特征UUID 为
UUID MIS_RECEIVE_UUID = UUID.fromString("49535343-1E4D-4BD9-BA61-23C647249616");配置 读特征UUID 为
UUID MIS_SEND_UUID = UUID.fromString("49535343-8841-43F4-A8D4-ECBE34729BB3");由于低功耗蓝牙通讯数据长度有限制，固需要对通讯数据打包为byte数组，设置单次数据通讯字节长度为20。
打包规则： [0x02],[数组长度HEX高位],[数组长度HEX低位]…[0x03],[lrc]
局域网
智能POS设置开启 ServerSocket 端口 为 6000
云消息
按照MIS设备通信接口组装参数并调用接口唤醒POS进行交易。
API接口汇总
以下为调用的api接口汇总。
MIS设备通信接口
| 接口名称 | 描述 |
|---|---|
| MIS设备通信 | 调用该接口唤醒POS进行交易。 |
支付类接口
| 接口名称 | 描述 |
|---|---|
| 消费 | 该接口用于三方app调用发起消费收款，支持银行卡、反扫、正扫聚合支付。 |
| 消费撤销 | 该接口用于三方app调用发起消费撤销。 |
| 消费退款 | 该接口用于三方app调用发起消费退款。 |
| 花呗分期 | 该接口用于三方app调用发起花呗分期交易，支持支付宝花呗分期。 |
| 预授权 | 接口用于三方app调用银行卡预授权交易，银行卡预授权交易仅冻结用户资金。 |
| 预授权撤销 | 该接口用于三方app调用银行卡预授权撤销交易。 |
| 预授权完成 | 该接口用于三方app调用银行卡预授权完成交易。 |
| 预授权完成撤销 | 该接口用于三方app调用银行卡预授权完成撤销交易。 |
管理类接口
| 接口名称 | 描述 |
|---|---|
| 操作员登录 | 该接口用于三方app调用操作员登录，将商户和终端绑定。 |
| 商户号登录 | 该接口用于三方app调用商户号登录，将商户和终端绑定。 |
| 注销 | 该接口用于三方app退出登录，进行操作员切换。 |
| 获取商户信息 | 该接口用于三方app获取当前使用商户相关信息。 |
| 补打签购单 | 该接口用于三方APP调用收银台，补打印历史交易的签购单。 |
| 换班 | 该接口提供三方app调用换班功能，提供换班相关操作数据。 |
| 设置 | 该接口提供三方app调用设置功能。 |
数据类接口
| 接口名称 | 描述 |
|---|---|
| 查询明细 | 该接口用于三方app调用，查询历史交易信息。 |
| 日对账单 | 该接口提供三方app查询日对账单。 |
| 交易列表查询 | 该接口提供三方app查询交易列表。 |
| 余额查询 | 该接口提供查询银行卡余额功能。 |
| AT预授权交易列表查询 | 该接口提供三方app查询AT预授权交易列表。 |
| AT预授权明细查询 | 该接口提供AT预授权交易查询，返回交易详情。 |
通知类接口
| 接口名称 | 描述 |
|---|---|
| 交易结果异步通知 | 该接口提供三方平台接收交易结果异步通知。 |
