AadhaarAPI | ZOOP web SDK for E-sign and Bank Statement Analysis Gateway
- Introduction
- Process Flow
- End User Flow
- Initiating a Gateway Transaction For E-Sign
- Set Zoop Environment
- Adding Web SDK To Your Project
- Handle Events
- Response Format Sent On
responseURL(Added In Init API Call) - Pulling Transaction Status At Backend
- Annexure
- INTRODUCTION
- PROCESS FLOW
- INITIATING A GATEWAY TRANSACTION
- ADDING WEB SDK TO YOUR PROJECT
- WEBHOOK
- STAGE
As a registered ASP under ESP AadhaarAPI provide WEB and Mobile gateway for E-signing of documents. Using these gateways any organisation on-boarded with us can get their documents signed digitally by their customer using Aadhaar number based EKYC (performed on ESP portal). The mode of transaction can be following:
- Aadhaar Number + OTP (works only on web and android)
- Aadhaar Number + Fingerprint (works only on windows machine and android)
- Aadhaar Number + IRIS (works only on Samsung IRIS tablet)
This solves the problem of wet signing of documents, which is a costly and time-consuming process. Aadhaar based E-sign is a valid and legal signature as per government regulations and is accepted widely across India by various organizations.
- Generate the document based on the user info at your backend.
- At your backend server, Initiate the e-sign transaction using a simple Rest API [POST] call by converting your document into base64 string or via our Multi-Part Upload API. Details of these are available in the documents later. You will require API key and Agency Id for accessing this API which can be generated from the Dashboard.
- This gateway transaction id then needs to be communicated back to the frontend where SDK functions are to be called.
- After including the SDK files (JS & CSS) at frontend and a small HTML snippet, client has to pass above generated transaction id to an SDK function to create a new gateway object and then open the gateway using another function call.
- This will open the gateway as shown in above image and the rest of the process till response will be handled by the gateway itself.
- Once the transaction is successful or failed, appropriate handler function will be called with response JSON, that can be used by the client to process the flow further.
- Result PDF url will be sent to the responseUrl requested via INIT call.
- Client will also have a REST API available to pull the status of a gateway transaction from backend and reason of failure.
- Customer Login [ Phone + OTP ]
- Document displayed to customer. (Draggable signature option can be turned on via gateway config or signPageNumber and coordinates can be fixed during initiation call)
- Customer chooses Mode of Authentication for performing E-Sign
- Customer is redirected to ESP’s Auth portal where EKYC is performed after entering either Aadhaar number or Virtual Id.
- After successful EKYC customer is displayed Sign details received and customer’s consent is taken to attach signature to the document and share a copy with requesting organization.
- On success, customer is provided with an option to download the signed file. Also, a download URL is sent to customer’s phone number and responseURL which is valid for 48 hours.
- On failure during request to ESP, customer is displayed an error code and error message. Same error details are sent to the responseURL.
- End Customer can validate the signature on PDF by opening the PDF in acrobat reader and Developer can programmatically fetch certificate from PDF to ensure validity of certificate if required.
To initiate a gateway transaction a REST API call has to be made to backend. This call will generate a Gateway Transaction Id which needs to be passed to the frontend web-sdk to launch the gateway.
URL: POST {{base_url}}/esign/v3/init/
{{base_url}}:
For Pre-Production Environment: https://preprod.aadhaarapi.com
For Production Environment: https://prod.aadhaarapi.com
Example Url: https://preprod.aadhaarapi.com/esign/v3/init/
qt_api_key: <<your api key value – available via Dashboard>>
qt_agency_id: <<your agency id value – available via Dashboard>>
Content-Type: application/json
{
"document": {
"data": "<<document data in based64 format>>",
"type": "<<pdf is only supported for now>>",
"info": "<<information about the document – minimum length 15>>"
},
"signerName": "<<name of the signer, must be same as on Aadhaar Card>>",
"signerCity": "<<city of the signer, preferably as mentioned in Aadhaar>>",
"purpose": "Purpose of transaction, Mandatory",
"responseURL": "<<POST[REST] URL to which response is to be sent after the transaction is complete>>"
}| Parameters | Description/Values | Checks |
|---|---|---|
| document { | Is an object that provides details of the document. It has below mentioned values in the object | |
| data | Show file differences that haven't been staged | Valid base64 formatted pdf |
| type | Format of the document. For now, only value pdf is supported | |
| info | Information about the document to be sent to ESP | Minimum length 15 |
| } | ||
| signerName | Name of the signer | Same as in Aadhaar Card |
| signerCity | Place of signing (Current City/As mentioned in Aadhaar) | |
| purpose | Purpose of document signature | Mandate as per norms. Will be used to generate consent text and logged in DB. |
| responseURL | POST API URL where the Agency receives the response after the e-signing is completed. | A valid POST API URL, else response back to your server will fail. |
You can also attach signature on all the pages of the document. The signature will be attached on the same coordinate of every page. In order to attach the signature on every page you need to provide signPageNumber as 0 in the init call.
{
"document": {
"data": "document data in based64 format",
"type": "pdf is only supported for now",
"info": "information about the document – minimum length 15",
"signPageNumber": 0,
"xCoordinate": 100,
"yCoordinate": 100
},
"signerName": "name of the signer, must be same as on Aadhaar Card",
"signerCity": "city of the signer, preferably as mentioned in Aadhaar",
"purpose": "Purpose of transaction, Mandatory",
"responseURL": "URL to which response is to be sent after the transaction is complete"
}
Depending on your requirement, you may or may not be using draggable signature option. If you are using the draggable signature option and if you provide the signPageNumber as 0 then the signature will be attached to all of the pages where user sets the drag position in the document.
{
"id": "<<transactionId>>",
"docs": ["<<document ID>>"],
"agreement": "Purpose for the signature",
"webhook_security_key": "<<security_key>>",
"createdAt": "<<timestamp>>"
}The above generated gateway transactionId has to be made available to frontend to open the gateway.
Note: A transaction is valid only for 45 mins after generation.
First, you might have to specify the environment in which you want the SDK to run. By default, production environment is picked if you forgot to specify any value. Valid environments are production and staging. To set the environment you call setEnvironment method from the provided SDK. This helps us to understand what type of transactions you are planning of doing.
<script>
zoop.setEnvironment("production"); // Use 'staging' for Preprod environment
</script>You can download or add the link to the CDN of our Web SDK. There are two function calls to open the gateway. They should called in the order mentioned in the docs. Firstly, to initiate the gateway you have to call zoop.eSignGatewayInit(gatewayOptions) with the gateway option. The next step would be to open the gateway. That can be done by simply calling zoop.eSignGateway(<<transaction_id>>) with the transaction ID generated in the init call. For your ease we have also added one sample example below.
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="UTF-8" />
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
<title>Your Site</title>
</head>
<body>
<!-- And add the code below into the body of your HTML -->
<div id="zoop-gateway-model">
<div id="zoop-model-content"></div>
</div>
<script src="./zoop-sdk.min.js"></script>
<script type="application/javascript">
// Name of the this function can be anything you want.
function openGateway() {
// To setup gateway UI to mach your application
zoop.eSignGatewayInit(gatewayOptions);
// Pass the transaction ID created at Init call and the version of the
// esign to be used, latest is v4.
zoop.eSignGateway(<<transaction_id>>, "v3");
}
</script>
</body>
</html>const gatewayOptions = {
company_display_name: "<<Add your company name here>>", //(required)
color_ft: "FFFFFF", //(optional)Add the hex for colour of text of company name
color_bg: "2C3E50", //(optional)Add the hex for background colour to be set for gateway.
logo_url: "https://your-square-product-logo-image-url-here.png", //(required)
otp_mode: "y", // (optional) default value is 'y'
fp_mode: "n", //(optional) default value 'y'
ir_mode: "n", //(optional) default value 'y',
phone_auth: "n", //(optional) default value 'n',
draggable_sign: "y", //(optional) default value ‘n’,
google_sign: "n", //(optional) default value ‘y’
customer_phone: "9999999999", // (optional) phone number to prefill,
mode: "POPUP", // (optional) open gateway in an iframe (POPUP) or in a new tab (TAB)
};Events are the way to acknowledge consumer of the SDK that something has happened. Listening of the events is same for each event.
<script>
zoop.on("close", (message) => {
// handle the event
});
zoop.on("esign-result", (message) => {
// handle the event
});
// and so on...
</script>The message parameter is an object which has action, payload, and isError properties.
| Event Name (action) | Occurs When | payload | isError |
|---|---|---|---|
close |
User manually clicks on the close icon | No | false |
consent-denied |
When user denies to it's consent for e-sign | No | false |
otp-error |
When the user enters wrong otp more than 3 times in e-sign | Yes | true |
gateway-error |
If gateway encounters an unexpected error | Yes | true |
esign-result |
When signed in attached to the PDF | Yes | Maybe |
The message that you will receive, in case of any type of event, may or may not have the payload property. In case of esign the payload would be one of the following.
When you receive an event named esign-result that may or may not be an error type. You can check whether the event is an error or not with isError property. If the value is true then it's a error response. In case of success you will receive success JSON response and for error you will receive error JSON response
The otp-error event occurs when the user has entred wrong OTP more than 3 times. The format of the payload is given below.
{
"message": "Maximum OTP Tries Reached, Transaction Failed",
"statusCode": 422
}When gateway encounters an unexpected error this event is fired. The format of payload is given below.
{
"message": "Transaction is already completed or errored out.",
"statusCode": "412"
}{
"id": "ed15fc9f-5880-4b98-9671-4d094e5a8fe8",
"response_timestamp": "2018-09-01T19:25:49.730Z",
"transaction_status": 16,
"public_ip": "223.196.31.62",
"signer_consent": "Y",
"request_medium": "W",
"last_document": true,
"current_document": 1,
"documents": [
{
"id": "9db76386-b6fe-4cc1-916b-52784a8fe777",
"index": 1,
"doc_info": "Sample pdf - sample doc",
"type": "pdf",
"dynamic_url": "<<Signed URL FOR PDF DOWNLOAD - valid for 48 hours>>",
"sign_status": "Y",
"auth_mode": "O",
"response_status": "Y",
"error_code": null,
"error_message": null,
"request_timestamp": "2018-09-01T19:25:49.730Z",
"signer_name_esp": "Mohak Talwar",
"signer_location_esp": "248198"
}
]
}| Response | Parameter Description/Possible Values |
|---|---|
| id | E-sign Transaction Id |
| response_timestamp | ESP response timestamp. |
| transaction_status | Status Code to track last transaction state. List of codes available in Annexure1. |
| signer_consent | Y/N - Will be N if user denies consent |
| request_medium | W for WEB/ M for Mobile - Platform from which esign transaction was performed |
| last_document | true/false- true if document is last else false |
| documents [ | Is an object that provides details of the single/multiple documents in array. It has below mentioned values in the object |
| { id | Document id |
| index | Index of this document |
| doc_info | Info of this document |
| type | Format of the document. For now, only value pdf is supported |
| dynamic_url | Url to download the signed pdf |
| sign_status | Y/N - if document is signed by the user or not |
| auth_mode | O/F/I – OTP, Fingerprint, Iris |
| response_status | Y/N - if ESP response was success or not. |
| error_message | Error message from ESP/Internal (available only in case of error) |
| request_timestamp } | Time at which the request was sent to ESP |
| ] |
{
"id": "5c34f783-7930-43b7-a5c8-34b5222398de",
"transaction_status": 17,
"public_ip": "223.196.31.62",
"signer_consent": "Y",
"request_medium": "W",
"current_document": 1,
"documents": [
{
"id": "1af9ffca-7c34-4bb0-b0ee-ad284b1fe4a4",
"index": 1,
"doc_info": "Sample pdf - sample doc",
"type": "pdf",
"sign_status": "N",
"auth_mode": "O",
"response_status": "N",
"error_code": "998",
"error_message": "Unknown error",
"request_timestamp": "2018-09-01T20:55:29.045Z"
}
],
"response_timestamp": "2018-09-01T20:55:29.045Z"
}| Response | Parameter Description/Possible Values |
|---|---|
| id | E-sign Transaction Id |
| response_timestamp | ESP response timestamp. |
| current_document | Current document number |
| signer_consent | Y/N - Will be N if user denies consent |
| request_medium | WEB/ANDROID - Platform from which esign transaction was performed |
| transaction_status | Status Code to track last transaction state. List of codes available in Annexure1. |
| documents [ | Is an object that provides details of the single/multiple documents in array. It has below mentioned values in the object |
| { id | Document id |
| index | Index of this document |
| doc_info | Info of this document |
| type | Format of the document. For now, only value pdf is supported |
| dynamic_url | Url to download the signed pdf |
| sign_status | Y/N - if document is signed by the user or not |
| auth_mode | O/F/I – OTP, Fingerprint, Iris |
| response_status | Y/N - if ESP response was success or not. |
| error_code | Error code from ESP/Internal (available only in case of error) |
| error_message | Error message from ESP/Internal (available only in case of error) |
| request_timestamp } | Time at which the request was sent to ESP |
| ] |
In case the POST API call to the response URL fails, there is an option to pull the transaction status from backend using the same Esign Transaction Id.
GET {{base_url}}/esign/v3/<<esign_transaction_id>>/fetch/
{
"id": "<<transaction id>>",
"signer_consent": "Y",
"response_url": "<<POST[REST] URL to which response is to be sent after the transaction is
complete>>",
"current_document": 1,
"signed_document_count": 1,
"public_ip": "223.196.31.21",
"env": 1,
"signer_name": "Demo Name",
"signer_city": "Demo City",
"purpose": "Development and testing purpose",
"transaction_status": 5,
"request_medium": "M",
"transaction_attempts": 1,
"otp_attempts": 1,
"otp_failures": 0,
"user_notified": "Y",
"response_to_agency": "Y",
"createdAt": "2018-08-03T08:43:39.751Z",
"documents": [
{
"id": "<<document id>>",
"index": 1,
"doc_info": "Sample pdf - sample doc",
"type": "pdf",
"dynamic_url": "<<Link to download this pdf>>",
"sign_status": "Y",
"auth_mode": "O",
"response_status": "Y",
"error_code": "<<error code if any>>",
"error_message": "<<error message if any>>",
"request_timestamp": "2018-08-03T08:47:50.661Z"
}
]
}| Response Parameter | Description/Possible Values |
|---|---|
| id | E-sign Transaction Id which will be used to open the gateway |
| signer_consent | Y/N - Will be N if user denies consent |
| signed_document_count | count of the number of documents signed |
| response_url | URL to which the response was sent on completion |
| current_document | Current document number |
| request_medium | W for Web/ M for Mobile - Platform from which esign transaction was performed |
| public_ip | End user IP using which the transaction was performed. |
| env | 1/2 – 1(preproduction) & 2 (production) |
| signer_name | Name of signer as provided in INIT call. |
| purpose | Purpose for signing the document |
| signer_city | City of signer as provided in INIT call. |
| transaction_status | Status Code to track last transaction state. List of codes available in Annexure1. |
| transaction_attempts | Transaction attempt count. Currently allowed only once. |
| otp_attempts | Number of times login OTP was requested |
| otp_failures | Number of times login failed due to wrong OTP |
| user_notified | Y/N - User gets notified about E-sign success and is sent a copy of the document to download |
| response_to_agency | Y/N - Response sent to responseURL, denotes success or failure |
| createdAt | Transaction initiated at - YYYY-MM-DDTHH:MM:SS.122Z |
| documents [ | Is an object that provides details of the single/multiple documents in array. It has below mentioned values in the object |
| { id | Document id |
| index | Index of document |
| doc_info | Info of the document |
| type | Format of the document. For now, only pdf is supported |
| dynamic_url | Url to download the signed pdf |
| sign_status | Y/N - if document is signed by the user or not |
| auth_mode | O/F/I – OTP, Fingerprint, Iris |
| response_status | Y/N - if ESP response was success or not. |
| error_code | Error code from ESP/Internal (available only in case of error) |
| error_message | Error message from ESP/Internal (available only in case of error) |
| request_timestamp }] | Time at which the request was sent to ESP |
| Message | Code |
|---|---|
| INITIATED | 1 |
| INITIATION_FAILED | 2 |
| OTP_SENT | 3 |
| OTP_FAILED | 4 |
| SUCCESSFUL | 5 |
| FAILED | 6 |
| OTP_MISMATCH | 7 |
| FP_MISMATCH | 8 |
| EXPIRED | 9 |
| CONSENT_DENIED | 10 |
| TERMINATED_BY_USER | 11 |
| OTP_REQUEST_LIMIT_CROSSED | 12 |
| OTP_FAILURE_LIMIT_CROSSED | 20 |
| OTP_EXPIRED | 13 |
| LOGIN_SUCCESS | 14 |
| ESP_REQ_INITIATED | 15 |
| ESP_REQ_SUCCESS | 16 |
| ESP_REQ_FAILED | 17 |
| USER_NOTIFIED | 18 |
| TRANSACTION_LIMIT_CROSSED | 19 |
Bank statement analyzer predicts the worthiness of an individual and his/her credibility for a loan, after analyzing a considerable number of bank transactions, with the assistance of complex algorithm, text extraction, data categorization and smart analysis techniques.
- At your backend server, Initiate the BSA transaction using a simple Rest API [POST] call. Details of these are available in the documents later. You will require API key and Agency Id for accessing this API which can be generated from the Dashboard.
- This gateway transaction id then needs to be communicated back to the frontend to our Web SDK.
- After adding the Web SDK in your project, client has to pass the above generated transaction id to an SDK function, called
zoop.initBsaGateway(<<transaction_id>>)which is to help us acknowladge about the transaction. - After the initialization of the transaction, to open the gateway, you have to call
zoop.openBsaGateway()function. - Once the transaction is successful or failed, the provided webhook will be called with the data about the transaction.
- Client will also have a REST API available to pull the status of a gateway transaction from backend.
To initiate a gateway transaction a REST API call has to be made to backend. This call will generate a Gateway Transaction Id which needs to be passed to the frontend web-sdk to launch the gateway.
URL: POST: {{base_url}}/bsa/v1/init
{{base_url}}:
For Pre-Production Environment: https://preprod.aadhaarapi.com
For Production Environment: https://prod.aadhaarapi.com
Example Url: https://preprod.aadhaarapi.com/bsa/v1/init
qt_api_key -- API key generated via Dashboard (PREPROD and PROD)
qt_agency_id -- Agency ID available from My account section in Dashboard
Content-Type: application/json
{
"mode": "REDIRECT",
"redirect_url": "https://yourdomain.com",
"webhook_url": "https://yourdomain.com/webhook",
"purpose": "load agreement",
"bank": "yesbank",
"months": 3
}| Parameters | Required | Description/Value |
|---|---|---|
| mode | true | REDIRECT or POPUP |
| redirect_url | true | A valid URL |
| webhook_url | true | A valid URL |
| purpose | true | Your purpose |
| bank | false | ICICI or YESBANK or HDFC or SBI or AXIS or KOTAK or SC |
| months | false | 1 - 12 |
Currently, supported banks are ICICI, YES BANK, HDFC, STATE BANK OF INDIA, AXIS, KOTAK, STANDARD CHARTERED.
{
"id": "<<transaction_id>>",
"mode": "REDIRECT",
"env": "PRODUCTION",
"webhook_security_key": "<<UUID>>",
"request_version": "1.0",
"request_timestamp": "2020-02-17T13:14:26.423Z",
"expires_at": "2020-02-17T13:24:26.423Z"
}The above generated gateway transactionId is needed to make open gateway via BSA SDK.
Note: A transaction is valid only for 10 mins after generation.
{
"statusCode": 400,
"errors": [],
"message": "<<message about the error>>"
}You can download or add the link to the CDN of our Web SDK. There are two function calls to open the gateway. They should called in the order mentioned in the docs. Firstly, to initiate the gateway you have to call zoop.initBsaGateway(<<transaction_id>>) with the transaction ID generated in the init call. The next step would be to open the gateway. That can be done by simply calling zoop.openBsaGateway() function. You don't need to provided the transaction ID here as you have already mentioned in initBsaGateway. For your ease we have also added one simple example below.
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="UTF-8" />
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
<title>Your Site</title>
</head>
<body>
<script src="./zoop-sdk.min.js"></script>
<button onclick="openGateway()">Open BSA Gateway</button>
<script type="application/javascript">
// Name of the this function can be anything you want.
function openGateway() {
// Pass Transaction ID here.
zoop.initBsaGateway("<<transaction_id>>");
// Call this function to open the gateway
zoop.openBsaGateway();
}
</script>
</body>
</html>The webhook response will be sent to webhook_url provided at the init call. You might receive multiple responses for a single transaction. The response(s) will be send when the user start any kind of interaction with the gateway. When receiving the webhook response please match the webhook_security_key in the header of the request to be the same as the one provided in the init call. If they are not the same you must abandon the webhook response.
{
"id": "<<transaction_id>>",
"mode": "REDIRECT",
"env": "PRODUCTION",
"bank": "YESBANK",
"response_code": "101",
"response_message": "Transaction Successful",
"last_user_stage_code": "<<Stage Code>>",
"last_user_stage": "<<Stage>>",
"request_version": "1.0",
"request_medium": "<<web | android | ios>>",
"sdk_name": "1",
"report_url": "https://url-for/file.xlsx",
"data": {
"metadata": {
"acc_number": "<<account_number>>",
"acc_name": "<<account_holder_name>>",
"no_of_transactions": "<<transaction_counts>>",
"dates": {
"first_transaction_date": "2019-08-26",
"last_transaction_date": "2020-02-16",
"statement_start_date": "2019-08-19",
"statement_end_date": "2020-02-18"
}
},
"transactions": [
{
"date": "2019-03-17",
"value_date": "2019-03-17",
"chq": "",
"particulars": "UPI/123123123/From:upi@ybl/To:upi@ybl/Payment from PhonePe",
"balance": 100,
"amount": 100,
"label": "CREDIT",
"validation": true
},
{
"date": "2019-03-17",
"value_date": "2019-03-17",
"chq": "907632321560",
"particulars": "PCA:123123123:123123123:GOOGLE *SERVICES g.co/helppay# CA",
"balance": 99,
"amount": 1,
"label": "DEBIT",
"validation": true
}
]
}
}{
"id": "<<transaction_id>>",
"mode": "REDIRECT",
"env": "PRODUCTION",
"bank": "SBI",
"response_code": "651",
"response_message": "Technical Error",
"last_user_stage_code": "<<Stage Code>>",
"last_user_stage": "<<Stage>>",
"request_version": "1.0",
"request_medium": "<<web | android | ios>>",
"sdk_name": "1",
"error": {
"code": "<<error_code>>",
"message": "<<error_message>>"
}
}| Code | Billable | Message |
|---|---|---|
| 101 | true | Transaction Success |
| 99 | false | Unknown Error |
| 651 | false | Technical Error |
| 652 | false | Session Closed |
| 653 | false | Bank Server Unresponsive Error |
| 654 | false | Consent Denied Error |
| 655 | false | Document Parsing Error |
| 656 | false | Validity Expiry Error |
| 657 | false | Authentication Error |
| 658 | false | No Entry Found Error |
| 659 | false | Stage Timeout Error |
| 660 | false | Session Closed On Retry |
| 661 | false | Login Attempts Exceeded Error, |
| 662 | false | Captcha Attempts Exceeded Error, |
| 663 | false | OTP Attempts Exceeded Error, |
| 664 | false | Answer-Attempts Exceeded Error, |
| 670 | false | No Session Found Error |
| 671 | false | Error Not Recorded |
After creating an initialization request successfully you can check at which stage your transaction is currently.
GET: {{base_url}}/bsa/v1/stage/<<transaction_id>>
{
"id": "<<transaction_id>>",
"mode": "REDIRECT",
"env": "PRODUCTION",
"request_version": "1.0",
"response_code": "101",
"response_message": "Transaction Successful",
"bank": "SBI",
"last_user_stage": "login_opened",
"last_user_stage_code": "LO"
}| Code | Stage |
|---|---|
| LO | login_opened |
| F | failed |
| LS | login_success |
| AS | account_selected |
| SD | statement_downloaded |
| SP | statement_parsed |
| TS | transaction_successful |
| TI | transaction_initiated |
| VC | validated_captcha |
| VO | validated_otp |
| VS | validated_security_answer |
{
"statusCode": 404,
"errors": [],
"message": "transaction id not found in our records"
}Income Tax Department holds and verifies the earnings and tax related information of an individual. Income tax return is a form where a person submits information about his income earned and the tax paid to the Department. Whereas 26AS is a consolidated annual tax credit statement of an individual's earnings as per the ITD records. The Zoop ITD Gateway allows you to fetch and verify the financial information of your client in order to make better business decisions.
- At your backend server, Initiate the ITD transaction using a simple POST Rest API call. Details of these are available in the documents later. You will require API key and Agency Id for accessing this API which can be generated from the Dashboard. This gateway transaction id then needs to be communicated back to the frontend to our Web SDK.
- This gateway transaction id then needs to be communicated back to the frontend to our Web SDK.
- After adding the Web SDK in your project, client has to pass the above generated transaction id to an SDK function, called
zoop.initItdGateway(gatewayOption)which is to help us to under different requirement of the gateway you are trying to open. - After the initialization of the transaction, to open the gateway, you have to call
zoop.openItdGateway(<<transaction_id>>)function. - Once the transaction is successful or failed, the provided webhook will be called with the data about the transaction.
- Client will also have a REST API available to pull the status of a gateway transaction from backend.
To initiate a gateway transaction a REST API call has to be made to backend. This call will generate a Gateway Transaction Id which needs to be passed to the frontend web-sdk to launch the gateway.
URL: POST: {{base_url}}/itd/v2/init
{{base_url}}:
For Pre-Production Environment: https://preprod.aadhaarapi.com
For Production Environment: https://prod.aadhaarapi.com
Example Url: https://preprod.aadhaarapi.com/itd/v2/init
qt_api_key -- API key generated via Dashboard (PREPROD and PROD)
qt_agency_id -- Agency ID available from My account section in Dashboard
Content-Type: application/json
{
"mode": "POPUP",
"webhook_url": "https://your-website.com/webhook",
"redirect_url": "https://your-website.com",
"purpose": "testing",
"phone": "9999999999",
"dob": "01-01-1990",
"phone_override": false,
"document_required": {
"ITR": 1,
"26AS": 2
},
"pan": "ABCDE1234F"
}| Parameters | Mandatory | Description/Value |
|---|---|---|
| mode | true | REDIRECT or POPUP |
| redirect_url | false | A valid URL |
| webhook_url | true | A valid POST API URL, Detailed response will be sent here for success or failures |
| purpose | true | The reason for the transaction |
| phone_override | false | If you wanted to update your phone number |
| document_required | true | The document for which you wanted to get the details |
| { ITR | false | Specify for how many years of ITR you wanted to fetch |
| 26AS } | false | Specify for how many years of 26AS you wanted to fetch |
| phone | true | Phone number you wanted to use at our platform |
| pan | true | PAN number linked to ITR portal |
| dob | true | Date of birth of the PAN holder in DD-MM-YYYY format |
NOTE: If an existing user submits invalid combination of Phone registered against PAN and DOB. We will return an error that PAN is already linked with a different phone number ******1234 with last 4 digits of correct phone number.
In such scenario if the user doesn't have the phone number then they need to login into Income Tax Department (ITD) Portal using their ID password and remove us as e-Return Intermediary using this process.
After that you need to provided phone_override as true to evade the error.
New User - New unique user being added to the ITD Portal for ITR and/or 26AS verification for the first time via ZOOP.ONE
Existing User - User that was added to ITD by ZOOP.ONE to verify and fetch ITR and/or 26AS details, has been requested for re-verification of documents for the user on the same credentials as stored in ZOOP.ONE system earlier.
{
"id": "<<transaction_id>>",
"mode": "POPUP",
"env": "production",
"request_version": "2.0",
"webhook_security_key": "<<security_key>>",
"request_timestamp": "2020-10-13T09:34:02.204Z",
"expires_at": "2020-10-13T09:44:02.194Z"
}The above generated gateway transactionId is needed to make open gateway via WEB SDK.
Note: A transaction is valid only for 10 mins after generation.
{
"error": {
"reason_message": "PAN is invalid",
"reason_code": "INVALID_PAN"
}
}Here are the list of reason code and message that you might receive if there is an error while making the init call.
| Reason Code | Reason Message |
|---|---|
| MISSING_MODE | Mode is required |
| INVALID_MODE | Mode should either be POPUP or REDIRECT |
| MISSING_REDIRECT_URL | Redirect URL is required when mode is REDIRECT |
| INVALID_REDIRECT_URL | Redirect URL is invalid |
| MISSING_PAN | PAN number is required |
| INVALID_PAN | PAN is invalid |
| MISSING_PHONE_NUMBER | Phone number is required |
| INVALID_PHONE_NUMBER | Phone number is invalid |
| MISSING_DATE_OF_BIRTH | Date of birth is required |
| INVALID_DATE_OF_BIRTH | Date of birth is invalid |
| MISSING_WEBHOOK_URL | Webhook URL is required |
| INVALID_WEBHOOK_URL | Webhook URL is invalid |
| MISSING_PURPOSE | Purpose is required |
| INVALID_PURPOSE | Purpose should be with 1000 characters |
| INVALID_PHONE_OVERRIDE | Phone override should be boolean |
| INVALID_ITR_DOCUMENT_REQUIRED | ITR duration should be between 1 to 3 years |
| MAX_DURATION_REACHED_ITR | ITR should be maximum of 3 years |
| MAX_DURATION_REACHED_26AS | 26AS should be maximum of 2 years |
| INVALID_26AS_DOCUMENT_REQUIRED | 26AS duration should be between 1 to 2 years |
| MISSING_DOCUMENT_REQUIRED | Required document should either be ITR or 26AS or both |
| PAN_LINKED_WITH_DIFFERENT_NUMBER | PAN is already linked with a different phone number ******0797 |
| DATE_OF_BIRTH_MISMATCH | Provided date of birth (1995-05-19) did not match with existing data |
| SOMETHING_WENT_WRONG | Something went wrong |
After generating the transaction id, at any point in time to get the details about the transaction state you can use this API.
URL: GET: {{base_url}}/itd/v2/fetch/<<transaction_id>>
After successful response you will receive the following JSON
{
"org": {
"id": "<<your org id>>",
"name": "<<your org name>>"
},
"last_user_stage_code": "TXN_INITIALIZED",
"itr_requested": true,
"26as_requested": true,
"request_version": "2.0",
"phone_override": false,
"otp_resend_count": 0,
"otp_verify_count": 0,
"mode": "POPUP",
"pan": "ABCDE1234F",
"consent_text": "By clicking \"Submit\" you allow ZOOP.ONE to fetch ITR and 26AS and submit to YOUR COMPANY for testing",
"env": "production",
"webhook_security_key": "<<some secure key>>",
"26as_duration": 2,
"itr_duration": 1,
"webhook_url": "https://your-website.com/webhook",
"redirect_url": "https://your-website.com",
"id": "<<transaction_id>>",
"itr_response_sent": false,
"phone": "9999999999",
"dob": "01-01-1990",
"26as_response_sent": false,
"request_timestamp": "2020-10-12T11:26:07.398Z"
}You can download or add the link to the CDN of our Web SDK. There are two function calls to open the gateway. They should called in the order mentioned in the docs. Firstly, to initiate the gateway you have to call zoop.initItdGateway(gatewayOption) with the gateway option to modify the gateway UI. The next step would be to open the gateway. That can be done by simply calling zoop.openItdGateway(<<transaction_id>>) and pass the transaction id generated in the init call first parameter. For your ease we have also added one simple example below.
Playground: Codesandbox
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="UTF-8" />
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
<title>Your Site</title>
</head>
<body>
<button onclick="openGateway()">Open ITD</button>
<div id="zoop-gateway-model">
<div id="zoop-model-content" style="height: 500px;"></div>
</div>
<script src="./zoop-sdk.min.js" type="text/javascript"></script>
<script>
const gatewayOption = {
txt_color: "rgb(102,102,102)",
bg_color: "rgb(243,243,243)",
btn_color: "rgb(0,105,180)",
btn_txt_color: "rgb(255,255,255)",
logo_url: "https://your-awesome-logo.png"
};
// Name of the this function can be anything you want.
function openGateway() {
// The following event will be fired in case of any error received
zoop.on("itd-error", (message) => {
// If any error happen then this errorCode will be passed to the user
console.log(message);
});
// The following event will be fired once ITR pulled successfully
zoop.on("itd-success", (message) => {
// If any error happen then this errorCode will be passed to the user
console.log(message);
});
// The below event fires when user denies the consent of moving the transaction forward
zoop.on("itd-consent-denied", (message) => {
console.log(message);
});
// The below event fires when user deliberately closed the ongoing transaction
zoop.on("itd-gateway-terminated", (message) => {
console.log(message);
});
// Set the environment
zoop.setEnvironment("staging"); // use "production" for the production environment
// Pass gateway option to modify UI here.
zoop.initItdGateway(gatewayOption);
// Call this function with transaction ID to open the gateway
zoop.openItdGateway("<<transaction_id>>");
}
</script>
</body>
</html>The options parameter that is passed while calling zoop.initItdGateway has the following format.
const gatewayOption = {
txt_color: "rgb(102,102,102)", // The text color
bg_color: "rgb(243,243,243)", // The background color
btn_color: "rgb(0,105,180)", // Color of the button
btn_txt_color: "rgb(255,255,255)", // Color of the text in button
logo_url: "https://your-awesome-logo.png" // The URL of your logo
};NOTE: We pass the provided values through URL and because of that support of HEX color values are not present. You can provide alternative color formats like rgb, rgba, hsl, hsla etc.
There are two events to acknowledge of the ongoing transaction to your frontend. On success itd-success event will be fired and respective callback will executed, similarly itd-error will be fired in case of any error in the transaction. You find the usage in the provided demo.
When ITR pulling is successful this event is fired and you will receive the message on the respective registered callback function. The message is an object with action and payload property on it.
The payload has id, response_code, and response_message properties.
| response_code | response_message |
|---|---|
| TRANSACTION_SUCCESSFUL | Transaction Successful |
{
"action": "itd-success",
"payload": {
"id": "<<transaction_id>>",
"response_code": "101",
"response_message": "Transaction Successful"
}
}This event is fired when any error occurred while processing the transaction and respective callback is called and message parameter is passed. The message is an object with action and payload property on it.
The payload has id and error. The error object has reason_code, reason_message, response_code, and response_message properties.
{
"action": "itd-error",
"payload": {
"id": "<<transaction_id>>",
"error": {
"reason_code": "ITD_PAN_ALREADY_ADDED",
"reason_message": "PAN Number already added with Income Tax Department",
"response_code": "106",
"response_message": "Invalid combination of inputs"
}
}
}These are the values that you may receive in case there is an error while processing the transaction. Please note that for some errors you might not receive response_code and response_message that's why they are undefined.
| reason_code | reason_message | response_code | response_message |
|---|---|---|---|
| INTERNAL_ERROR | Something went wrong | 111 | Internal Error |
| TXN_EXPIRED | Transaction expired | undefined |
undefined |
| TXN_COMPLETED | Transaction Successfully Completed | undefined |
undefined |
| TXN_IN_QUEUE | Transaction is already in progress | undefined |
undefined |
| TXN_OTP_LIMIT_EXHAUSTED | Transaction is already finished with error | undefined |
undefined |
| TXN_NOT_FOUND | Transaction not found | undefined |
undefined |
| ITD_PAN_ALREADY_ADDED | PAN Number already added with Income Tax Department | 106 | Invalid combination of inputs |
| ITD_PAN_NOT_EXIST | Unable to fetch the PAN Number entered from the Income Tax records | 101 | No Records Found |
| ITD_DOB_MISSING | Date of birth missing | 106 | Invalid combination of inputs |
| ITD_INVALID_DOB_PATTERN | Invalid date of birth pattern | 106 | Invalid combination of inputs |
| ITD_INVALID_DOB | Date of birth invalid | 106 | Invalid combination of inputs |
| ITD_INVALID_PAN_FORMAT | PAN format invalid | 106 | Invalid combination of inputs |
| ITD_PAN_NOT_REGISTERED | Unable to fetch the PAN Number entered from the Income Tax records | 101 | No Records Found |
| ITD_MOBILE_OTP_EMPTY | Mobile OTP required | 106 | Invalid combination of inputs |
| ITD_EMAIL_OTP_EMPTY | Email OTP required | 106 | Invalid combination of inputs |
| ITD_INVALID_MOBILE_OTP | Mobile OTP is invalid | 106 | Invalid combination of inputs |
| ITD_INVALID_EMAIL_OTP | Email OTP is invalid | 106 | Invalid combination of inputs |
| ITD_INCORRECT_OTP | Email and Mobile OTP invalid | 106 | Invalid combination of inputs |
This event is fired when user don't want to agree going ahead with the transaction and explicitly Deny the transaction in the gateway. The respective callback is called and message parameter is passed. The message is an object with action and payload property on it.
The payload has id, response_code, and response_message properties.
| response_code | response_message |
|---|---|
| CONSENT_DENIED | Consent Denied |
{
"action": "itd-consent-denied",
"payload": {
"id": "<<transaction_id>>",
"response_code": "CONSENT_DENIED",
"response_message": "Consent Denied"
}
}This event is fired when user explicitly closed the an ongoing transaction. The respective callback is called and message parameter is passed. The message is an object with action and payload property on it.
The payload has id, response_code, and response_message properties.
| response_code | response_message |
|---|---|
| GATEWAY_TERMINATED | Gateway Terminated |
{
"action": "itd-gateway-terminated",
"payload": {
"id": "<<transaction_id>>",
"response_code": "GATEWAY_TERMINATED",
"response_message": "Gateway Terminated"
}
}The webhook response will be sent to webhook_url provided at the init call. When receiving the webhook response please match the webhook_security_key in the header of the request to be the same as the one provided in the init call. If they are not the same you must abandon the webhook response.
{
"id": "<<transaction_id>>",
"pan_id": "ABCDE1234F",
"result": {
"2019-20": {
"PersonalInfo": {
"Name": " String ",
"Father Name": "Sanjay Bansal",
"AssesseeName": {
"FirstName": " Rajat ",
"MiddleName": " ",
"LastName": " Bansal "
},
"PAN": " ABCDE1234F ",
"DOB": "25-10-1992",
"Status": "Active",
"AadhaarCardNo": "**** **** 9876",
"EmployerCategory": " Government/Public sector undertaking/Pensioners/Others ",
"Address": {
"ResidenceNo": " H.NO 89 DWARKA NAGAR COACH FACTORY",
"ResidenceName": "Rajat Bansal",
"RoadOrStreet": "Old post office",
"LocalityOrArea": " DWARKA NGAR",
"CityOrTownOrDistrict": " BHOPAL",
"State": " MADHYA PRADESH",
"PinCode": " 462010",
"MobileNo": "9999999999",
"EmailAddress": " [email protected] ",
"Country": "India"
}
},
"ITR1_IncomeDeductions": {
"Salary": " Integer ",
"IncomeFromSal": " 452000",
"AlwnsNotExempt": " 0 ",
"PerquisitesValue": " 0 ",
"ProfitsInSalary": " 0 ",
"DeductionUs16": " 40000 ",
"TotalIncomeOfHP": " 0 ",
"IncomeOthSrc": " 0 ",
"GrossTotIncome": " 412000",
"TotalIncome": " 0 ",
"UsrDeductUndChapVIA": {
"Section80C": " 0 ",
"Section80CCC": " 0 ",
"Section80CCDEmployeeOrSE": " 0 ",
"Section80CCD1B": " 0 ",
"Section80CCDEmployer": " 0 ",
"Section80CCG": " 0 ",
"Section80DD": " 0 ",
"Section80DDB": " 0 ",
"Section80E": " 195000 ",
"Section80EE": " 0 ",
"Section80G": " 0 ",
"Section80GG": " 30000 ",
"Section80GGA": " 0 ",
"Section80GGC": " 0 ",
"Section80RRB": " 0 ",
"Section80QQB": " 0 ",
"Section80TTA": " 0 ",
"Section80U": " 0 ",
"TotalChapVIADeductions": " 225000",
"TotalIncome": " 187000 ",
"Section80DHealthInsPremium": {
"Sec80DHealthInsurancePremiumUsr": " 0 ",
"Sec80DMedicalExpenditureUsr": " 0 ",
"Sec80DPreventiveHealthCheckUpUsr": " 0 "
}
}
},
"TaxesPaid": {
"TCS": " 0 ",
"TDS": " 0 ",
"OthersInc": {
"SEC 10-5-LeaveTravelAllowance": " 0 ",
"SEC 10-14-i": " 0 ",
"SEC 10-13-A": " 0 "
},
"TotalTaxesPaid": " 15000 ",
"SelfAssessmentTax": " 0 ",
"AdvanceTax": " 0 "
},
"BalTaxPayable": " Integer ",
"ITR1_TaxComputation": {
"TotalIntrstPay": " 0 ",
"Section89": " 0 ",
"NetTaxLiability": " 0 ",
"Rebate87A": " 0 ",
"GrossTaxLiability": " 0 ",
"TotalTaxPayable": " 0 ",
"TotTaxPlusIntrstPay": " 0 ",
"TaxPayableOnRebate": " 0 ",
"EducationCess": " 0 ",
"IntrstPay": {
"IntrstPayUs234A": " 0 ",
"IntrstPayUs234C": " 0 ",
"IntrstPayUs234B": " 0 "
}
},
"refund": {
"RefundDue": "15000",
"BankAccountDtls": {
"PriBankDetails": {
"IFSCCode": " ICIC0000558",
"BankName": " ICICI BANK LIMITED",
"BankAccountNo": " 055811234556"
}
},
"employer": {
"tan": " abcde123456",
"Name of deductor": "Zoop.one",
"Salary": " 240000",
"Tax Deducted": "15000"
}
}
}
},
"event": "itr.processed",
"request_timestamp": "2020-10-12T11:54:21.249Z",
"response_timestamp": "2020-10-12T11:58:25.689Z"
}{
"id": "<<transaction_id>>",
"pan_id": "ABCDE1234F",
"result": {
"2020-21": {
"metadata": {
"pan": "ABCDE1234F",
"current status of pan": "Active",
"financial year": "2020-21",
"assessment year": "2021-22",
"name of assessee": "ASSESSEE NAME",
"address of assessee": "ASSESSEE FULL ADDRESS"
},
"accordions": {
"part_a": {
"name": "Details of Tax Deducted at Source",
"entries": [
{
"sr_no": 1,
"deductor_name": "YOUR CO. PRIVATE LIMITED",
"tan": "ABCDE1234F",
"total_amount_credited": "100000.00",
"total_tax_deducted": "1000.00",
"total_tds_deposited": "1000.00",
"transactions": [
{
"sr_no": 1,
"section": "192",
"transaction_date": "30-Jun-2020",
"booking_status": "F",
"booking_date": "21-Jul-2020",
"remarks": "-",
"amount_credited": "10000.00",
"tax_deducted": "1000.00",
"tds_deposited": "1000.00"
},
{
"sr_no": 2,
"section": "192",
"transaction_date": "31-May-2020",
"booking_status": "F",
"booking_date": "21-Jul-2020",
"remarks": "-",
"amount_credited": "10000.00",
"tax_deducted": "1000.00",
"tds_deposited": "1000.00"
},
{
"sr_no": 3,
"section": "192",
"transaction_date": "30-Apr-2020",
"booking_status": "F",
"booking_date": "21-Jul-2020",
"remarks": "-",
"amount_credited": "10000.00",
"tax_deducted": "1000.00",
"tds_deposited": "1000.00"
}
]
}
]
},
"part_a1": {
"name": "Details of Tax Deducted at Source for 15G / 15H",
"entries": []
},
"part_a2": {
"name": "Details of Tax Deducted at Source on Sale of Immovable Property u/s 194IA/ TDS on Rent of Property u/s 194IB / TDS on payment to resident contractors and professionals u/s 194M (For Seller/Landlord of Property/Payee of resident contractors and professionals)",
"entries": []
},
"part_b": {
"name": "Details of Tax Collected at Source",
"entries": []
},
"part_c": {
"name": "Details of Tax Paid (other than TDS or TCS)",
"entries": []
},
"part_d": {
"name": "Details of Paid Refund",
"entries": []
},
"part_e": {
"name": "Details of SFT Transaction",
"entries": []
},
"part_f": {
"name": "Details of Tax Deducted at Source on Sale of Immovable Property u/s 194IA/ TDS on Rent of Property u/s 194IB /TDS on payment to resident contractors and professionals u/s 194M (For Buyer/Tenant of Property /Payer of resident contractors and professionals)",
"entries": []
},
"part_g": {
"name": "TDS Defaults* (Processing of Statements)",
"entries": []
}
}
},
"2019-20": {
"metadata": {
"pan": "ABCDE1234F",
"current status of pan": "Active",
"financial year": "2019-20",
"assessment year": "2020-21",
"name of assessee": "ASSESSEE NAME",
"address of assessee": "ASSESSEE ADDRESS"
},
"accordions": {
"part_a": {
"name": "Details of Tax Deducted at Source",
"entries": [
{
"sr_no": 1,
"deductor_name": "YOUR CO. PRIVATE LIMITED",
"tan": "ABCDE1234F",
"total_amount_credited": "100000.00",
"total_tax_deducted": "1000.00",
"total_tds_deposited": "1000.00",
"transactions": [
{
"sr_no": 1,
"section": "192",
"transaction_date": "01-Apr-2019",
"booking_status": "F",
"booking_date": "30-Jun-2020",
"remarks": "-",
"amount_credited": "100000.00",
"tax_deducted": "1000.00",
"tds_deposited": "1000.00"
}
]
}
]
},
"part_a1": {
"name": "Details of Tax Deducted at Source for 15G / 15H",
"entries": []
},
"part_a2": {
"name": "Details of Tax Deducted at Source on Sale of Immovable Property u/s 194IA/ TDS on Rent of Property u/s 194IB / TDS on payment to resident contractors and professionals u/s 194M (For Seller/Landlord of Property/Payee of resident contractors and professionals)",
"entries": []
},
"part_b": {
"name": "Details of Tax Collected at Source",
"entries": []
},
"part_c": {
"name": "Details of Tax Paid (other than TDS or TCS)",
"entries": []
},
"part_d": {
"name": "Details of Paid Refund",
"entries": []
},
"part_e": {
"name": "Details of SFT Transaction",
"entries": []
},
"part_f": {
"name": "Details of Tax Deducted at Source on Sale of Immovable Property u/s 194IA/ TDS on Rent of Property u/s 194IB /TDS on payment to resident contractors and professionals u/s 194M (For Buyer/Tenant of Property /Payer of resident contractors and professionals)",
"entries": []
},
"part_g": {
"name": "TDS Defaults* (Processing of Statements)",
"entries": []
}
}
}
},
"event": "26as.processed",
"request_timestamp": "2020-10-13T10:48:52.791Z",
"response_timestamp": "2020-10-13T10:56:34.257Z"
}This is a sample of the error request you will receive on the webhook_url
provided in the init call.
{
"id": "<<transaction_id>>",
"pan_id": "ABCDE1234F",
"event": "itr.failed",
"error": {
"response_code": "111",
"response_message": "Internal Error",
"reason_code": "INTERNAL_ERROR",
"reason_message": "Something went wrong"
},
"request_timestamp": "2020-10-12T16:25:20.409Z",
"response_timestamp": "2020-10-12T16:28:13.979Z"
}To differentiate when and for which product you have received the webhook, you
can use the event property present in the webhook request. Here is a table
where it's mentioned that which event type you will receive for which product.
If any error occurred in the gateway you will receive txn.failed and for
successfully completion on the gateway you will receive txn.completed.
| Event | ITR | 26AS |
|---|---|---|
| txn.completed | Yes | Yes |
| txn.failed | Yes | Yes |
| itr.failed | Yes | No |
| itr.processed | Yes | No |
| 26as.failed | No | Yes |
| 26as.processed | No | Yes |
In case of error you might receive these values in the reason_code, reason_message, response_code, and response_message.
| reason_code | reason_message | response_code | response_message |
|---|---|---|---|
| INTERNAL_ERROR | Something went wrong | 111 | Internal Error |
| SOURCE_ERROR | Unable to reach the source at this time. Please try after sometime. | 108 | Source Error |
| PAN_NOT_ADDED | PAN access was removed by customer | 111 | Internal Error |
| SOURCE_DOWN | Unable to reach the source at this time. Please try after sometime. | 110 | Source Down |
| PARSING_FAILED | Unable to fetch details from source file | 111 | Internal Error |
| PARSING_FAILED | Unable to fetch details from source file | 111 | Internal Error |
| ITD_PAN_ALREADY_ADDED | PAN Number already added with Income Tax Department | 106 | Invalid combination of inputs |
| ITD_PAN_NOT_EXIST | Unable to fetch the PAN Number entered from the Income Tax records | 101 | No Records Found |
| ITD_DOB_MISSING | Date of birth missing | 106 | Invalid combination of inputs |
| ITD_INVALID_DOB_PATTERN | Invalid date of birth pattern | 106 | Invalid combination of inputs |
| ITD_INVALID_DOB | Date of birth invalid | 106 | Invalid combination of inputs |
| ITD_INVALID_PAN_FORMAT | PAN format invalid | 106 | Invalid combination of inputs |
| ITD_PAN_NOT_REGISTERED | Unable to fetch the PAN Number entered from the Income Tax records | 101 | No Records Found |
| ITD_MOBILE_OTP_EMPTY | Mobile OTP required | 106 | Invalid combination of inputs |
| ITD_EMAIL_OTP_EMPTY | Email OTP required | 106 | Invalid combination of inputs |
| ITD_INVALID_MOBILE_OTP | Mobile OTP is invalid | 106 | Invalid combination of inputs |
| ITD_INVALID_EMAIL_OTP | Email OTP is invalid | 106 | Invalid combination of inputs |
| ITD_INCORRECT_OTP | Email and Mobile OTP invalid | 106 | Invalid combination of inputs |
In case you are facing any issues with integration please open a ticket on our support portal