跳转到主要内容

连接与协议

VPOS 系统充当 TCP/IP 服务器, 使用 5050 端口。您的系统(POS/FCC)充当客户端,必须主动发起连接。通信通过持久套接字进行双向通信。
单连接规则该终端仅支持一个活动连接;新的套接字连接尝试将自动关闭之前的连接。该协议采用命令-响应模式。所有客户端命令都必须包含 requestId,终端会在其响应中回传该 ID,以便于交易跟踪。

TCP消息格式

为确保数据完整性,通过 TCP 套接字发送的每条消息(包括命令和响应)都必须使用一个两字节长度的前缀。这可以准确地告诉接收方,数据流中接下来有多少字节的 JSON 数据。

编码示例

对于像 {"command":"pay","amount":5000} 这样的 JSON 命令(总计 30 字节): 二进制表示:
大端序(网络顺序)长度前缀与最高有效字节 (MSB) 一起首先发送。