EMV Core Android & Linux SDK Release Notes

Nayax logs EMV Core Android & Linux SDK changes on this page as they ship. Subscribe to the RSS feed to get notified of new entries. To find the feed, add /rss.xml to the end of this page’s URL. Release notes are organized into three categories to help you evaluate the impact of each update:

Improvements: New API commands, expanded platform and card support, and performance enhancements.
Fixes: Resolved bugs and reliability improvements.
Known Issues: Current limitations or pending features, with recommended workarounds.

Platform-Specific FeaturesWhile most updates are universal, platform-specific improvements or fixes are marked with (Android Only) or (Linux Only) in the section titles.

This version includes the following improvements, fixes, and known issues for the SDK:

Improvements

1-Step Incremental Authorization (Android Only) (#7462)

Settling a transaction for more than its pre-authorized amount now automatically triggers an incremental authorization for the difference. See Single-step incremental authorization. This release also adds the IncrementalAuthorization method and IncrementalAuthorizationResponse callback, reserved for a future multi-step flow and not required for the single-step behavior above.

Deferred Transaction (#7486)

The terminal can now keep accepting payments while offline and send them for approval once communication is restored. Set isDeferred and isFinalAmount in PreAuthorize to use it. This replaces the deprecated PMT_ACCEPT_OFFLINE configuration attribute. See Deferred Transaction for details.

Offline by Default Mode (#7604)

EMV Core’s defaults changed so it behaves as a simple, offline-capable RFID reader out of the box: CLP_MIFARE_ENABLED now defaults to 2 (local Closed-Loop Mifare) and OPEN_LOOP_ENABLED now defaults to 0 (disabled). In this default configuration, GetStatus reports Ready and PreAuthorize/GetCardToken keep working even without network. The device only requires network, and reports NoNetwork when it’s down, if you explicitly enable Open Loop or set CLP_MIFARE_ENABLED=1.

External Settlement Support in the Client Library (#7430)

The client library now parses and exposes the fields required for server-to-server settlement.

Push Notifications via MQTT (#6817)

EMV Core now supports MQTT push notifications. To use this feature, configure the MQTT Primary Address (oti-broker.nayax.com:1883) and Ping Interval (default 600 seconds) machine attributes in Nayax Core.

Currency Fallback from the Reader (#7654)

If CURRENCY_CODE is missing from the configuration, EMV Core now falls back to the reader’s kernel currency tag (9F3C) before defaulting to USD.

AUDIO_PERCENTAGE Configuration (#7609)

Added the AUDIO_PERCENTAGE configuration attribute to control the reader’s audio volume.

Terminal Authentication over TLS (#6719, #7305)

Terminal Authentication (DSS) GET /challenge requests are now sent over TLS.

additionalReceiptData in PreAuthorize and ConfirmTransaction (#7377)

You can now pass additionalReceiptData directly in PreAuthorize and ConfirmTransaction to include extra data in the eReceipt.

Local Firmware and Configuration Update Utility (#7372)

Added a utility to update reader firmware and configuration locally without a TMS connection. This is intended for production-line use only. Remove it before deployment.

Advanced Closed Loop Card Support (#7639)

EMV Core can now read Mifare blocks using the CLP_MIFARE_READ attribute.

SendToReader (Android Only) (#6898)

Host applications can now send commands directly to the reader with the new SendToReader method.

Reader Configuration Management from Nayax Core (#7250)

Reader configuration can now be managed from Nayax Core machine attributes.

Process Info in UPLOAD_LOG (#7300)

UPLOAD_LOG now includes process information: CPU, memory, and uptime.

Felica IDm as CLP UID (#7496)

FeliCa’s IDm is now returned as the CLP UID.

Unconditional Confirmation (#7594)

Removed the CONFIRM_IF_UNSURE flag. Confirmation behavior is now unconditional.

Client Library Version Reporting (#7673)

The client library version is now reported to TMS via GetVersions.

Nayax TLS CA Support (#7703)

Added support for the Nayax TLS certificate authority.

Hardcoded External Settlement Defaults (#7705)

External Settlement properties are now hardcoded defaults, removing the dependency on local.properties.

Foreground Service (#7712)

The EMV Core service now runs in the foreground, preventing the OS from killing it.

New UNO-mini Firmware (EMVSC_v071749)

Adds Type B card reading support (for Autel). This firmware is valid for the Linux, Android, and RTOS v1.5 SDKs. RTOS v1.0 should continue using firmware EMVSC_v071652.oef.

Fixes

ReaderMessageEvent Index Correction (#7088)

Messages that previously used index 255 now use the correct assigned indexes in the 201-220 range.

Reader Communication Recovery (#6819)

Improved reader communication recovery, including handling of reader power cycles.

External Settlement Response Missing hwSerial (#7515)

The External Settlement response was missing the hwSerial field.

Push Notifications on TMS-C (#7537)

Fixed push notifications not working when the device is managed by TMS-C (Nayax Core).

CLP Card ID Response Fields (#7425)

Fixed the CLP Card ID being sent in the wrong response fields.

Local CLP Transaction and Card ID (#7512)

Fixed the Transaction ID and Card ID (CardToken) being identical on Local CLP transactions.

Transaction Fee Reporting (#7478)

Fixed transaction fees not being sent correctly to the Bridge.

PMT_DUKPT_KEY_VARIANT Fallback (#6772)

PMT_DUKPT_KEY_VARIANT now falls back to 0x11 when the configured value is invalid.

Automatic Restart with No Reader (#7183)

EMV Core now restarts automatically if it doesn’t find a reader within 1 hour.

IncrementalAuthorization URL (Android Only) (#7662)

Fixed an incorrect URL used by IncrementalAuthorization.

Configuration Preserved Across APK Upgrades (#7491)

Configuration was previously deleted when the APK was updated. It’s now preserved across upgrades.

hwSerial Truncation (#7710)

Fixed hwSerial being truncated in NayaxTransactionIdInfo.

Large Receipt Data Buffer Overflow (#7763)

Fixed a buffer overflow that could crash or reset the device when large receipt or terminal data combined with transaction result data.

Truncated Server Responses (#7783)

Fixed truncated or rejected server responses that could report a valid approval as declined, or drop a TMS-pushed command.

Continuous Polling Interruption (#7217)

Fixed polling stopping in the middle of a continuous=true transaction.

CON_CONFIG and Service Restart (#7452, #7701)

Fixed the CON_CONFIG command failing, and the Android service sometimes not restarting after that command.

GetStatus Stuck at Update (#7740)

Fixed GetStatus remaining stuck at Update for 5 or more minutes after a firmware flash.

Duplicate Authorize Requests

Reduced duplicate Authorize requests sent after a timeout or cancellation.

Known issues

Reader Swap Terminal ID (#7211, #7030)

Always stop EMV Core before moving a reader to a different machine. Swapping a reader without resetting EMV Core doesn’t update the Terminal ID, and payment may complete against the previous terminal. Moving a reader to a different machine without first stopping EMV Core on the original machine may also cause unpredictable behavior on the new machine.

Android OS Service Restarts (#7714)

The Android OS may stop the EMV Core service, causing multiple restarts during operation.

IsTransactionApproved on Cancelled Transactions (#7743)

A cancelled transaction incorrectly returns IsTransactionApproved as true.

Cancellation After CannotCancel (#7742)

A transaction may still be cancelled after receiving a CannotCancel response.

GetStatus with Ethernet Disabled (#7741)

GetStatus returns Ready even when Ethernet is disabled.

Version history

Every earlier Android & Linux SDK version, condensed to one line. See the current version above for full detail and links.

Version	Summary
SDK Version 1.4	Added (#7473, #7474, #7308): Automated currency code management Nayax Core/OTI TMS server failover Local serial port management (Linux) Fixed (#7443, #7497): Reader message event delivery and reader reconnection Sample app token reporting and sample app resources
SDK Version 1.2	Added (#6782, #7139, #7346, #7269, #6888): eReceipt/Remote Settlement support Nayax Core-managed attribute/limit control and CLP cards Enhanced logging Fixed (#7385, #7371, #7199, #7272): Offline display sync and reader-boot/core-invocation issues Deprecated `PayTransaction` in favor of `PreAuthorize`/`ConfirmTransaction`
SDK Version 1.1 (Linux Only)	Shipped (#6813, #7165, #7157): Official UNO-8 firmware v54227 Beta UNO-mini firmware v071514 Fixed (#7144, #7331): Serial reader stability TMS independence A socket resource leak
SDK Version 1.0	Added (#71156, #7129, #7117): `GetAttribute` Enhanced Android logging and config reporting Linux sample app improvements Fixed (#6960, #7136, #7091, #7169, #7180, #6658, #7200, #7204, #7130, #7210): Log truncation CLP card mapping Timing/sync issues Android diagnostics/UI bugs
SDK Version 0.9	Added (#6550, #6838, #6978): Mifare UID support to `GetCardToken` Automatic EMV Core startup/recovery `GetCardToken` continuous mode on Android Fixed (#6980, #6987, #7001, #6961, #6658): Closed-loop UID reporting UI/input stability UNO-mini firmware events Pre-authorization logic
SDK Version 0.8	Added: `GetCardToken` with continuous polling Expanded CLP/Vicinity card support Offline CLP UID retrieval Fixed (#6550, #6919, #6938, #6862): A crash with no internet connection A `Void`-after-`PreAuthorize` bug TMS/reader connectivity A Linux serial-port config bug
SDK Version 0.7	First official Android SDK release. Added: Linux configuration attributes (`OPEN_LOOP_ENABLED`, `PRE_AUTH_AMOUNT`, `KIOSK_TCP_LOCALHOST`) `GetAttribute()` retrieval Switched Linux to internal sockets by default Fixed TMS production-info retrieval (#6705)
SDK Version 0.6.03 (Linux Only)	Improved: UART stability Closed-loop Mifare support (Ultralight, 7-byte UIDs) Fixed a config-parsing crash on empty lines Confirmed sequential `PreAuthorize` rejection is intentional (#6560, #6576)
SDK Version 0.6.00 (Linux Only)	Introduced foundational Closed Loop Mifare support
SDK Version 0.1 (Linux Only)	First Lite SDK release for Linux, built in C for low-resource embedded environments

​1-Step Incremental Authorization (Android Only) (#7462)

​Deferred Transaction (#7486)

​Offline by Default Mode (#7604)

​External Settlement Support in the Client Library (#7430)

​Push Notifications via MQTT (#6817)

​Currency Fallback from the Reader (#7654)

​AUDIO_PERCENTAGE Configuration (#7609)

​Terminal Authentication over TLS (#6719, #7305)

​additionalReceiptData in PreAuthorize and ConfirmTransaction (#7377)

​Local Firmware and Configuration Update Utility (#7372)

​Advanced Closed Loop Card Support (#7639)

​SendToReader (Android Only) (#6898)

​Reader Configuration Management from Nayax Core (#7250)

​Process Info in UPLOAD_LOG (#7300)

​Felica IDm as CLP UID (#7496)

​Unconditional Confirmation (#7594)

​Client Library Version Reporting (#7673)

​Nayax TLS CA Support (#7703)

​Hardcoded External Settlement Defaults (#7705)

​Foreground Service (#7712)

​New UNO-mini Firmware (EMVSC_v071749)

​ReaderMessageEvent Index Correction (#7088)

​Reader Communication Recovery (#6819)

​External Settlement Response Missing hwSerial (#7515)

​Push Notifications on TMS-C (#7537)

​CLP Card ID Response Fields (#7425)

​Local CLP Transaction and Card ID (#7512)

​Transaction Fee Reporting (#7478)

​PMT_DUKPT_KEY_VARIANT Fallback (#6772)

​Automatic Restart with No Reader (#7183)

​IncrementalAuthorization URL (Android Only) (#7662)

​Configuration Preserved Across APK Upgrades (#7491)

​hwSerial Truncation (#7710)

​Large Receipt Data Buffer Overflow (#7763)

​Truncated Server Responses (#7783)

​Continuous Polling Interruption (#7217)

​CON_CONFIG and Service Restart (#7452, #7701)

​GetStatus Stuck at Update (#7740)

​Duplicate Authorize Requests

​Reader Swap Terminal ID (#7211, #7030)

​Android OS Service Restarts (#7714)

​IsTransactionApproved on Cancelled Transactions (#7743)

​Cancellation After CannotCancel (#7742)

​GetStatus with Ethernet Disabled (#7741)

​Version history

1-Step Incremental Authorization (Android Only) (#7462)

Deferred Transaction (#7486)

Offline by Default Mode (#7604)

External Settlement Support in the Client Library (#7430)

Push Notifications via MQTT (#6817)

Currency Fallback from the Reader (#7654)

AUDIO_PERCENTAGE Configuration (#7609)

Terminal Authentication over TLS (#6719, #7305)

additionalReceiptData in PreAuthorize and ConfirmTransaction (#7377)

Local Firmware and Configuration Update Utility (#7372)

Advanced Closed Loop Card Support (#7639)

SendToReader (Android Only) (#6898)

Reader Configuration Management from Nayax Core (#7250)

Process Info in UPLOAD_LOG (#7300)

Felica IDm as CLP UID (#7496)

Unconditional Confirmation (#7594)

Client Library Version Reporting (#7673)

Nayax TLS CA Support (#7703)

Hardcoded External Settlement Defaults (#7705)

Foreground Service (#7712)

New UNO-mini Firmware (EMVSC_v071749)

ReaderMessageEvent Index Correction (#7088)

Reader Communication Recovery (#6819)

External Settlement Response Missing hwSerial (#7515)

Push Notifications on TMS-C (#7537)

CLP Card ID Response Fields (#7425)

Local CLP Transaction and Card ID (#7512)

Transaction Fee Reporting (#7478)

PMT_DUKPT_KEY_VARIANT Fallback (#6772)

Automatic Restart with No Reader (#7183)

IncrementalAuthorization URL (Android Only) (#7662)

Configuration Preserved Across APK Upgrades (#7491)

hwSerial Truncation (#7710)

Large Receipt Data Buffer Overflow (#7763)

Truncated Server Responses (#7783)

Continuous Polling Interruption (#7217)

CON_CONFIG and Service Restart (#7452, #7701)

GetStatus Stuck at Update (#7740)

Duplicate Authorize Requests

Reader Swap Terminal ID (#7211, #7030)

Android OS Service Restarts (#7714)

IsTransactionApproved on Cancelled Transactions (#7743)

Cancellation After CannotCancel (#7742)

GetStatus with Ethernet Disabled (#7741)

Version history