Setting Up an Integrated Fingerprint Scanner
Overview
Each cashier or terminal PC that uses a fingerprint scanner needs a one-time setup: the scanner driver plus a small SecuGen background service that lets the web application talk to the scanner. Setup takes about 10 minutes per PC.
What you need:
- A SecuGen Hamster Plus fingerprint scanner
- A PC running Windows 10 or Windows 11
- Administrator rights on the PC (for installing software)
- Google Chrome or Microsoft Edge
What gets installed:
- Scanner driver so Windows recognizes the device
- SecuGen WebAPI client (shows as "SecuGen Web API Service" in Task Manager), which runs in the background and passes fingerprint scans from the scanner to the browser
No license or activation is needed on the PC itself. Licensing is handled by us for the web application.
Installation steps
Complete these steps in order, signed in to Windows as an administrator.
1) Install the scanner driver.
- Download the Hamster Plus driver from secugen.com/download and run the installer.
- Plug the scanner into a USB port. Windows should recognize it within a few seconds.
2) Install the SecuGen WebAPI client.
- On the fingerprint screen in our application, click the link that reads "You must download the software to run fingerprint scanner."
- Right-click the downloaded file and choose Run as administrator. Accept the prompts to finish.
- This installer is for 64-bit Windows. If your PC is 32-bit, contact our support team.
3) Restart the PC. This makes sure the background service starts.
4) Confirm the service is running.
- Press Ctrl+Shift+Esc to open Task Manager.
- Under Background processes, look for SecuGen Web API Service.
5) Trust the local connection (first time only).
- In Chrome or Edge, open https://localhost:8443
- If a security or certificate warning appears, click Advanced, then Proceed. The page may keep loading without showing anything; that is normal. Close the tab.
6) Test a scan.
- Log in to our application and open the fingerprint screen.
- Click Click to Scan and place a finger flat on the scanner when its light comes on.
- The fingerprint image should appear within a few seconds.
- If the browser asks to allow access to devices on your local network, click Allow.
Troubleshooting
Most problems come from the service not running or the scanner not being detected. Match the message you see on screen:
| Message or symptom | What to do |
| "Could not reach the SecuGen service" | Check Task Manager for SecuGen Web API Service. If it is missing, reinstall the WebAPI client as administrator and restart the PC. |
| Error 53 or 55 (device not found) | Unplug the scanner, wait 5 seconds, and plug it back in. Try a different USB port. Reinstall the driver if it persists. |
| Error 54 (timed out) | No finger was detected within 10 seconds. Click Click to Scan again and place the finger as soon as the light comes on. |
| Error 59 (device busy) | Close any other program or browser tab using the scanner, then try again. |
| Error 10004 (access denied) | Contact our support team. This is a licensing setting on our side, not a problem with your PC. |
| Certificate or security warning in the console | Repeat installation step 5. |
| Image appears but is faint or patchy | Clean the scanner glass with a soft, dry cloth and press the finger flat with light pressure. |
If none of these resolve the issue, contact our support team with the error message and the PC's Windows version at support@cietrade.net.