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:

1. Go to your device's Android Settings > System.
2. Go to Advanced > Security Center.
3. Click Key Inject. Go to RKI and click Key Inject.
4. 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:

1. Restart your terminal.
2. Connect to a stable internet connection (Wi-Fi or cable).
3. Wait for 3 minutes after the internet connection is established to allow the device to synchronize.
4. Click Activate again.

---

Connection & Network

Issues related to your terminal's internet connection.

The internet connection is unstable or disconnected

Follow these steps:

1. Check your router: Ensure your Wi-Fi router is on, connected to the internet, and the network is stable.
2. Reconnect to Wi-Fi: If the terminal is disconnected, follow the steps to connect to Wi-Fi.
3. Check the connection icon: If you are connected, check the color of the internet icon on your terminal's status bar.

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.

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:

1. Go to Android Settings > Apps & Notifications.
2. Select the MultiSafepay app.
3. Go to Storage & cache and click Clear cache.
4. 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:

1. At the Manual Input screen, tap the small keyboard icon in the bottom corner.
2. 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:

1. Tap any input field (e.g., the Order ID). A new keyboard icon will appear in the navigation bar.
2. Tap the keyboard icon in the navigation bar.
3. 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:

1. Email [email protected] and describe the issue.
2. In the meantime, you can Uninstall the Google Chrome app and reboot your device.
3. We will contact Sunmi to request the latest compatible version for your terminal.
4. 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:

1. Go to the Sunmi page go to Contact Technical Support > Create new request.
2. Select P Serial Tamper and follow the steps. 💡 Tip! prepare a picture of your device to attach to the form.
3. 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.

1. Request a TUSN code from Sunmi. This 4-digit code is valid for 24 hours.
2. On the terminal, navigate to Settings > System > About.
3. Scroll down and tap the TUSN button 8 times.
4. Enter the 4-digit code provided by Sunmi.

How to Retrieve System Logs

Providing logs helps us diagnose issues faster.

1. Go to your Sunmi portal: Device > Log task management.
2. Click New task.
3. Select syslog and add the serial number(s) of the affected terminal(s).
4. Define a timeframe for the log capture. The start time must be later than the current time.
5. During this timeframe, replicate the issue on the terminal.
6. 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:

1. Check your router: Ensure your Wi-Fi router is on, connected to the internet, and the network is stable.
2. 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 provide

Email 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).
Issue Details	Provide a clear description of the issue, including: • Steps taken before and after the issue • Error shown on the terminal • Observable terminal behavior (e.g., frozen, restarting, unresponsive) • Does it happens on one terminal or multiple
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.

---