Face Recognition Login

Path

To enable the feature: iVendNext Desk → System Settings → iVendNext POS section

To manage enrolments: iVendNext Desk → iVendNext POS → User Face Maps

To enrol via live camera: iVendNext Desk → Settings → User → [open user record] → Actions

Note to documentation team: Confirm exact module navigation paths before publishing.

Prerequisites

Before you can use Face Recognition Login, the following must be in place:

• You have the System Manager role in iVendNext Desk to enable the feature and manage enrolments.
• The POS terminal has a functioning front-facing camera, and the browser has permission to access it.
• The Allow Login using Face Recognition checkbox in System Settings has been enabled and saved.
• A User Face Maps record with a valid face encoding has been created for each user who will log in using this method.

A user who has not been enrolled cannot use Face ID login, regardless of whether the feature is enabled globally.

How to Enable Face Recognition Login

Face Recognition Login is disabled by default. A System Manager must enable it before the option appears on the login page.

1. Log in to iVendNext Desk as a System Manager.
2. Go to System Settings.
3. Scroll to the iVendNext POS section.
4. Tick the Allow Login using Face Recognition checkbox.
5. Click Save.

Once saved, the Login with Face ID button appears on the iVendNext POS login page. If you untick the checkbox and save, the button is removed immediately for all users. Existing enrolment records are not deleted when the feature is disabled.

How to Enrol a User

You can enrol a user in two ways.

Method A — Upload a Photo

Use this method when you have an existing photograph of the user.

1. Go to User Face Maps and click New.
2. In the User field, select the user you want to enrol.
3. In the User Face field, attach a clear, front-facing photograph of the user.
4. Click Save.

The system analyses the photo automatically on save. You will see one of two responses:

• "Face encoding generated and stored." — Enrolment was successful. The user can now log in with Face ID.
• "No face detected in the uploaded image." — The photo did not contain a detectable face. Use a clearer photograph and save again.

Photo requirements:

• The photo must contain exactly one face.
• The face must be front-facing, well-lit, and unobstructed.
• Supported formats: JPEG, PNG.

If enrolment fails, the Image info field on the record will be empty. The user cannot use Face ID login until a valid encoding is stored.

Image suggestion 1: Screenshot of a User Face Maps record in iVendNext Desk showing the User field populated, a photo attached to the User Face field, and the Image info field containing a JSON array — indicating a successful enrolment.

Method B — Live Camera Capture

Use this method to capture the user's face in real time from a camera.

1. Open the user's record in iVendNext Desk.
2. Click Actions and select Register Face Map. If the user already has a face mapping, this option shows as Update Face Map.
3. A camera window opens. Follow the on-screen prompts:

• Blink naturally. A green progress bar at the bottom of the camera view begins to fill.
• Make a subtle head movement — a small nod or slight turn. The bar continues filling.
• Once the bar reaches 100%, look directly at the camera with your eyes open and hold still.
• The system captures the image automatically. You do not need to press anything.

4. The camera window closes after a successful capture. A confirmation message — "Face mapping successful" — appears.

Clicking outside the camera window cancels the capture without saving.

Features

Login with Face ID

Once enrolled, a user logs in to iVendNext POS as follows:

1. Navigate to the iVendNext POS login page.
2. Type your username or email address in the Email or Username field. The Login with Face ID button is disabled until this field has a value.
3. Click Login with Face ID.
4. If the browser asks for camera permission, click Allow.
5. Complete the liveness check (see below).
6. Hold still for capture once prompted.
7. Wait for the server to verify your face — this takes a few seconds.

On a successful match, you see "Face Verified! Logging in..." and are redirected to the application. On a failed match, you see "Face match failed. Access denied." and can try again or log in with your password.

Password login remains available at all times alongside Face ID login.

Liveness Detection

Before capturing your face, the system confirms that a live person is present rather than a static photograph. A green progress bar at the bottom of the camera view shows your progress toward completing the check.

To fill the progress bar, you need to do two things:

• Blink naturally. One normal blink fills most of the bar.
• Make a subtle head movement — a small nod or slight side turn fills the rest.

Both are required. The bar will not reach 100% from blinks alone or from movement alone.

The score decreases if you stay still for too long, so continue blinking and making small movements until the bar completes. Once complete, the system prompts you to look straight at the camera with your eyes open and hold still for capture.

Image suggestion 2: Screenshot of the iVendNext POS login page showing the face detection camera view with the green progress bar partially filled, and the live camera feed with facial landmark overlay visible.

Face Matching

After the liveness check, the system captures a still image of your face and sends it to the server. The server compares it against the encoding stored in your User Face Maps record. If the result is within the accepted tolerance, you are logged in with the same roles and permissions as a standard password login. If not, access is denied and no session is created.

Updating a Face Mapping

If a user's appearance changes and Face ID login begins failing consistently, re-enrol the user with a new photo or a new live camera capture. Updating a face mapping replaces the previous encoding. Only one encoding can be stored per user at a time.

Removing a Face Mapping

To revoke Face ID login access for a specific user:

1. Open their User Face Maps record.
2. Delete the record.

The user must use their password to log in after the record is deleted. Other enrolled users are not affected.

Disabling the Feature

To turn off Face ID login for all users:

1. Go to System Settings.
2. Untick Allow Login using Face Recognition.
3. Save.

The Login with Face ID button is removed from the login page immediately. Existing User Face Maps records are preserved and will be active again if the feature is re-enabled.