In order to use Softpay on any given device it is important to ensure the following key setup requirements are covered:
Enable accurate Date & Time 🕒 ✅
Ensure automatic time settings are enabled. Misaligned clocks can disrupt secure transactions and cause signature validation to fail.Enable Camera & Scanner permission 📷 ✅
To ensure that cameras do not interfere with the transaction process, the app requires access to cameras in order to validate that they are not used by other processes.Disable Screen Overlays 🪟 ❌
Overlays (such as chat heads or third-party UI modifications) can interfere with NFC prompts and the app interface. These must be fully disabled.Disable Battery Optimization 🔋 ❌
Power-saving features (including Doze and App Standby) may restrict network access or background operations. These should be turned off for the Softpay app.Disable Developer Options & USB Debugging 🛠️ ❌
For security and PCI compliance, the device must not have active developer settings, especially USB debugging, which can expose the system to unauthorized access.Disable Android management of App permissions 🔒 ❌
Android may remove permissions to start the app from a POS or for the app to receive notifications about new transactions. To avoid this, please disable Android from managing the app when unused.
Enable accurate Date & Time 🕒 ✅
The Softpay backend will verify the date and time for any transaction attempt and will not allow transactions where these values do not match the expected local time.
Following the steps below will help ensure the device is setup using the correct date and time.
Open Settings on the Android device.
Scroll down and tap System (or General Management, depending on the device).
Tap Date & Time.
Enable the following options:
"Use network-provided time" or "Automatic date & time"
"Use network-provided time zone" or "Automatic time zone"
If the device uses manually-set time or time zone the time can drift or be incorrect, which may result in time skew related errors and declines.
Enable Camera & Scanner permission 📷 ✅
For security reasons, the Softpay App has logic for handling device camera or built-in scanner functionality, which is especially relevant on Enterprise devices such as Sunmi, Imin, and similar table POS devices.
Be especially aware of this in regards to the device camera settings and permissions:
In the Tap view and PIN view, Softpay will block the use of the camera or scanner to avoid accidental or unwanted interference during the transaction flow.
Because of this, barcode scans or camera activity may be suppressed while you are in those views
As an optional App setting, you can provide camera permission to the Softpay App, which should increase its success of handling this gracefully. Try this if you experience excessive canceled transactions.
How to grant camera permission to the Softpay:
Long-press the Softpay app icon → select App info.
Tap Permissions.
Tap Camera
Ensure this is set to "Allow only while using the app"
Disable Screen Overlays 🪟 ❌
Overlays are strictly forbidden when sensitive information is being shared. If an app overlay is detected when using Softpay, the payment will be aborted during any input of sensitive data such as a PIN code. If a payment is aborted as soon as the screen is touched during PIN entry, that is a clear indicator that an overlay has been detected by Android.
To ensure this does not happen, the following steps should be taken to verify no apps are allowed to draw over Softpay.
Open Settings.
Go to Apps & notifications (or just Apps, depending on the device).
Tap Special app access.
Tap Display over other apps.
On some devices, this might be under:
Advanced > Special app access
Apps > Special access > Appear on top
You will see a list of apps with permission to draw over other apps.
Disable "Allow display over other apps" for any apps that don’t need it — especially apps like:
Chat heads (e.g., Facebook Messenger)
Screen dimming or filtering apps
Floating tools or utility apps
Pop-up managers
Screen readers or other accessibility related apps
Pre-installed security suites
Disable Battery Optimization 🔋 ❌
If the Softpay app is not prioritized by the OS power settings this can result in too large a gap between the required regular security checks the app need to carry out. If this happens transactions might fail and at worst the device might get blocked.
In order to prevent this it is recommended to set unrestricted access for the Softpay app in the device settings.
An example of how to do this for a Samsung Galaxy phone is as follows:
On your Galaxy device running One UI 5 or later, head to the settings.
Find the tap Apps.
Find the app you want to change battery optimization for (Softpay).
In that page, tap Battery.
Change from Optimized to Unrestricted.
Doing these steps ensures Softpay can operate in the background without interference, which ensures the required security checks can be carried out continuously.
Disable Developer Options & USB Debugging 🛠️ ❌
For security, compliance, and stability, the Softpay app requires that Developer Options and USB Debugging are fully disabled on the device.
Transactions will not be allowed using the Softpay app if either Developer Options or USB Debugging are detected and will result in any attempt to be instantly aborted.
The following steps explains how to ensure Developer Options and USB Debugging are disabled:
Open Settings on the Android device
Navigate to Settings > System > Developer Options
(or use search: "Developer Options")Scroll down and toggle off "USB Debugging". This setting allows ADB (Android Debug Bridge) access.
Toggle must be OFF, even if Developer Options are going to be disabled next.
Go back and disable Developer Options
Note: Even if Developer Options are turned off, USB Debugging may remain active — this is critical to check.
To confirm this has been done correctly return to Settings > About phone > Build number
Tap Build Number several times to re-enable Developer Options (if needed)
Confirm that USB Debugging remains off by checking inside the re-enabled Developer Options
Note: USB Debugging can often be programmatically disabled via device policies (Android Enterprise or EMM).
Disable Android management of App permissions 🔒 ❌
Android has a feature called “Manage app if unused” (also known as “Remove permissions and free up space”).
When enabled, the system may remove app permissions or clear temporary data if the app hasn’t been used for several months.
This can cause loss of permissions or data that are required for Softpay to function correctly.
For POS integrations, Android may remove permissions to open Softpay from the POS and/or block notifications for the app.
To keep Softpay working reliably, this feature should be disabled.
Long-press the Softpay app icon → select App info.
Tap Permissions.
Scroll down and disable Remove permissions and free up space (Manage app if unused).
Confirm the settings is now disabled.
In the event that Android has already removed permissions, starting the app manually by tapping the icon should start the app and reestablish permissions.