Configuration File Reference

Configuration parameters are managed centrally from Nayax Core and may vary by customer and machine.

Location

Configuration files are saved on the reader file system in the E:\ETC folder.

Format

<Parameter Name>=<Value>

Example: TMS_SVC_URL=tms.otiglobal.com

Managing Settings

Configuration is managed centrally through Nayax Core. To adjust settings:

Navigate to Operations > Machines.
Locate the Embedded and Embedded Advanced sections.
Update the relevant attributes and press Save. The server generates a configuration file and pushes it to the device automatically.

Network & System Settings

These parameters control network interface selection and system-level behavior:

Parameter	Description	Type	Default	Since Ver.
`ETH_INTERFACE`	Network interface; empty = autodetect with fallback to eth0	String	empty	—
`KIOSK_USE_TCP_SOCKETS`	Use TCP ports 10000 (commands) and 10001 (events) instead of domain sockets	Bool (1/0)	0	—
`DAILY_RESTART_HOUR`	Hour for automatic daily reboot (0–23, 0 = disabled). Actual reboot within 30 min of set hour.	U8	0	—
`CONFIG_VERSION`	Version of the config file; sent to TMS, not used by the device	String	—	—
`KIOSK_TCP_LOCALHOST`	Limit EMV Core sockets to localhost interface	Bool (1/0)	0	0.7

TMS & Payment Service Settings

These parameters configure the URLs and polling behavior for the TMS and payment server:

Parameter	Description	Type	Default	Since Ver.
`TMS_SVC_URL`	URL of TMS service. Use `tms.otiglobal.com` for OTI TMS or `tms-c.otiglobal.com` for Nayax Core.	URL String	tms.otiglobal.com	0.7 / 1.0
`PAYMENT_SVC_URL`	Payment server URL, name only (e.g., `payment-nayax-p.otiglobal.com`)	URL String (max 256)	empty	—
`SERVER_POLL_INTERVAL`	Seconds between server calls for updates. Lower value = better responsiveness but more data usage.	U16	600	—

Parameter	Description	Type	Default	Since Ver.
`INIT_CMD`	Commands to send to the Saturn Reader on initialization. Hex strings of TLV tags, separated by `\|`. Example: `DF0A0100\|DF7A0100`	Hex strings	empty	—
`STOP_BUTTON_ID`	ID of the STOP/CANCEL button: 1 = Right, 2 = Left	U8	1	—
`STOP_BUTTON_LED_PRESENT`	0 = disable button blinking (if LED is not on the STOP button)	Bool (1/0)	1	—
`R_COUNTRY_CODE`	Sets the Terminal Country Code value in the reader. v1.0 takes it from Nayax Core machine country.	String (4 chars)	N/A	0.7 / 1.0
`R_DO`	Sends DO commands to the reader on device start. Executed only once, unlike `INIT_CMD`. Multiple `R_DO` lines are all executed.	Hex string	N/A	—
`R_MSG_X_Y`	Sets reader message (index X, line Y) when the device starts	ASCII string	N/A	—

Security Settings

These parameters control SSL and encryption settings for server connections:

Parameter	Description	Type	Default	Since Ver.
`TMS_USE_SSL`	Switch SSL for TMS service on or off	Bool (1/0)	0	—
`PMT_DUKPT_KEY_VARIANT`	DUKPT key variant depending on PSP. Use decimal format (e.g., 17 decimal = 0x11). Set to 0 to disable DUKPT (testing only).	U8	17	—
`PAYMENT_SVC_USE_SSL`	Switch SSL for payment service on or off	Bool (1/0)	—	—

Open Loop Payment Settings

These parameters control open-loop (credit/debit) payment behavior, timeouts, and authorization flow:

Parameter	Description	Type	Default	Since Ver.
`PMT_ACCEPT_OFFLINE`	Store & Forward: automatically approve when network is unavailable. Note: Risk of unapproved transactions; operator responsibility.	Bool (1/0)	0	—
`PMT_KIOSK_AUTOCONFIRM`	Automatically confirms with pre-auth amount if session is interrupted. Supports long sessions with possible resets (e.g., EV chargers).	Bool (1/0)	1	—
`PMT_CONFIRMATION_INTERVAL`	Seconds between attempts to execute pending Confirm or Void operations	U32	5	—
`PAYMENT_SVC_SERVER_RETRIES`	How many times online authorization will be retried on error	Int	3	—
`PAYMENT_SVC_SERVER_TIMEOUT`	HTTP timeout for payment server requests (seconds)	Int	20	—
`PAYMENT_SVC_CONFIRM_TIMEOUT`	Server timeout when sending Confirm or Void requests (seconds)	U32	60	—
`PAYMENT_SVC_USER_WAITING_MAX_TIME`	Max waiting time for online authorization (seconds)	U16	30	—
`MAESTRO_LIMIT_CENTS`	Transactions above this limit with Maestro card will be declined without fallback	U32	2500	—
`PAYMENT_SVC_SYNCHRONOUS`	Wait for the current transaction to close on the server before starting a new one. Note: for asynchronous mode after an unexpected reset, also set `PMT_KIOSK_AUTOCONFIRM=0`.	Bool (1/0)	0	—
`OPEN_LOOP_ENABLED`	Enable/disable open-loop payment	Bool (1/0)	1	0.7
`PRE_AUTH_AMOUNT`	Default pre-authorization amount in cents if no amount is provided by the API	Int	0	0.7
`CURRENCY_CODE`	ISO 4217 code (e.g., 840 = USD). v1.0 takes it from Nayax Core automatically after any machine attribute change or ‘Reload configuration’ action.	String	840	0.7 / 1.0

Closed-Loop Payment Settings

These parameters enable and configure closed-loop (prepaid) card support, including Mifare:

Parameter	Description	Type	Default	Since Ver.
`CLP_PROPRIATARY_TRACKS_ENABLED`	Enable detection of proprietary tracks as Closed Loop during EMV payment. Requires proper reader configuration.	Bool (1/0)	0	—
`CLP_MIFARE_READ`	Specify Mifare blocks to read. Format: `K[A	B][key_num]B[block_num],…`Example:`KA01B10B14,KB05B20B30`	String	—	—
`CLP_MIFARE_ENABLED`	Enable Mifare cards as Closed Loop during payment. 0 = disabled; 1 = enabled via server; 2 = enabled via local host API (UID returned immediately in `TransactionComplete`).	Int	0	0.7

Logging Settings

These parameters control log file size, retention, and per-module verbosity:

Parameter	Description	Type	Default	Since Ver.
`LOG_HOURS_TO_UPLOAD`	Hours of logs to include in UPLOAD_LOG command	U16	10	—
`LOG_NO_OF_FILES`	Number of log files kept. Oldest file is overridden when all reach `LOG_FILE_SIZE`.	Int	6	—
`LOG_FILE_SIZE`	Max size in KB of each log file	Int	256	—
`LOG_GLOBAL`	Default log level for all modules (1–5)	1–5	3	—
`LOG_READER`	Log level for Reader	1–5	3	—
`LOG_ETH`	Log level for Ethernet (errors only; use LOG_NET for data)	1–5	3	—
`LOG_NET`	Log level for oT_Net (network)	1–5	3	—
`LOG_SYSTEM`	Log level for SYSTEM or common functions	1–5	3	—
`LOG_APP_3`	Log level for Open Loop	1–5	3	—
`LOG_APP_4`	Log level for TMS	1–5	3	—
`LOG_USBH2`	Log level for USB Host	1–5	3	—

Reader Message Customization

These parameters customize the text displayed on the Saturn Reader for various states:

Parameter	Description	Type	Default
`SAT_MSG_DECLINED1`	Line 1 of “Declined” message	String (16)	—
`SAT_MSG_DECLINED2`	Line 2 of “Declined” message	String (16)	—
`SAT_MSG_ERROR1`	Line 1 of “Error” message	String (16)	—
`SAT_MSG_ERROR2`	Line 2 of “Error” message	String (16)	—
`SAT_MSG_CARD_NOT_RECOGNIZED1`	Line 1, used by Closed-Loop Payment	String (16)	Card not
`SAT_MSG_CARD_NOT_RECOGNIZED2`	Line 2, used by Closed-Loop Payment	String (16)	recognized
`SAT_MSG_CLP_AUTHORIZING1`	Line 1, used by Closed-Loop Payment	String (16)	Authorizing…
`SAT_MSG_CLP_APPROVED1`	Line 1, used by Closed-Loop Payment	String (16)	Approved
`SAT_MSG_CLP_APPROVED2`	Line 2, used by Closed-Loop Payment	String (16)	Balance:
`SAT_MSG_SWIPE_ALL1`	Message for retrying transaction in all channels	String (16)	Insert or Swipe
`SAT_MSG_SWIPE_ALL2`	—	String (16)	Or Change Card
`SAT_MSG_DEFAULT_MSGSWIPE1`	Message for retrying transaction via Mag Stripe	String (16)	Please Swipe
`SAT_MSG_DEFAULT_MSGSWIPE2`	—	String (16)	Card

EMV Core Guides

Android & Linux SDK

RTOS SDK

UNO-mini Hardware

Release Notes

Location

Format

Managing Settings

Network & System Settings

TMS & Payment Service Settings

Reader Settings

Security Settings

Open Loop Payment Settings

Closed-Loop Payment Settings

Logging Settings

Reader Message Customization

​Location

​Format

​Managing Settings

​Network & System Settings

​TMS & Payment Service Settings

​Reader Settings

​Security Settings

​Open Loop Payment Settings

​Closed-Loop Payment Settings

​Logging Settings

​Reader Message Customization

Location

Format

Managing Settings

Network & System Settings

TMS & Payment Service Settings

Reader Settings

Security Settings

Open Loop Payment Settings

Closed-Loop Payment Settings

Logging Settings

Reader Message Customization