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.

Opening Settings. The toolbar is hidden by default. Tap the SmartOn logo on the domain screen 5 times to reveal it, then tap the wrench icon to open Settings.
SmartOn POS Settings screen showing collapsible cards for Payment Terminal, Printer, Device Mode, Secondary Display, Device Information and USB Scale
The Settings screen is organised into collapsible cards. Tap a card's header to expand it.

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 dropdown showing DejaMobile, Swedbank, SEB POS, Paynt POS, Paynt, Ashburn SmartPOS, Viva Wallet and Worldline Baltic with their logos
The Terminal Provider dropdown lists every supported payment integration.
  • 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.

Printer section expanded showing Sunmi, Telpo, iMin, Landi, R330, Pax and ZCS printing toggles, a Paper Width dropdown set to 58 mm, and the Network Printer Settings and Configure Cloud Printer (BLE) buttons
Only enable the toggle matching the actual printer hardware on the device.
  • 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 card with the switch turned on and the Terminal Domain field filled in with kasa
The Terminal Domain field appears when Terminal Mode is on.
  • 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 kasa for 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.
Waiting screen with the SmartOn logo, a spinner and the text Waiting for a request from the cash register
The waiting screen is shown in the device’s language.

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.

Secondary Display section expanded with an Enable Secondary Display toggle and a Secondary Display URL field
Enter the URL the customer-facing display should load, then enable the toggle.
  • 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.

Device Information section showing Client ID with a Send button, and an expanded QR code
The Client ID uniquely identifies this device — the same value used when creating a Payment Terminal record in the SmartOn admin panel.
  • 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.

USB Scale section expanded with the toggle enabled, a Scale model dropdown set to CAS PDN, and a Test Scale (Read Weight) button
Once enabled, pick the connected scale model and use Test Scale to confirm it's reading correctly before relying on it at the till.
  • 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.
Scale setup. The scale itself also needs a one-time USB configuration before this toggle will read anything — see the USB scale setup guide.

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.
Choose a unique topic. The topic is not tied to your company: every device that listens on the same topic prints the same slips. Use a topic nobody else would pick, for example 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

  1. Plug the printer into the device and switch it on.
  2. Open Settings, expand Printer and tap Network Printer Settings.
  3. 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.
Network Printer Settings screen with the Network Printer Agent STOPPED, no configured printers, and the Add Network Printer, Add USB Printer and Scan Network for Printers buttons
Network Printer Settings before any printer is added.
  1. 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).
  2. 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.
USB printer window with the printer name, the MQTT topic, an unticked Star Micronics (StarXpand SDK) checkbox and the Cancel and Save buttons
The same window opens when you edit the printer later; its title is then Edit USB Printer.
  1. 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.
  2. 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.
Network Printer Settings with the agent RUNNING and one configured USB printer showing its topic, VID and PID, with test print, edit and remove icons
Each printer shows its topic and the USB VID and PID it is matched by.

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

  1. In Smarton, open Settings → Integrations, tab Devices, and click +.
  2. Choose the Class UniversalPosPrinter (1).
  3. Enter a Name (2). Staff see this name when they choose a printer in the POS.
  4. Leave Printer with local IP (3) unticked. When it is ticked, Smarton doesn’t send the job to the topic.
  5. IP and Port (4) must be filled in, but they aren’t used when a topic is set. Leave the default values.
  6. LineLength (5) is the number of characters per line: 48 for 80 mm paper, usually 32 for 58 mm paper.
New device window in Smarton with Class UniversalPosPrinter, Name, an unticked Printer with local IP checkbox, IP, Port and LineLength fields
The top of the New device window.
  1. Scroll down and enter the Mqtt topic (6), exactly as in the app. Capital letters matter, and there must be no spaces.
  2. Click Create (7).
  3. 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.
Lower part of the New device window with the Mqtt topic field filled in and the Create and Test printer buttons
The Mqtt topic field is near the bottom of the window.

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.

See also