Account Fetch

The entity uses this webhook to authenticate the user with the requested data and return the corresponding response.
INFO
The same webhook is also used to get the latest status of user accounts.
MANDATORY
A supplementary request to Add Account API is required if the user verification is successful.

Request

You must add an accountFetch callback URI to the webhook profile to receive requests from us.

Parameters

Parameter
Type
Description
data
Object
mobile
String
Mobile number of user. Character length : 10 Eg: 9876543210
country_code
String
Country code for the mobile number.
Character length : 2
Eg: 91
dob
String
Date of birth of user. Format - YYYY-MM-DD Eg: 2020-11-20

Request format

Encrypted
Decrypted
{
"head": {
"api": "accountFetch",
"apiVersion": "V1",
"timeStamp": "2022-11-10T09:51:19Z"
},
"encrypted_data": {
"cipher_text": "N5PgO46OpXLwLgOMzVtJ/+7GRkJLM5dclE70kIk1AR/AI/pN0lOhQp/EY1z9DNf9d6XYLGaRtZ+nJra9Y7O19nEkXuqtLqV1vkd7stqcFNv7n2kdQ/6uxftakaVOqf3K",
"iv": "99976e931502610b",
"hash": "a98b034ca359ceebf1fe8f0d707dd6885e768cc1e5b9ff878c8f847a10bd9579"
}
}
{
"head": {
"api": "accountFetch",
"apiVersion": "V1",
"timeStamp": "2022-11-10T09:51:19Z"
},
"content": {
"data": {
"country_code": "91",
"mobile": "1111111131",
"dob": "2022-11-01"
}
}
}

Response

MANDATORY
All parameters in the response are required to proceed.

Parameters

Parameter
Type
Description
head
Object
HTTP_CODE
Integer
HTTP response status codes. Refer
result
Object
code
Integer
Result code for the response. Find result codes
status
String
The status against the request. Allowed values: SUCCESS FAILED

Response format

Encrypted
SUCCESS
FAILED
{
"head": {
"api": "accountFetch",
"apiVersion": "V1",
"timeStamp": "2022-11-10 03:21:19 PM",
"HTTP_CODE": 200
},
"encrypted_data": {
"cipher_text": "ySrmqBE29bZpwzbIPVDj4cDXPi02g1KQv6MKU/izfynyrrsAKEPoma59sWc9y0JK+LKnB3xss+jBVReeoa2n5eSTHx4gjgAOWmR8TII+M38uj6NA806NRmk/vpT2wpJGYlPdC2YvG9hGBSY7HI1fdizrfsYIEG7WVaaQF11VOOE=",
"iv": "683ef91b74359866",
"hash": "b861c6e04f0f527cedfb36e8839edb8011a8a9fe54997d23e6c263b6f2a13fe4"
}
}
{
"head": {
"api": "accountFetch",
"apiVersion": "V1",
"timeStamp": "2022-11-10 03:21:19 PM",
"HTTP_CODE": 200
},
"content": {
"result": {
"code": 1001,
"status": "SUCCESS",
"message": "The request is successfully processed"
},
"data": {}
}
}
{
"head": {
"api": "accountFetch",
"apiVersion": "V1",
"timeStamp": "2022-11-10 03:21:19 PM",
"HTTP_CODE": 200
},
"content": {
"result": {
"code": 2011,
"status": "FAILED",
"message": "No active account found"
},
"data": {}
}
}

Result Code

Success
  • 1001 - SUCCESS
Failed
  • 2011 - No active account found.
  • 2012 - Account not found for user.
  • 2013 - DOB mismatch.
  • 2014 - Mobile number not found.