Skip to main content
Verify your hardware and build requirements, install the reader firmware, and obtain the Device ID needed for terminal registration.

Requirements

Hardware

Your setup requires the following hardware:

Network Requirements

The host platform must support IPv4 TCP networking with the following characteristics:
  • IPv4 TCP sockets only
  • Up to 3 sockets in parallel
  • DNS resolution
  • Network status indication
  • Client only (no server functionality needed)
  • Low latency of sending and receiving packets (up to 10 ms)
  • Socket usage:
    • 1 constantly open socket exchanging small amounts of data (Keep-alive) every 2–30 minutes. May receive data at any moment.
    • 2 short-lived sockets (few seconds, one or more request/response cycles), which may work in parallel.
    • Download of 1.5 MB at a time; upload of ~1 MB at a time, through a single socket in chunks of 1.5 KB.

Transport Layer

  • The channel between EMV Core and Host is either a Serial or a USB channel.
  • Messages should be sent without breaks between the bytes (RS-232/TTL) or blocks (USB).
  • A break in the sequence indicates message completion. A break is defined as 11 ETU on RS-232/TTL:
    • 1.15 ms at 9600 BAUD
    • 0.1 ms at 115200 BAUD

Build System

The host sample code requires:
Use the sample host implementation included with the SDK rather than writing one from scratch.

SDK Delivery

The SDK package is organized into three top-level folders:

EMV Core Communication Protocols

The EMV Core FW running on the UNO Reader automatically adapts to two protocols based on the host application:
When switching from one protocol to another, you must restart the UNO Reader.

Firmware Installation on UNO-mini

EMV Core Installation

The EMV Core module is provided with the UNO Reader firmware.
  • First-time installation is performed using the UNO-8 Manager.
  • Future updates may be done remotely using the Nayax Terminal Management System (TMS).
The firmware file (EMVSC_v0xxxxx.oef) can be found in the SDK Firmware and Configuration\Reader Firmware folder.
The Reader must be registered to the Nayax Core system. If it is not registered, you will not be able to complete payment transactions. To register your device, provide its Device ID (Reader serial number) to your Nayax account manager.

Getting a Device ID

The Kiosk ID is the Reader Serial Number (SN). Obtain it by: a) Reading the SN from the back of the reader: scan the barcode to prevent errors. b) Using the EMV Core Test application on Linux:
  1. Run the Linux test application.
  2. Select option 8 and press Enter to display the Device ID.
Keep a record of your Device ID. You will need to provide it to your Nayax account manager for terminal registration before processing live transactions.