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
Mobile number of user.
Character length : 10
Eg: 9876543210
Country code for the mobile number.
Character length : 2
Eg: 91
Date of birth of user.
Format - YYYY-MM-DD
Eg: 2020-11-20
Request format
{
"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
The status against the request.
Allowed values: SUCCESS
FAILED
Response format
{
"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
Failed
2011
- No active account found.
2012
- Account not found for user.
2014
- Mobile number not found.