For the complete documentation index, see llms.txt. This page is also available as Markdown.
How do I set up my Terminal device?
Before you can start accepting card payments, you need to configure your SUNMI device and connect it to a card reader. This guide walks you through the full setup.
Step 1: Connect to Wi-Fi
Open the Settings app on your SUNMI device.
Tap Network & internet.
Enable Wi-Fi and select your network.
Step 2: Set the correct date and time
An incorrect date or time can cause payment errors. Make sure this is accurate before you start.
Open the Settings app.
Tap System, then Date & time.
Set the date and time to match the current local time.
Step 3: Enable Bluetooth and NFC
This step applies to SUNMI V2S devices with a built-in NFC reader. You can identify an NFC-capable device by the tap icon near the top of the device.
Open the Settings app.
Tap Connected devices, then Connection preferences.
Tap NFC and turn the toggle on.
Tap Bluetooth and turn the toggle on.
Step 4: Connect a card reader
Oddle Terminal supports two card reader options.
Option A: NFC reader (SUNMI V2S only)
The built-in NFC reader is the simplest option — no extra hardware needed.
Open the Oddle Terminal app and go to Settings.
Tap Reader.
Select Use NFC reader on this device.
Option B: Wisepad3 via Bluetooth
Open the Oddle Terminal app and go to Settings.
Tap Reader.
Select Via Bluetooth. The app will scan for nearby devices.
Tap your Wisepad3 once it appears in the list.
Option C: Wisepad3 via USB
Open the Oddle Terminal app and go to Settings.
Tap Reader.
Select Via USB. The app will scan for nearby devices.
Connect the SUNMI device to the Wisepad3 using a USB cable.
Tap your Wisepad3 once it appears in the list.
Troubleshooting NFC connection errors
If you see any of the following errors when connecting to the NFC reader, follow the steps below:
Could not connect to Stripe. Please retry.
ATTESTATION_FAILURE: This reader is no longer supported.
API_CONNECTION_ERROR (null)
To resolve these errors:
Open Settings on your SUNMI device.
Tap Apps and Notifications.
Find and tap Oddle Terminal.
Tap Storage and Cache, then select Clear Storage.
Confirm by tapping Yes.
Reopen the Oddle Terminal app.
If you still need a new device code to reconnect the NFC reader, contact our support team at help.oddle.me.
