DigiLocker

This DigiLocker verification provides an efficient way to access and verify digital documents stored in DigiLocker. By connecting directly to DigiLocker, this module simplifies the process of retrieving documents for verification purposes, ensuring that each document is validated securely.

How to Setup

1 Navigate to Workspace > Workflows, and click on the flow created for DigiLocker. If you need understanding in creating a workflow, refer to the step-by-step guide guide here.

2 Hover over the plus (+) symbol and select Workflow. From the list, click DigiLocker to add it.

3 Click on the newly added workflow, then select the General tab to customize your preferences.

Manage General

(*) Indicates an action to be mandatory.

Name	Description
Display Name*	Set a name to the workflow for easy identification.
Description	Summarize the purpose and functionality of this workflow module.
Enable	This toggle is enabled by default. When enabled, the particular workflow module begins its execution. Conversely, if disabled, the workflow module remains inactive and won't proceed.
Rule	This determines the criteria for triggering the particular workflow module. When the selected rule is evaluated, and is satisfied, the workflow proceeds as provided. If not, the workflow will not be executed. Note: If no rules are set, the workflow defaults to its standard action without any rule. For more information about the rules, refer here.

4 Then, click on the Configs tab to set the necessary configurations.

Manage Configs

(*) Indicates an action to be mandatory.

Name	Description
List of Documents	From the drop-down, select the documents you want to verify. The available options are Aadhaar, PAN, and Driving License.
Purpose of Document Verificaiton	Choose the purpose for verifying the documents in DigiLocker, such as verification, KYC, availing services, compliance, or educational purposes. The selected purpose will appear on the consent screen.

5 After you've configured everything needed, click on SAVE.

6 Proceed to attach the workflow to the relevant application for execution. Refer to the instructions on how to attach a workflow to an application here.

Expected Result

Based on the provided configuration, the information that will be fetched for DigiLocker includes the following parameters:

Name	Description
digilocker_verification_completed_at	This provides a timestamp, in Unix epoch format, indicating the exact time when the DigiLocker verification was completed. This allows you to know precisely when the verification event occurred.
digilocker_verification_completed	This denotes whether the DigiLocker verification is completed. The value will be "True" if the verification is successfully completed and "False" if it is not.

The response received will include the accurate information mentioned above. Note that, the response values can vary depending on the specific workflow modules.

How it Works

1 Launch Postman or your preferred API tool and execute the flow by configuring the suitable Method, URL, and Body settings. If you're seeking guidance on how to perform these actions, see here.

2 Upon initiating the API call, a verification request will be sent to your configured Verification Way settings.

3 Based on the request, execute the flow in an incognito browser and follow the prompts to complete the verification process.

4 Sign in to your DigiLocker account using your preferred method to proceed with the process.

5 The documents you selected, along with other basic details, will be displayed. The purpose of the flow will also be shown here.

6 Provide your consent to proceed by clicking the Allow button.

7 If the requested document is not found in your DigiLocker, you will be prompted to add the document by providing specific details. Once the details are entered, the document will be automatically added to your DigiLocker, and the relevant claims will be displayed. For example, if the PAN document is not available, you will need to provide the required information.

8 You will be asked to pull the document into your DigiLocker. Click Continue to proceed with this step.

9 Enter the PAN number, give your consent, and click the Continue button to complete the process.

10 The verification process will be completed.

If "force onboarding" is enabled in the API request, all users, regardless of status, will be directed to the onboarding flow first, followed by the verification flow if configured.

11 The response can differ depending on the chosen Verification Way and Notification Way configurations. To know more, see here.

12 Here is a sample response for DigiLocker:

{  
   "workflow": "verification",
   "request_id": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxx",
   "user_id": "mark@gmail.com",
   "digilocker_verification_completed_at": "1734519961301",
   "driving_license": "{xxxxxxxxxxxxxxxxxxxxx}",
   "aadhaar": "{xxxxxxxxxxxxxxxxxxxxx}",
   "pan": "{xxxxxxxxxxxxxxxxxxxxx}",
   "digilocker_verification_completed": "true"
}