Settings
SmartOn POS Android App — Settings
A tour of every section in the app's Settings screen: payment terminal selection, printers, device and terminal modes, secondary display, device information, and the USB scale. To print on a receipt printer plugged into the device's USB port, see Connect a USB printer.
Changing some settings requires an app restart — if so, tapping Back to Main shows a 5-second countdown before the app restarts automatically to apply the change.
Payment Terminal
Select which payment terminal integration the app should use, and configure options specific to it.
- Terminal Provider — choose the payment integration installed on this device.
- Enable EPS PAY — only shown for DejaMobile, Swedbank, and SEB POS, which share the EPS Pay broadcast integration.
Provider-specific setup (activating the terminal app itself, linking it in the SmartOn admin panel, etc.) is covered in each integration's own guide:
Printer
Enable the printer driver that matches the device's built-in printer, and set the receipt paper width.
- Sunmi / Telpo / iMin / Landi / R330 / Pax / ZCS — each toggle enables printing through that specific built-in printer SDK. Enable only the one matching the device's hardware.
- Paper Width — 58 mm or 80 mm, matching the receipt paper actually loaded.
- Network Printer Settings — opens a separate screen where you add receipt printers on the local network or plugged into the device's USB port. See Connect a USB printer.
- Configure Cloud Printer (BLE) — sets up a Caysn cloud printer, such as the TCK837, over Bluetooth.
Device Mode
Use only as fiscal device restricts the app to fiscal-register duty only, loading fiscal.lt instead of the normal POS interface for the configured domain. Leave this off for a standard till.
Terminal Mode
Turns the device into a card terminal for a POS that runs on another device, such as a computer or a second tablet. When the app starts, it connects to your Smarton domain, skips the domain screen and doesn’t open the POS. It only shows a waiting screen and takes the card payments the POS sends to it.
- Terminal Mode (1) — turns the mode on or off. The change needs an app restart: when you tap Back to Main, the app restarts after a short countdown.
- Terminal Domain (2) — enter only the first part of your Smarton address, for example
kasafor kasa.smarton.app. If you leave it empty, the domain screen still opens: enter the domain there, and the app shows the waiting screen instead of the POS. If you later change only the domain, restart the app for the change to take effect.
Before you use the device as a terminal:
- Set up the card payment app on this device in Payment Terminal and link the device in Smarton, as described in your provider’s guide. The link uses this device’s Client ID (see Device Information).
- In Smarton, choose this terminal in the Payment terminal field of the cash register or receipt printer the POS prints on. See Printers and cash registers.
While Terminal Mode is on, Use only as fiscal device has no effect. To open Settings again, tap the SmartOn logo on the waiting screen 5 times, then the wrench.
Secondary Display
Shows order details to the customer on a second, customer-facing screen.
- Enable Secondary Display — turns the customer display on or off.
- Secondary Display URL — the address the second screen should load (for example a URL pointing at the customer-facing display page).
Device Information
Identifies this specific device and lets you send its details to SmartOn support.
- Client ID — this device's unique identifier. This is the device ID referenced in the payment terminal setup guides above.
- Send — emails this device's information (Client ID, app version, Android version, device model, configured payment terminal, printer width, secondary display status) to SmartOn support — useful when reporting an issue.
- QR code — expand to show the Client ID as a scannable QR code.
USB Scale
Reads item weight from a connected USB scale directly into the POS.
- Enable USB Scale toggle — requires an app restart to take effect.
- Scale model — choose the connected scale's model (CAS PDN or Q1-W).
- Test Scale (Read Weight) — connects to the scale immediately and shows live weight readings, without leaving the Settings screen.
Connect a USB printer
A receipt or kitchen printer can be plugged straight into the Android device's USB port. Smarton sends each print job over the internet to an MQTT topic, a channel name you choose. The SmartOn POS app listens on that topic and passes the job to the printer over the cable. You enter the same topic in two places: in the app (step 1) and on the printer in Smarton (step 2).
- The printer must understand ESC/POS commands. Most USB receipt printers do.
- Connect it with a USB cable. If the device has only a USB-C port, use a USB-C OTG adapter.
- The device needs an internet connection to receive print jobs. The app keeps listening while it runs in the background. After the device restarts, open SmartOn POS once so it starts listening again.
devices/kasa-receipt-7f3k/printing (your Smarton address, the printer’s place and a few random characters). Give each printer its own topic.Step 1. Add the printer in the app
- Plug the printer into the device and switch it on.
- Open Settings, expand Printer and tap Network Printer Settings.
- Tap Add USB Printer (1). The Select USB Device list shows everything plugged into the USB port, with each device’s name and its VID and PID numbers. Tap the printer. If the app says No USB devices connected, check the cable and that the printer is on.
- In the Add USB Printer window, check the Printer name (2). The app fills in the printer’s model; change it to a name staff recognise. Enter the MQTT topic (3). Leave Star Micronics (StarXpand SDK) (4) unticked: it has no effect on USB printers. Tap Save (5).
- Android asks whether SmartOn POS may access the printer. Tap OK. If you tap Cancel, the app shows USB printer permission denied — printing may fail. Tap the printer’s test print icon to be asked again.
- Turn on Enable Network Printer Agent (6). The status changes from STOPPED to RUNNING (7), and Android shows a Network Printer Agent notification while the app is listening.
- Tap the green printer icon (8). A TEST PRINT slip comes out with the printer’s name, VID, PID and topic. This test goes straight over the cable; it doesn’t check the connection to Smarton. Step 2 does.
Each configured printer has three icons:
- Green printer — prints the test slip.
- Pencil — changes the name or topic. The printer itself can’t be changed: to use another USB printer, remove this one and add the new one.
- Red bin — removes the printer at once, without asking.
The app finds the printer by its VID and PID, so it keeps working if you plug it into another USB port. Two printers of the same model can’t both be used over USB on one device, because they have the same VID and PID. Add Network Printer and Scan Network for Printers add a printer by IP address on the local network; it is reached through the same agent, with its own topic.
Step 2. Add the printer in Smarton
- In Smarton, open Settings → Integrations, tab Devices, and click +.
- Choose the Class UniversalPosPrinter (1).
- Enter a Name (2). Staff see this name when they choose a printer in the POS.
- Leave Printer with local IP (3) unticked. When it is ticked, Smarton doesn’t send the job to the topic.
- IP and Port (4) must be filled in, but they aren’t used when a topic is set. Leave the default values.
- LineLength (5) is the number of characters per line: 48 for 80 mm paper, usually 32 for 58 mm paper.
- Scroll down and enter the Mqtt topic (6), exactly as in the app. Capital letters matter, and there must be no spaces.
- Click Create (7).
- Open the printer again with its edit icon and click Test printer (8). A test page prints on the USB printer within a few seconds. Test printer works only after the printer has been created.
The other fields, such as CodePage, the header lines and the Print options, work as for any receipt printer. See Printers and cash registers.
Step 3. Use the printer in the POS
- Receipts: in the POS on this device, open Options and choose the printer in Printer.
- Kitchen and bar slips: choose the printer as the product’s kitchen printer.
If nothing prints
- The app’s test print works, but Test printer in Smarton doesn’t. Check that the topic is exactly the same in both places, that Printer with local IP is unticked, and that the printer is Enabled in the Devices list.
- The status is STOPPED. Turn on Enable Network Printer Agent.
- The Network Printer Agent notification is missing. The app isn’t listening, for example after the device restarted. Open SmartOn POS.
- The notification says Reconnecting... or Connection failed — retrying. The device has no internet connection.
- Android asks again whether SmartOn POS may access the printer. This can happen after the printer is unplugged or the device restarts. Tap OK, then print again: a slip sent while the question was open is not printed.
- Letters such as ą, č, š print wrong. Set the CodePage. Print code page in the printer’s window shows which characters the printer has.
English