Skip to content

Synqpay SDK - DeviceManager Submodule

The DeviceManager submodule provides additional device management functionality for controlling specific features of the payment device.

Methods

void enableKioskMode(boolean enable)

Enables or disables kiosk mode on the device.
Usage:

  • When enabled, this mode locks the bottom navigation bar and the top screen panel (notification/status bar), restricting access to system controls and preventing the user from exiting the application.
  • When disabled, the device returns to normal behavior.

Note: On devices with on-screen navigation bars, toggling kiosk mode may cause the current activity to be recreated due to changes in screen size or layout.

String getSerialNumber()

Retrieves the device's serial number.
Returns:
A string representing the unique serial number (SN) of the device.

void checkForSoftwareUpdate()

Initiates a software update check on the device.
Usage:

  • This method starts a loading UI and checks for available software updates.
  • If updates are found, they will be automatically installed.
  • If the invoking application is updated during this process, it will be terminated.

Best Practice: Listen for the system broadcast ACTION_MY_PACKAGE_REPLACED to handle application updates gracefully. For more information, see the Android documentation.

void uninstallPackage(String packageName)

Uninstalls a specified package from the device.
Parameters:

  • packageName - A String representing the package name of the application to uninstall.

Usage:
This method removes the specified package from the device. Ensure the package name is valid and that the application has the necessary permissions to perform uninstallation.