Beneficiary User

Splash screen

• Contains language selection (by default English) and two buttons for Seeker registration and Login

Registration Process (OTR-Based)

Step 1: OTR Certificate Upload

• User initiates registration by uploading the OTR Certificate.

• The certificate is issued by the National Scholarship Portal (NSP).

Step 2: OCR & Data Extraction

• Once the OTR certificate is uploaded:

  • An OCR (Optical Character Recognition) process is triggered.

  • Required user details are read and extracted from the certificate text using LLM mapping.

Step 3: Automatic Account Creation

• Based on the extracted OTR data:

  • A user account is automatically created.

  • OTR certificate is uploaded against the created user

  • Username: OTR Number (from the certificate).

  • Password: System-generated default password.

Step 4: Initial Login

• User logs in using:

  • Username: OTR Number

  • Password: Default password

Step 5: Mandatory Password Reset (First Login)

• On the very first login:

  1. The system prompts the user to update their password.

  2. The user must first validate the default password.

  3. Upon successful validation, the user is asked to set a new password.

• Once the password is reset:

  • The default password is invalidated.

  • The user can log in using the OTR number and the new password going forward.

Step 6: Profile Completion (Post First Login)

• After successful login and password reset, the user is redirected to the Profile Update Page.

• The user can update additional details, such as:

  • Profile picture

  • Mobile number

  • Ownership of mobile number (self/guardian/other)

• If the user is newly registered and logs into the system, they will be prompted with a Terms and Conditions consent dialog containing all the Terms and Conditions along with "Accept" and "Deny" buttons. If the user selects "Deny", they will be logged out of the system. If they select "Accept", their consent will be securely recorded in the system, and they will be redirected to the Home page.

• The Home section allows beneficiaries to manage their personal information and upload the required documents to apply for benefits

How It Works

• After login, the user is redirected to the Home screen.

• Use the Scan & Upload Documents button to scan and upload documents.

Steps to Complete Your Profile (Blue dot)

1. Scan and upload Documents

• Navigate to the Home section from the bottom navigation menu.

• Click on Scan & Upload Document to add or update your documents.

• On clicking the "Scan & Upload Document" button, the Document Scanner page will open. This page displays a list of all required documents, each with its own "Upload" button.

1.1 Document Selection and Configuration

When the user clicks the Upload button for a specific document:

• The system checks the document configuration set by the administrator.

• Based on the configuration, the appropriate upload options are displayed to the user.

1.2 Upload Options

Depending on the document configuration, the user may see one or more of the following options:

Option A: Upload Document / Capture Photo

• Upload an image or PDF file (maximum size: 10 MB), or

• Capture a photo using the device camera.

Option B: Scan QR Code

• Scan the QR code present on the document using the device camera.

1.3 Document Upload and Processing

A. Uploading or Scanning the Document

If the user selects Upload Document or Capture Photo:

• The camera opens (for photo capture), or the file picker opens (for image/PDF upload).

• The user uploads the selected document.

If the user selects Scan QR Code:

• The camera opens automatically.

• The user scans the QR code of the document.

• If the QR code is not detected within 15 seconds, an error message is shown.

• The user can retry the scan if needed.

B. Document Processing

Once the document is submitted or the QR code is scanned:

• The system processes the document automatically.

• Text is extracted from the document using OCR.

• Extracted data is mapped to predefined fields based on document configuration.

• All required fields are validated as per the rules defined by the beneficiary admin.

1.4. Verification and Storage

The document verification and storage process depends on whether the document has a digital presence (supports QR-based verification) or does not have a digital presence.

Digitally Verifiable Documents (QR-based)

If the uploaded document contains a valid QR code, the document is verified immediately by the system without any issuer involvement.

Flow

1. The user scans the QR code and uploads the document.

2. The system validates the QR code and verifies the document data.

3. Based on the verification result, one of the following outcomes is shown:

Success State

• Document Upload successfully via QR Code Displayed when the QR code is successfully scanned and the document is verified.

• The document is marked as Verified and securely linked to the user’s profile.

• No Verifiable Credential (VC) issuance is triggered.

Document Upload successfully via QR Code

Error States

The following error screens are shown when verification fails:

• If the QR code is not detected within the configured scan time, the error “QR code not detected. Please scan again clearly.” is displayed.

QR code not detected. Please scan again clearly.

• Each document type has a configured QR type in the Admin settings (Text and URL – PDF). If the QR code content does not match the configured type or the URL does not return a PDF, this error is displayed: “This QR code is not supported. Please scan the QR code from the original document.”

This QR code is not supported. Please scan the QR code from the original document.

• If a valid QR code is scanned but the uploaded document does not match the required document type (e.g., Caste Certificate uploaded for Income Certificate), this error is displayed: “Invalid document type. Required: Income Certificate.”

Invalid document type. Required: Income Certificate.

• When strict name checking is enabled, and the scanned Income Certificate does not match the user’s name, this error is returned: “Name does not match the user profile. Please re-upload the document.”

Name does not match the user profile. Please re-upload the document.

• If the scanned Income Certificate has expired, this error is shown: “Credential verification failed. The credential has expired and is no longer valid.”

Credential verification failed. The credential has expired and is no longer valid

Non-Digitally Verifiable Documents (No Digital Presence)

For some documents, such as Marksheets or Bonafide certificates, which may not yet be available online and cannot be digitally verified, the documents are manually Digi attested as below:

1. The user uploads the document image or PDF.

2. The document appears in Pending status in the beneficiary app.

1. The document is sent to the Issuance module (Dhiway's Markstudio see documentation) for DigiAttestion of the document.

2. The issuer receives the uploaded document.

• The uploaded document appears in the Draft list in the issuance system.

• The issuer views or edits the details by comparing them with the original document.

• When the issuer verifies and issues the credential, clicking the Issue Button.

• The document is issued and appears in the Issued Documents list.

1. After a period of time (currently set to 5 minutes)

• The document status is updated to Verified in the beneficiary app.

• The issued VC is updated in the beneficiary app.

The system will automatically update user profile with the details from the uploaded document.

On the Home screen, users can view documents marked with a green icon and perform three actions: preview the verified credential (VC), preview the original document image, and delete the document.

Document status Details

• Documents marked with a yellow icon indicate missing or incomplete documents.

• Documents marked with a green icon indicate that the document is verified.

• Documents marked with a red icon indicate that the document is revoked or expired.

• Documents marked with a clock icon indicate that the document is pending verification.

• Documents marked with a trash icon indicate that the document is deleted.

A list of required documents is displayed. Each document item shows:

• The document name

• The expiry date, if applicable

  • If the document has expired, the expiry date is highlighted in red to indicate

Preview Document

A View Document icon, which opens a preview of the document in JSON format when clicked.

Preview Original Documents used during VC creation

Image Icon: Opens the original VC image for the document in a viewer.

Delete Document

A Delete icon on the right side of the document. When the Delete icon is clicked, a confirmation dialog appears with a warning message: "Are you sure you want to delete this document?” If the user selects "Okay", the document will be deleted from the profile

Explore Benefits

The benefits are displayed under two separate tabs:

• My Benefits:

  • Displays only the benefits the user is eligible for, based on scheme-specific eligibility criteria, uploaded documents, region and system-defined default eligibility rules.

  • Includes a search bar for quick lookup.

  • Supports pagination to navigate through long lists.

• All Benefits:

  • Displays all benefits published onto the network.. Also includes filters such as gender, Income range and caste, and includes a search bar for quick lookup.

  • Includes filters: Gender, Income Range, caste

  • Includes a search bar for quick lookup.

  • Supports pagination to navigate through long lists.

  • On clicking "View Detail", the user is navigated to the Benefit Details page of the selected benefit.

View Benefit Details

• Clicking "View Detail" opens the Benefit Detail page.

• The Benefit Detail page shows:

  • Description of the benefit

  • Benefits to the beneficiary

  • Eligibility criteria

  • Required documents which includes Options to preview JSON format and Original document image

  • A "Proceed to Apply" button

• A "Proceed to Apply" button

Apply for Benefits

• When the user clicks "Proceed to Apply" system checks for expired documents

  • If any required documents are expired, an alert is shown. Example: “Your OTR Certificate and Income Certificate have expired. Please upload valid documents to proceed further.”

  • The user cannot proceed until valid documents are uploaded.

• If all required documents are valid, the system checks eligibility using the Eligibility SDK.

  • If the user is eligible:Redirect to the pre-filled application form.

  • If the user is not eligible:Show alert: "You are not eligible for this benefit." Restrict user from submitting application

Steps to Apply

• Go to the Explore Benefits section.

• Click View Details for the selected benefit.

• Click "Proceed to Apply".

A user who is not eligible will be restricted from accessing the form

• An eligible user will see the prepopulated form, fill in any missing fields, and submit the application.

• After successful submission, you’ll be redirected to My Application.

My Applications

• The My Applications section allows beneficiaries to track their application progress and view their application history.

• Track Application Status: Monitor the progress of your submitted applications.

• View Submitted Details: Click on an application to see all the details you provided during submission.

Steps to Track Application Progress

• Navigate to My Application from the bottom navigation menu.

• Select an application to review.

• View its details, including status and submission data. Profile (Navbar Menu)

• The Profile section is accessible from the navbar menu and allows you to view and update your personal information.

Logout

How to Logout

• Open the navbar menu.

• Click the Logout option to log out of the application.

• You will be redirected to the login screen.

Navigation Options

Bottom Navigation Menu:

• Home

• Explore Benefits

• My Application

• Navbar Menu:

  • Profile: View personal details.

  • Choose Language: Change the language of the beneficiary app

  • Logout: Log out of the application.

Troubleshooting

1. Login Issues

Problem: Incorrect Email or Password

• Solution:

  • Verify that your username and password are correct.

  • Ensure that the Caps Lock key is off.

  • If you are a new user, click the Register button on the splash screen and complete the registration process.

Problem: Unable to Access the Login Page

• Solution:

  • Check your internet connection.

  • Ensure the URL is correct.

  • Clear your browser cache and cookies, then try again.

2. Registration Issues

Problem: Registration Form Validation Errors

• Solution:

  • Ensure to upload a valid and clear OTR certificate.

Problem: Unable to Complete Registration

• Solution:

  • Verify the network connection and retry.

  • Check for server errors or maintenance announcements.

3. Home Section Issues

Problem: Documents Not Displayed

• Solution:

  • Refresh the page or restart the application.

  • Ensure that the backend API for fetching documents is functioning properly.

Problem: The Scan Documents are not working

• Solution:

  • Verify your internet connection.

  • Check the browser console (F12 > Console) for any error messages.

  • Ensure the QR code is clear

4. Explore Benefits Issues

Problem: Benefits List Not Displayed

• Solution:

  • Clear the browser cache and refresh the page.

  • Use the browser network tab (F12 > Network) to verify the API call status.

  • Ensure the backend API is running and responding correctly.

Problem: Filters Not Working

• Solution:

  • Refresh the page and try applying filters again.

  • Check if the backend API supports filtering options and if the filter logic is implemented correctly.

Problem: Application Form Fields Are Not Prepopulated

• Solution:

  • Ensure that your profile is fully updated with the necessary details.

  • Check the backend API for fetching user profile data.

Problem: Unable to Submit Application

• Solution:

  • Verify that all mandatory fields (e.g., Bank Details) are filled.

  • Check for any validation errors and correct them.

  • Inspect network activity (F12 > Network) to ensure the form submission API succeeded.

5. My Application Issues

Problem: Application Status Not Updating

• Solution:

  • Clear the browser cache and refresh the page.

  • Ensure that the backend API for tracking applications is functioning correctly.

Problem: Unable to View Application Details

• Solution:

  • Check for errors in the browser console or network tab.

  • Verify that the backend API endpoint for fetching application details is accessible.

6. Profile Section Issues

Problem: Profile Data Not Updating

• Solution:

  • Ensure that all required fields are filled before updating.

  • Refresh the page and retry the update process.

  • Verify that the backend API for updating the profile is operational.

7. Logout Issues

Problem: The logout Button Not Working

• Solution:

  • Refresh the page and try again.

  • Verify that the session or token handling logic is implemented correctly on the backend.

8. General Navigation Issues

Problem: Bottom Navigation Menu Options Not Responding

• Solution:

  • Ensure that your browser or app is up-to-date.

  • Verify that the routes or navigation logic in the app is correctly implemented.

Problem: Navbar Menu Options Not Accessible

• Solution:

  • Refresh the page or restart the application.

  • Check for errors in the browser console or app logs.