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

{
    "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"
    }
}

Decrypted

{
    "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

{
    "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"
    }
}

SUCCESS

{
    "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": {}
    }
}

FAILED

{
    "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.