Troubleshooting guide
SmartPOS
Initial setup & Activation
Problems that occur during the initial setup and activation of your terminal.
The "Devices" section is not visible in your Merchant Dashboard
If you cannot access Devices > Terminals from your dashboard, your user account may not have the required permissions.
You can:
- Check if your user has the correct permissions, or contact your administrator.
- Email [email protected] to contact us.
The MultiSafepay app is not visible on the terminal
The app has not been whitelisted for your device in the linked Sunmi account.
Please contact us at [email protected] to have the app whitelisted for your terminal.
"IPEK not configured" message appears
The Initial PIN Encrypted Key (IPEK) is not been registered on your terminal.
If your IPEK is not configured, try to configure it manually first:
- Go to your device's Android Settings > System.
- Go to Advanced > Security Center.
- Click Key Inject. Go to RKI and click Key Inject.
- Once the process finalizes, click Confirm.
If manual configuration fails:
- Email [email protected] for assistance.
Activation fails with "Server error (10008)"
This typically happens on the P3 MIX model if you try to activate it before it has fully connected to the network.
To fix this:
- Restart your terminal.
- Connect to a stable internet connection (Wi-Fi or cable).
- Wait for 3 minutes after the internet connection is established to allow the device to synchronize.
- Click Activate again.
Connection & Network
Issues related to your terminal's internet connection.
The internet connection is unstable or disconnected
Follow these steps:
- Check your router: Ensure your Wi-Fi router is on, connected to the internet, and the network is stable.
- Reconnect to Wi-Fi: If the terminal is disconnected, follow the steps to connect to Wi-Fi.
- Check the connection icon: If you are connected, check the color of the internet icon on your terminal's status bar.
Icon Color | Description |
---|---|
![]() | The network connection is good. |
![]() | The terminal isn't connected and isn't working correctly. |
Follow these additional steps:
- For P2 Smartpad: If you are using the connection cable, ensure it is securely plugged in and try again.
- Improve network connectivity: Move closer to your Wi-Fi router or restart the router.
Payment Processing Errors
Problems that occur when processing payments.
An order is placed, but it doesn't appear on the terminal
Check if:
- The terminal connected to the internet. See Connection and Network problems .
- You used the correct API key for your terminal group. See how to retrieve your API key.
A payment is declined
If a payment is declined, check the error message on the screen and find the solution below.
Error Message | Solution |
---|---|
Configuration error. Try again | Send a request to [email protected] |
Card not supported | Send a request to [email protected] |
Use a different interface | Ask the customer to insert their card instead of using contactless tap. |
1000 card declined | Email [email protected] to confirm your payment methods are configured correctly. |
Use Magstripe | Email [email protected] |
Additional Check: Ensure that you have not accidentally deactivated any card payment methods in your Merchant Dashboard.
Understanding "Soft Declines"
You may receive a "declined" status during a transaction. This is a soft decline. It occurs when a customer needs to take an extra step (like entering a PIN for a large amount).
You will first receive a declined
notification, but once the customer completes the action, you will receive a final status of completed
or cancelled
.
⚠️ Note: Do not treat a soft decline as a final payment status. Wait for a final completed
or cancelled
status.
Display and app behavior
Problems with how information is displayed on the screen or how apps are behaving.
The group logo is not being displayed
Try to:
- Go to Android Settings > Apps & Notifications.
- Select the MultiSafepay app.
- Go to Storage & cache and click Clear cache.
- Restart the app. If the logo is still not visible, email [email protected]
The on-screen keyboard is not working or shows the wrong layout
For SUNMI P2 SE - Manual Input:
The first time you use Manual Input, the wrong keyboard may appear:
- At the Manual Input screen, tap the small keyboard icon in the bottom corner.
- Choose the language you selected during device setup to switch to the numeric keypad.
For P2 Smartpad - On-screen keyboard is missing:
After a setup or reset, you may need to re-enable the keyboard:
- Tap any input field (e.g., the Order ID). A new keyboard icon will appear in the navigation bar.
- Tap the keyboard icon in the navigation bar.
- Enable the Show virtual keyboard toggle.
Google Chrome is not functioning properly
The version of Chrome may be incompatible after an update.
Follow these steps:
- Email [email protected] and describe the issue.
- In the meantime, you can Uninstall the Google Chrome app and reboot your device.
- We will contact Sunmi to request the latest compatible version for your terminal.
- We will notify you when the correct version is available for automatic installation.
Hardware
Issues related to the physical device.
POS Steward: Hardware diagnosis
If you are experiencing issues related to hardware malfunctioning, you can open the POS Steward application to initiate a hardware diagnosis.
Once you've opened the POS steward app, you can:
- Do a complete device test
- Check your device's specifications
- Under Special Function, choose one of the options to run a diagnosis for that specific component
System Alarms
A Tampering alarm is displayed
If your device is blocked and shows an error like "Attacked! Please contact your service provider" or "Alerts triggered! Please contact your service provider" this might be due to device being damaged (e.g. the terminal falls on the ground). Follow these steps, in case the errors are shown:
- Go to the Sunmi page go to Contact Technical Support > Create new request.
- Select P Serial Tamper and follow the steps. 💡 Tip! prepare a picture of your device to attach to the form.
- Depending of the error code,Sunmi will provide a code to unblock your device.
The device will reboot and be ready for use.
If the alarm reappears shortly after, a sensor may be damaged. Email [email protected]
Advanced Troubleshooting
These steps should only be performed if you are an advanced user or have been instructed to do so by our support team.
How to Set a Device to Developer Mode
⚠️ Warning: This action is irreversible and will make the device non-PCI compliant. Do not proceed unless you are certain this is required.
- Request a TUSN code from Sunmi. This 4-digit code is valid for 24 hours.
- On the terminal, navigate to Settings > System > About.
- Scroll down and tap the TUSN button 8 times.
- Enter the 4-digit code provided by Sunmi.
How to Retrieve System Logs
Providing logs helps us diagnose issues faster.
- Go to your Sunmi portal: Device > Log task management.
- Click New task.
- Select syslog and add the serial number(s) of the affected terminal(s).
- Define a timeframe for the log capture. The start time must be later than the current time.
- During this timeframe, replicate the issue on the terminal.
- Click Release.
Returning your terminal
⚠️ Note: Only return a terminal if you have been instructed to do so by our support team.
Reasons for return may include:
- Broken display, keyboard, printer, or scanner
- Battery or power failure
- Persistent hardware or network failures
- Account closure or wrong terminal ordered
Required details
To help us resolve your issue as quickly as possible, please have the following information ready:
- Your MultiSafepay account ID.
- The terminal's serial number.
- A clear description of the issue and the steps you have already taken.
- A reason for return.
- Pictures or a video of the issue, if possible.
- Support ticket reference (e.g. 172349).
Email these details to [email protected]
Traditional (CTAP) terminal
Activation
The "Devices" section is not visible in your Merchant Dashboard
Your user account may not have the required permissions.
Try to:
- Check if your user has the correct permissions, or contact your administrator.
- Email [email protected] to contact us.
Connection and Network
The internet connection is unstable or disconnected
Follow these steps:
- Check your router: Ensure your Wi-Fi router is on, connected to the internet, and the network is stable.
- Reconnect to Wi-Fi: If the terminal is disconnected, follow the steps to connect to your Wi-Fi network.
Payment errors
If you are experiencing any issues related to payment processing, check if:
- The terminal connected to the internet. See Connection and Network.
- Your terminal is activated in your Merchant Dashboard. See Activation.
Contact your provider
If your issue is related to hardware malfunctioning or if you can't find a solution in our troubleshooting page, contact your provider for further assistance.
Support
Contact us if you haven't been able to solve your issue.
How to contact support and what details to provideEmail the following details to [email protected]:
Field Required
Description
MID
Your MultiSafepay account ID and name.
Terminal ID
The ID of your terminal or terminal group of the affected terminals.
Serial Number
The device's serial number. Ideally, also include the model (e.g., Sunmi) or provider (e.g., CTAP).
POS Type
Specify the terminal type and details:
- CTAP: Your terminal provider.
- SmartPOS: Model, solution (e.g. Cloud payments, App to app, Web to app), and app features configuration (e.g. Close timeout, cloud mode).
Area of Issue
Describe the category of the problem (e.g., Processing errors, Hardware issue, Notifications, Payment creation).
Issue Start Date
State when the issue began (e.g., From first setup, Since a specific date/time).
Scope
Specify the number of terminals affected (e.g., A single device, The whole fleet). Note if other devices are working correctly.
Example Transaction
If a transaction was generated, provide the PSP ID.
Visual Evidence
Attach any type of evidence (photo or video) of the issue, where applicable.
Updated about 10 hours ago