Skip to main content
Nayax EMV Core SDK 支持多种基于 Linux 的平台。每个交付版本均包含针对特定 CPU 架构和库版本优化的二进制文件。
下表列出了所有受支持的 Linux 平台:

软件包内容

每个平台文件夹均包含四个主要组件:
  • otiKiosk:主要的 EMV Core 服务可执行文件。
  • otiKioskDemo:客户端测试应用程序可执行文件。
  • kiosk-client-library-xxx.zip:包含 C 源代码和示例应用程序的 Eclipse 项目。
  • otikiosk-xxx.zip:用于通过 TMS 进行远程更新的软件包(使用 CON_PROG 命令)。
软件包目录结构如下:

安装

适用于 Linux 的 EMV Core SDK 提供了一组 API,用于通过 Unix 域套接字或 TCP 控制支付流程。它支持多种架构,包括 x86_64 和各种 ARM 平台。

先决条件与环境

在部署 SDK 之前,请确认以下要求:
  • 系统依赖项:需要 libcurl 以支持 TLS 1.2 或更高版本的安全互联网访问。
  • 权限:运行该服务的用户必须对可执行文件所在文件夹及读卡器设备(例如 USB 对应的 /dev/hidrawX 或串口对应的 /dev/ttyXXX)具有读写权限。
  • 架构:请确保为目标平台使用正确的二进制文件(例如 Ubuntu x86_64、armhf 或 armv8a)。

安装步骤

  1. 将 EMV Core 二进制文件(otiKiosk)复制到目标设备。请注意,不得重命名该文件。
  2. 构建示例应用程序:
    • 安装构建基础工具:sudo apt-get install build-essential automake。
    • 解压源代码压缩文件(例如 Emv-Core-client-x86_64-1.4-97.zip)。
    • 在源代码文件夹中运行以下命令:
  3. 运行应用程序:
    • 终端 1:使用 sudo ./otiKiosk 启动 EMV Core 服务。
    • 终端 2:使用 sudo ./otiKioskDemo 启动测试应用程序。
通信配置默认情况下,SDK 使用内部(Unix 域)套接字,在应用程序的 /var 文件夹中创建 socket_cmd 和 socket_events。如果您更倾向使用 TCP 通信,请设置配置选项 KIOSK_USE_TCP_SOCKETS=1。这将使用端口 10000 传输命令,使用端口 10001 传输事件。