- 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
Improvements
Automated Currency Code Management (#7473)
The SDK now sets the currency code automatically from the Nayax Core. The host application no longer needs to set it manually.Server Connectivity and Automatic Failover (#7474)
The EMV Core now automatically attempts connections to both the Nayax Core (tms-c.otiglobal.com) and the OTI TMS (tms.otiglobal.com). You can omit the TMS_SVC_URL attribute from your configuration when migrating a device from OTI TMS management to the Nayax Core system.Local Serial Port Management (#7308) (Linux Only)
Host applications can now manage the reader serial port locally through a configuration file located at/etc/oti_kiosk/init.cfg. By defining the READER_SERIAL_PORT attribute (e.g., READER_SERIAL_PORT=/dev/ttyS0), the SDK can pinpoint the hardware interface immediately.Fixes
Fixes
Event Delivery and Reader Stability (#7443, #7497)
Fixed an intermittent issue whereReaderMessageEvent would stop arriving at the host application. Additionally, we resolved a connectivity bug where the EMV Core was unable to reconnect to a serial reader following a POS firmware update.Sample Application Token Reporting (Linux Only)
Fixed a logic error in the Sample application that prevented card tokens from being returned in theTransactionComplete event for open-loop cards.Sample Application Resources (Android Only)
Fixed an issue in the previous distribution where incorrect sample application source files were included. The SDK v1.4 package now contains the verified and updated source code.Known issues
Known issues
Offline Acceptance Limitation (#6918)
ThePMT_ACCEPT_OFFLINE command currently only functions for DEMO purposes. Transactions processed under this flag are not yet sent to the server and will remain local to the device until a future update.Terminal ID Update Delay (#7211, #7030)
If you swap readers without manually resetting the EMV Core, the Terminal ID will not update. Reset the EMV Core whenever you replace hardware to ensure the correct terminal identity is registered.Authorizing Status Event (#7510)
There is a known intermittent issue where the EMV Core may fail to send theReaderMessageEvent with index 36 (“Authorizing”). Applications should handle the transaction flow even if this specific status update is missing.