Terminal settings and browser pairing

• Device choices are saved for each terminal. Confirm the terminal before saving so another counter does not inherit the wrong printer.
• The browser also remembers device access. Allow the device permission when pairing; using a new browser, browser profile or computer requires pairing there again.
• Direct thermal printing uses the browser print bridge. If direct access is unavailable, use the normal browser print dialog. You can keep selling without a thermal printer and open the drawer manually.

Pair a receipt printer

1. Connect a supported USB ESC/POS thermal printer, such as a compatible Epson, Star, Bixolon or generic model, and switch it on.
2. In the terminal’s Hardware settings, choose Thermal receipt printer and select the paper width that matches the roll: 58 mm or 80 mm.
3. Choose Pair printer, select the correct device in the browser prompt and approve access. Use Test print and check text, paper width and cutting.
4. Set the logo, visible fields and header/footer in Settings → Receipt template. Complete a test sale to check automatic printing and the receipt-number barcode. If text is garbled, recheck printer compatibility and the selected setup.

Connect and test the cash drawer

1. Connect the drawer’s phone-style cable to the receipt printer’s drawer socket; the drawer normally receives its opening signal from the printer.
2. Select Connected to receipt printer in Hardware and use Test kick. Check printer power and the cable if it does not open.
3. The drawer opens automatically for cash payments when direct printing is supported. Opening it without a sale requires the Open drawer permission. Browser-print fallback does not automatically trigger the drawer.

USB and camera barcode scanners

• A USB scanner normally behaves like a keyboard: connect it, focus product search and scan a known product barcode. Confirm it adds the correct product or variant.
• For a phone or tablet, open the camera scan button and allow camera access. Centre the barcode and wait for recognition.
• A scan that types digits but finds no product usually means the barcode is missing or belongs to another variant. Scale labels also need the correct Settings → Weighing scale format; see the weighed-items guide.

Label printers and A4 sheets

• Connect the supported label printer and pair it from Hardware using the same browser permission flow. Test one label before a batch.
• Choose the matching roll size in Products → Print labels. You can instead use an ordinary printer with an A4 sticker-sheet layout.
• Print at actual size / 100%, without Fit to page, and scan a sample. See Barcode labels for fields, quantities and purchase-based label selection.

Browser and device compatibility

Chrome, Edge and Opera

Supported browser device access allows direct thermal printing and drawer signals after pairing. Windows or Android with a compatible Chromium browser is the documented direct-printing path.

Firefox and Safari

Use the standard print dialog. Direct thermal-device access and automatic drawer opening are unavailable through this fallback.

iPad with Safari

Use the available browser printing route; do not expect the desktop direct-USB thermal pairing flow. Test the actual printer and device before opening the counter.

Recover receipts in the failed-print queue

1. A failed-print notice means the receipt is queued, not that the sale is unpaid. Keep the original sale record.
2. Restore power, paper, closed cover and the cable connection. The queue retries every few seconds; use Retry on the failed receipt after fixing the cause.
3. If pairing was lost, pair again. Use browser printing temporarily if the direct printer remains unavailable. Check the receipt number before reprinting so the same customer is never charged again.

Run Hardware diagnostics

1. Open Hardware diagnostics for the current terminal. Green, amber and red indicators show ready devices, warnings and failures.
2. Run the receipt print, label print, drawer kick and barcode scan tests separately. A successful receipt test alone does not verify every device.
3. After moving a cable, changing browsers or replacing equipment, repeat the tests. Send support the device model and failed diagnostic result if the problem persists.