User Guide to Configure Biometric with SecuGen Hamster Pro HUPx
Introduction
The Xilnex system supports biometric authentication using fingerprint scanners to enhance security and streamline employee login processes. Our platform now supports the SecuGen Hamster Pro HUPx fingerprint scanner, in addition to the existing ZKTeco ZK9500 and Digital Persona devices, providing greater flexibility and hardware availability for your business needs.
Supported Fingerprint Scanners
- SecuGen Hamster Pro HUPx — Latest supported model, available for new deployments
- ZKTeco ZK9500 — Supported model for existing users
- Digital Persona — Legacy model with continued support for existing users
Key Features
- Secure biometric authentication for employee login
- Support for multiple fingerprint scanner models
- Automatic device detection
- Backward compatibility with existing fingerprint data
- Easy enrollment and management through Classic POS
Getting Started
Prerequisites
Before enrolling fingerprints, ensure you have:
- A SecuGen Hamster Pro HUPx fingerprint scanner
- Scanner properly connected to your computer via USB
- SecuGen driver installed on the PC (see Installing the Driver below)
- Access to Classic POS application
- Appropriate user permissions to manage employee biometric data
Installing the Driver
The SecuGen Hamster Pro HUPx requires a driver to be installed before the scanner can be used with Classic POS.
Step 1: Obtain the Driver
Download the driver from: https://secugen.com/drivers/
Step 2: Extract and Run the Installer
- Locate the downloaded file
- Right-click the file and select Extract All, then choose a destination folder
- Open the extracted folder and run the installer file (
.exe) - Follow the on-screen installation prompts and accept the licence agreement
- Click Install and wait for the installation to complete
- Click Finish when prompted
Step 3: Connect the Scanner
- Plug the SecuGen Hamster Pro HUPx into a USB port on your PC
- Windows will automatically detect the device using the newly installed driver
- Wait for the device to be ready before proceeding
Important: Always install the driver before connecting the scanner for the first time. If the scanner was connected before the driver was installed, unplug it, install the driver, then reconnect.
Enrolling Employee Fingerprints
Follow these steps to enroll an employee's fingerprint using the SecuGen Hamster Pro HUPx:
Step 1: Access User Management
- Open the Classic POS application on your computer
- Click on the Xilnex Menu
- Navigate to User Management
- Select User List
- Click on the user you want to enroll to open their profile for editing
Navigation Path: Classic POS > Xilnex Sidebar Menu > User Management > User List > Select User
Step 2: Select Biometric Type
- In the user profile editor, locate the Biometric Type dropdown menu
- Select SecuGen from the dropdown
Note: The dropdown will show three options — Digital Persona, ZKTeco, and SecuGen. Select SecuGen when using the Hamster Pro HUPx device.
Step 3: Enroll Fingerprint
- Click the + button next to the No Biometric Enrolled
- Follow the on-screen instructions to scan the employee's fingerprint
- The system will prompt you to scan the same finger multiple times for accuracy
- Wait for the confirmation message that enrollment is successful
Note: Follow on screen instruction to register.
Step 4: Save Changes
- After successful enrollment, click Apply to save the changes
- The employee's fingerprint data is now stored in the system
Using Fingerprint for Attendance
Once enrolled, employees can use their fingerprint to log in to Classic POS:
- Ensure the SecuGen Hamster Pro HUPx scanner is connected to the PC via USB
- Place your enrolled finger on the scanner
- During Attendance or other biometric-supported actions, the system will automatically detect the scanner type and authenticate you
Technical Information
How Fingerprint Data is Stored
The system stores fingerprint data securely in the database:
- Each scanner type uses a different data format
- The system uses the BIOINDEX field to store scanner-specific data
- Automatic device detection ensures the correct data format is used
- Full backward compatibility with existing Digital Persona and ZKTeco enrollments
Multi-Outlet Support
The system fully supports organisations with multiple outlets using different scanner types:
- Outlet A can use SecuGen Hamster Pro HUPx scanners
- Outlet B can use ZKTeco ZK9500 scanners
- Outlet C can use Digital Persona scanners
- Employees can be enrolled with different scanner types per outlet
Best Practices
Practice | Description | |
Clean Fingers | Ensure fingers are clean and dry before scanning for best results. | |
Enroll Multiple Fingers | Consider enrolling multiple fingers as backup in case of injury. | |
Regular Scanner Cleaning | Clean the scanner surface regularly with a soft, lint-free cloth. | |
Proper Finger Placement | Place finger flat and centred on the scanner for consistent reads. | |
Test After Enrollment |
|
Troubleshooting
Scanner Not Detected
Problem: The system does not detect the SecuGen Hamster Pro HUPx scanner.
Solutions:
- Verify the scanner is properly connected via USB
- Check if the SecuGen driver is installed correctly
- Try connecting the scanner to a different USB port
- Restart Classic POS and try again
Fingerprint Not Recognised
Problem: The scanner does not recognise the enrolled fingerprint.
Solutions:
- Ensure your finger is clean and dry
- Check that you are using the enrolled finger
- Place your finger flat and centred on the scanner
- Clean the scanner surface
- Re-enroll the fingerprint if issues persist
Enrollment Fails
Problem: Cannot complete fingerprint enrollment.
Solutions:
- Verify that SecuGen is selected in the Biometric Type dropdown
- Ensure consistent finger placement during all scans
- Try enrolling a different finger
- Contact support if the issue continues
Technical Support
If you need additional assistance or encounter issues not covered in this manual, please contact our support team:
- Email: support@xilnex.com
- Portal: https://portal.xilnex.com
Appendix: System Compatibility
Note: The system automatically detects which scanner type is connected and handles the appropriate data format. No manual configuration is required beyond selecting the biometric type during enrollment.
ZKTeco ZK9500
Related Articles
Xilnex API Guide for 3rd party
1. Objective The objective of this API guide is to provide a clear reference for developers and integration partners on how to utilize the Xilnex APIs to establish communication with the Xilnex system. The guide outlines the available endpoints, ...Basic - How To Configure Walk-In Client Name
How to Configure Walk-In Client Name Change the Walk In Client Name in system configuration (system configuration > Sales > Walk In Client Name [All Outlets])Intermediate - How to Configure a Calculated Field in Printing Format
Calculated Field Usage Calculated Fields are a custom field in the printing format editor that allows users to be able to customize fields to have certain values for example if user wants to be able to have a Subtotal of a sale to show with the ...Intermediate - How to Configure and Use Approval Settings in Purchase Orders (PO)
1.0 What is approval setting In general, "approval setting" refers to the configuration or process by which a request, action, or change must be reviewed and approved before it proceeds. The term is often used in business, software applications, and ...Basic - F&B - How to configure ‘Define out of stock’
Enable & Configure function ‘Define out of stock’. This feature is applicable for the F&B POS module only. From F&B POS > Click Functions > and Click Define Out of Stock . Add Item into Define out of stock (Mandatory) Click Find Item: Select items ...
Recent Articles
Managing Lark User Email Mapping in Xilnex for Lark
Overview The Users card matches each Xilnex user to their Lark account by email. This is what lets features like Permission Approvals and Document Approvals deliver Lark cards to the right person. This article covers how to review the mapping and fix ...E-Wallet and Credit Card Payment - Recheck Status & Force Complete
This guide walks you through what to do when a payment goes through on the terminal or e-wallet, but Classic POS fails to commit sales. When Does This Happen? During payment, Classic POS will show a "Connecting to Ewallet party..." or processing ...E-Journal for BIR Compliance (Philippines)
Overview The E-Journal feature generates a .txt file that complies with BIR (Bureau of Internal Revenue) requirements in the Philippines. This feature is available only for the Philippines COM. Users from other countries' COMs will not be able to ...Disconnecting or Reconnecting Xilnex for Lark
This article covers how to disable a template, fully disconnect the integration from Lark, and reconnect it again. Disable a Template Turning a base off only stops that one base, everything else keeps syncing, and none of your existing data in Lark ...Creating a Base in Xilnex for Lark
Overview This article walks you through creating a base for a template, giving end users access to it in Lark, and verifying data is syncing correctly. Xilnex for Lark must already be connected before you start. If the Templates card isn't accessible ...
Popular Articles
Basic - How to create a voucher-coupon
Voucher and coupon definition Voucher can be generated in bulk and can be used once Coupon can only be created one at a time (reusable code) and can be use multiple times Pre-voucher / coupon setup There are 2 things need to be prepared before we can ...Understanding DuitNow QR Payment in ClassicPOS
Introduction This document introduces the DuitNow QR payment feature available in the Xilnex Retail POS, enabling merchants to accept payments conveniently through Malaysia's national QR payment standard. The integration of DuitNowQR simplifies the ...Intermediate - How to Configure and Use Approval Settings in Purchase Orders (PO)
1.0 What is approval setting In general, "approval setting" refers to the configuration or process by which a request, action, or change must be reviewed and approved before it proceeds. The term is often used in business, software applications, and ...Buy 2 for Special Price Promotion
Use Case: Stock clearance, seasonal offers, or spotlight products. From the sample screenshot above, this promotion requires 2 items to trigger. If only 1 Milk Tea is added to the sales list, no discount will apply since the condition of 2 items is ...Creating Delivery Type for Sales in Classic POS
How to Create Delivery Type 1. Access to the [System Configuration] 2. Select the [Sales] section 3. In the [All Outlets] tab, look for the 'Delivery Type' 4. Click on the [Configure] In the Delivery Type Setup form: 1. Enter the Delivery Type. 2. ...