FAQ — Print & Hardware

import { Aside } from ‘@astrojs/starlight/components’;

Receipt does not print

Fix (5 steps):

Check the receipt mode in store settings — must be “Auto” or “Prompt” (not “Off”). Owner config under Store settings → Receipt.
Confirm the printer is enabled — open Settings → Receipt printer, ensure the device is ON and marked as default.
Print a test page from the same settings page — if the test prints but receipts don’t, the issue is in the tender flow.
Restart Vendor Desktop after changing the printer driver on the OS (Windows: switch driver; macOS: change default printer).
Use “Preview receipt” on the order screen to confirm the data loads.

Fix:

Font too small / too big: adjust the font size in Settings → Receipt printer → Print template.
Store logo is blurry: re-upload a PNG ≥ 300dpi in Store settings → Branding.
Last line cut off: confirm the paper width (default 80mm) matches the actual roll.
Barcode won’t scan: ensure it uses Code128 (not EAN-13).

Fix (4 steps):

Check power & network on the terminal — power LED on, LAN/USB cable seated, or WiFi/4G signal.
Confirm Vendor Desktop is running on the lane PC — the bridge needs the app in the background. If closed, reopen.
Check the bridge under Settings → Bridge (desktop only) — status must be “Connected”.
If still no response, owner checks Dashboard → Terminals → Bridge activity for logs.

Fix: see FAQ — sale & checkout → Payment stuck pending.

Fix:

Fix:

Check the RJ12 cable between drawer and receipt printer.
Open Settings → Cash drawer → enable “Open on cash tender”.
Test manually from the same settings page — if the test works but a real sale doesn’t, confirm the tender was actually cash.

Fix (3 steps):

Send to the store owner or support@lionpos.com. Hardware issues need the device model to diagnose.