操作指南

1

基础信息相关接口

通过接口获取一卡通的人员信息，卡信息，组织架构、账户信息（第三方业务系从一卡通拉取用户信息，包含账号、卡介质、账户状态等相关信息）

2

设备与商户同步接口

通过接口将支付交易设备与商户信息同步到一卡通

3

用户账户信息查询接口

通过接口获取一卡通用户的用户信息、状态信息、余额信息等，主要用于支付交易设备联机认证。

4

消费记录上传接口

将支付交易设备上传的消费记录上传到一卡通中进行一卡通扣费

6

对账文件获取

通过FTP从一卡通下载对账文件进行消费明细对账

7

一卡通读卡信息关资料

提供读取一卡通卡信息相关卡规范，读卡协议相关等资料

8

三方付二维码支付接口

由第三方业务对接三方付（微信、支付宝）支付，上传三方付二维码信息到一卡通完成交易申请

9

三方付订单查询接口

由第三方业务对接三方付时，传第三方交易流水号或二维码查询订单状态

10

三方付订单退款接口

该接口主要是由第三方业务对接三方付时，传第三方交易流水号完成退款操作

11

推送商户信息

由第三方业务系推送商户信息至一卡通

12

推送设备信息

由第三方业务系推送设备信息至一卡通，推送后自动绑定商户

13

二维码解码接口

身份识别场景下对二维码图像进行解码，将其中的信息转化为计算机可识别的文本格式

14

设备接入物联网安全接口

提供设备登录、登出、设备接入密钥交换、设备安全认证

15

物联网设备状态监控接口

提供通讯心跳检测、协议检测以及设备协议控制

16

物联网OTA升级接口

提供在线升级、设备自定义、升级时间自定义等 能力

17

    查询人员人脸照片信息

向人脸平台发送请求，根据传入的人员信息，要求获取该人员的显示照片、识别照片等信息；

18

三方核身应用接入类接口

三方核身类应用系统(门禁系统、安防系统等)作为子应用接入到校园出入管理系统，由校园出入管理系统进行统一的授权分配和数据查看等。接口包含：名单变动消息、提供业务状态、查询增量授权名单、提供核身记录、提供设备列表

19

三方核身设备接入联机认证接口

设备开启联机认证功能时，当有人员在终端发起核身时，三方设备通过该接口发起请求，根据接口返回的通行建议决定是否允许其通行。

20

查询通行记录接口

三方系统根据该接口，查询校园出入管理系统中的人员核身成功的记录(不包含无权限开门的记录)。

21

请假业务对接接口

三方请假系统，通过该接口进行对接。

请在请假完全审批通过之后将请假结果进行推送形成授权名单，不需要请假系统的审批过程数据。