Skip to main content

PAN Aadhaar Link Status

This module verifies the link status between an individual's PAN and Aadhaar. It ensures that both documents are correctly associated, which is required for proper validation during the verification process.

How to Setup

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

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

PAN Aadhaar Link Status

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

General

Manage General

(*) Indicates an action to be mandatory.

NameDescription
Display Name*Set a name to the workflow for easy identification.
DescriptionSummarize the purpose and functionality of this workflow module.
EnableThis 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.
SkipAllows the user to skip this specific workflow module during execution. When selected, it provides an option to bypass the particular workflow without affecting other modules in the sequence.
RuleThis 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.

Configs

Manage Configs

NameDescription
Aadhaar NumberSpecify the Aadhaar number claim from previously executed flows to compare. If no claim is provided, the user will be prompted to enter the Aadhaar number during the verification process.
PAN NumberSpecify the PAN number claim from previously executed flows to compare. If no claim is provided, the user will be prompted to enter the PAN number during the verification process.

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 PAN Aadhaar Link Status includes the following parameters:

NameDescription
pan_aadhaar_link_status_verified_atThis provides a timestamp, in Unix epoch format, indicating the exact time when the PAN and Aadhaar verification was completed. This allows you to know precisely when the verification event occurred.
pan_aadhaar_link_status_verifiedThis denotes whether the PAN and Aadhaar verification is completed. The value will be "True" if the verification is successfully completed and "False" if it is not.
codeTwo possible codes can be returned: EF40124 indicates that the PAN and Aadhaar are linked, while EF40125 indicates they are not linked.
descProvides a message indicating whether the given PAN and Aadhaar are linked, including masked details for security.

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.

If Aadhaar and PAN numbers are not pre-configured in the workflow module's configs, users will be prompted to manually enter these details for verification.

4 Enter the PAN Number and Aadhaar Number, then click Submit to continue.

Pan & Aadhaar

5 The verification process will be completed if the entered data is valid.

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.

Completed

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

7 Here is a sample response for PAN Aadhaar Link Status:

{
"request_id": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxx",
"workflow": "verification",
"user_id": "mark@gmail.com",
"code": "EF40124",
"pan_aadhaar_link_status_verified_at": "1738822951",
"pan_aadhaar_link_status_verified": "true",
"desc": "Your PAN EFXXXXXX8P is already linked to given Aadhaar 40XXXXXXXX19"
}