GMC串口MIS接入

约 1961 字大约 7 分钟

View as Markdown

2025-12-09

概述

GMC串口MIS接入方案为SAAS收银机厂商提供了一种高效的支付集成方式,通过串口与POS设备直接通信,无需网络连接即可完成支付交易。

适用场景

线下零售收银系统
SAAS收银机厂商
POS设备集成
离线/半离线支付场景

核心功能

支持功能

下单支付 - 创建订单并完成支付
交易退款 - 对已完成的交易进行退款
交易查询 - 查询交易状态和详情
心跳检测 - 保持设备连接状态
重打印 - 重新打印交易小票
结算 - 批量结算功能

接入前提

在开始集成之前,请确保满足以下条件:

POS设备要求
- POS设备已集成GMC串口通信协议
- 支持标准串口通信(RS-232/USB转串口)
技术能力要求
- SAAS系统具备串口通信能力
- 支持Java/Python/C++等语言的串口库
- 具备SHA256签名实现能力，详见签名规约
商户资质
- 已获取商户在PingPong系统的 accId 和 clientId
- 已完成商户入驻流程

注意事项

请妥善保管商户凭证信息,避免泄露造成安全风险。

串口通信协议

通信参数配置

串口通信需与POS设备约定一致的参数配置：

参数	默认值	说明
波特率	115200	通信速率
数据位	8	数据位数
停止位	1	停止位数(1=1位,2=2位)
校验位	0	校验方式(0=无,1=奇,2=偶)

报文帧结构

串口通信采用自定义帧结构，格式如下：

[帧头(2B)] + [数据长度(2B)] + [数据报文] + [校验位(1B)] + [帧尾(2B)]

字段名称	长度(字节)	取值规则
帧头	2	固定为 `0xAA 0x55`
数据长度	2	0~65535,表示数据报文的字节数,采用大端模式存储
数据报文	0~65535	上层业务数据JSON字符串
校验位	1	数据报文所有字节的异或(XOR)结果
帧尾	2	固定为 `0x55 0xAA`

报文示例

以下是退款请求的串口十六进制报文示例：

AA 55 01 A4 7B 22 61 63 63 49 64 22 3A 22 31 30 30 30 30 31 22 ... 33 55 AA

解析后的JSON数据：

{
  "accId": "100001",
  "clientId": "POS_12345",
  "event": "REFUND",
  "signType": "SHA256",
  "version": "1.0",
  "requestTime": "1760754805426",
  "sign": "BAEA4D56D885D6BD449BFFA2D9F117ECEDA662C85197A19050CA0C18CC64B871",
  "bizContent": "{...}"
}

提示

📌 sign 字段为请求签名，计算规则详见签名规约

帧构建提示

先将JSON数据转换为UTF-8字节数组
计算字节数组长度,转为2字节大端格式
计算所有数据字节的异或值作为校验位
按帧结构顺序拼接完整报文

交互流程

支付流程步骤

SAAS发起支付请求
SAAS收银系统通过串口向POS设备发送支付请求，请求报文需使用SHA256签名保证数据安全（签名规约）。
调用接口：GMC串口支付接口
POS报文处理
POS设备接收串口数据，解析报文并验证签名，提取业务参数。
POS转发支付请求
POS设备将支付请求转发至PingPong服务端进行处理。
PingPong处理支付请求
PingPong服务端验证商户信息、处理支付路由、执行风控检查。
POS执行交易
POS设备根据PingPong服务端指令执行刷卡、插卡或扫码等交易操作。
POS上报支付结果
交易完成后，POS设备将支付结果上报至PingPong服务端。
SAAS查询支付结果
SAAS收银系统通过串口向POS设备查询支付结果，获取交易状态和详情。
调用接口：GMC串口查询接口

退款流程步骤

SAAS发起退款请求
SAAS收银系统通过串口向POS设备发送退款请求，需提供原支付订单号和退款金额。
调用接口：GMC串口退款接口
POS报文处理
POS设备接收串口数据，解析报文并验证签名，校验退款参数。
POS转发退款请求
POS设备将退款请求转发至PingPong服务端进行处理。
PingPong处理退款请求
PingPong服务端验证原订单信息、检查可退款金额、执行退款处理。
POS执行退款
POS设备根据PingPong服务端指令执行退款操作。
POS上报退款结果
退款完成后，POS设备将退款结果上报至PingPong服务端。
SAAS查询退款结果
SAAS收银系统通过串口向POS设备查询退款结果，确认退款状态。
调用接口：GMC串口查询接口

相关接口

接口名称	EVENT	说明	链接
GMC串口心跳接口	`HEARTBEAT`	保持SAAS与POS设备连接状态	查看文档
GMC串口支付接口	`PAY`	创建支付订单并完成交易	查看文档
GMC串口交易查询接口	`PAY_QUERY`	查询支付交易状态和详情	查看文档
GMC串口退款接口	`REFUND`	对已完成的交易发起退款	查看文档
GMC串口退款查询接口	`REFUND_QUERY`	查询退款交易状态和详情	查看文档
GMC串口交易取消接口	`TRANSACTION_CANCEL`	取消进行中的交易	查看文档
GMC串口重打印接口	`REPRINT`	重新打印交易小票凭证	查看文档
GMC串口结算接口	`CALCULATE`	触发POS设备批量结算	查看文档