Configuration Parameters - Nayax Developer Portal

The EMV Core configuration determines how your terminal functions, handles transactions, and interacts with external systems. Settings use a standard <Parameter Name>=<Value> format (e.g., TMS_SVC_URL=tms.otiglobal.com).

Managing Settings

Configuration is handled centrally through the Nayax Core server. To adjust these settings:

Navigate to Operations > Machines.
Locate the Embedded and Embedded Advanced sections.
Click the ? next to specific fields to identify which configuration parameters correspond to the options on the page.

Once saved, the server generates a configuration file and automatically pushes it to the device. The table below lists the primary configuration keys available for both platforms:

Category	Parameter Name	Description	Type	Default Value	Platform Notes
Network & System	`ETH_INTERFACE`	Network interface for reporting; autodetects if empty.	String	empty	Fallback to eth0.
	`KIOSK_USE_TCP_SOCKETS`	Set to 1 to use TCP ports 10000 (cmd) and 10001 (events).	Bool (1/0)	0	Disables domain sockets if set.
	`DAILY_RESTART_HOUR`	Automatic daily reboot hour (0-23); 0 is disabled.	U8	0	Reboot occurs within 30 minutes of the set hour.
	`KIOSK_TCP_LOCALHOST`	Limits EMV Core sockets to the localhost interface.	Bool (1/0)	0	Introduced in SDK v0.7.
TMS & Payment	`TMS_SVC_URL`	URL for Terminal Management System.	URL String	tms.otiglobal.com	Use tms-c.otiglobal.com for Nayax Core.
	`PAYMENT_SVC_URL`	URL for payment processing server.	URL String	payment-nayax-p.otiglobal.com	Max 256 characters.
	`SERVER_POLL_INTERVAL`	Seconds between calls to the server for updates.	U16	600	Low values increase data usage.
Reader Settings	`READER_IS_SERIAL`	0=USB, 1=Serial, 2=Auto-detect.	0/1/2	2	Removed in SDK v1.4; use `READER_SERIAL_PORT`.
	`READER_SERIAL_PORT`	Sets the actual port device (e.g., /dev/ttyS0).	String	None (USB)	Not supported in Android SDK.
	`CURRENCY_CODE`	ISO 4217 code (e.g., 840 for USD).	String	840	v1.4 takes this automatically from Nayax Core.
Open Loop Payment	`OPEN_LOOP_ENABLED`	Enables/Disables open-loop payment.	Bool (1/0)	1	Introduced in SDK v0.7.
	`PMT_ACCEPT_OFFLINE`	Automatically approves auth when network is down (Store & Forward).	Bool (1/0)	0	0=Disabled, 1=No comm, 2=Always.
	`PRE_AUTH_AMOUNT`	Default pre-authorization amount if not provided by API.	Int	0	Provided in cents.
Closed Loop (CLP)	`CLP_MIFARE_ENABLED`	Enables Mifare detection as a closed loop.	Int	2	0=Off, 1=Server approval, 2=Local Host API.
Logging	`LOG_FILE_SIZE`	Max size in KB for each log file.	Int	1024	Default was 256 KB before SDK v1.2.
	`LOG_NO_OF_FILES`	Number of log files kept before rotation.	Int	10	Default was 6 before SDK v1.2.

​Managing Settings

Managing Settings