Set up the QR scanner at your front desk

Plug in a USB or Bluetooth QR scanner, verify it with the built-in scanner test, and check customers in from any admin page — no configuration needed.

Plug in a QR scanner and verify it with OpenCourt's built-in Scanner test so scanning a customer's Check-In QR Code checks them in from any admin page. (About 3 minutes. You need a USB or Bluetooth 2D scanner and the admin panel open.)

Before you begin

A 2D (QR-capable) scanner. Any model works — most cost 20–40 USD. See Choose a QR scanner for your front desk.
The scanner plugged into (or paired with) the computer that runs the admin panel.
The admin panel open and signed in to the right club (check the club name in the top bar).

How the scanner works

The scanner acts like a keyboard: when it reads a code, it types the characters very fast. OpenCourt listens for that fast keystroke burst on every admin page and opens the Scan result the moment a scan finishes — you never click into a field first. It works whether or not your scanner is set to press Enter after each scan.

Set up and test the scanner

Plug the scanner into a USB port (or pair it over Bluetooth). Most scanners need no driver — the computer recognizes it as a keyboard.
In the admin panel, go to Settings → Check-in and click Test your scanner (in the Front-desk QR scanning card). The Scanner test page opens.
Point your scanner at the on-screen QR code (2D) and pull the trigger. The page reads Waiting for a scan… until keystrokes arrive.
Read the verdict. Scanner working means you are done — the scanner read every character correctly and works with check-in as-is.
To confirm the result wasn't luck, click Test again and scan once more. Then scan a customer's Check-In QR Code from any admin page — the Scan result appears.

If the test reports a problem

Each verdict on the Scanner test page names the likely cause and the fix. In order of how often we see them:

No input received — no keystrokes reached the page. Confirm the scanner is plugged in (or paired) and beeps on the trigger, and that the browser tab was focused. If it beeps but nothing arrives, the scanner is in serial (COM) mode instead of keyboard (HID) mode — scan the "USB keyboard" or "HID keyboard" configuration barcode in its manual (see Configuration barcodes below), then test again. If the scanner reads other codes elsewhere but never beeps on the QR code, it is a 1D (laser) model that cannot read QR codes — front-desk check-in needs a 2D imager. This is a hardware limit no setting fixes; see Choose a QR scanner for 2D models.
Scanner working — that wasn't the test code — the scanner read a QR code cleanly, but not the one on the test page (usually a real customer's code was scanned by accident). The scanner works with check-in; scan the test QR code above to finish the test.
Characters came through garbled — keystrokes arrived but decode to the wrong characters. The scanner's keyboard-country setting doesn't match: scan the configuration barcode in its manual that sets the US keyboard layout, then test again.
Scanner too slow — the code arrived correctly but with pauses between characters, so real check-in scans may be missed. Usual causes: a Bluetooth connection in low-power mode, or a configured keystroke delay. Connect by USB if you can, or scan the configuration barcode that sets the keystroke/character delay to zero.
Only part of the code came through — a weak read. Raise the screen brightness, clean the scanner window, hold the scanner steady, and test again.

Configuration barcodes (how scanner settings actually change)

Scanners have no settings app. You change a scanner's behavior by scanning a special configuration barcode printed in its manual or on the setup card in the box — the scanner beeps to confirm. Those barcodes are specific to your scanner's brand and model; there is no universal one, so use your own manual. If you've lost it, the manufacturer's site has it:

Tera — tera-digital.com
ScanAvenger — scanavenger.com
Zebra — zebra.com (under Support)
NetumScan — netumscan.com

Every manual also includes a "restore factory defaults" barcode that undoes any change — a safe first step if a scanner behaves strangely and you don't know what was changed.

When to contact support

If the test keeps failing after the fix above (or the verdict doesn't match what you see), send us:

On the verdict card, click Show raw keystrokes and screenshot the table that opens — it shows exactly what your scanner sent, key by key, with timing.
Your scanner's brand and model.

With that screenshot we can usually name the exact configuration barcode you need.