Guides

CHECK_USER

This API takes PAN number as input to check if the user already exists or is new to selected bank. If a user already exists with the bank, it returns user status as "CIF_CREATED", else returns "NEW".

Note: At this point, a new user will not have a user ID in Falcon's systems. Hence this function takes the customer's Phone Number instead of the user ID.

Request

    payload: {
     		"pan": "HCEPH2517M",
        "email": "[email protected]",
        "phone": "8923833875",
        "isEmailVerified": "YES",
        "isPhoneVerified": "YES",
        "phoneVerificationDate": "2021-03-15 10:10:10",
        "emailVerificationDate": "2023-03-15 10:10:10",
        "callbackUrl": "Google ",
        "nameAsPerPan": "ankit kumar",
        "dateOfBirth": "1996-07-26"
    }

Response(if user is already exists)

{
    "headers": {},
    "body": {
        "userId": "f45d9b92-6e51-4188-a7d1-2fdeaab97ea8",
        "state": "CIF_CREATED",
        "cifId": "867896"
    },
    "statusCode": "OK",
    "statusCodeValue": 200
}

Response(If user is new)

{
    "headers": {},
    "body": {
        "userId": "7f27d6c3-cc11-489d-96b5-02f1e488c9df",
        "kycUrl": "https://eohs-uat.shivalikbank.com/Aadhaar?callbackUrl=Google &applicationId=UPS01_PUPS01/AGUPS01/9363/090924121745_9&clientId=UPS01&mobileNumber=7906919363&accessToken=eyJ4NXQjUzI1NiI6ImRwZEdBYlVhUUFrNWFLNUV0LWFGUC1MZU51ci0yS0x0V0VRVDluOFdRSmMiLCJ4NXQiOiJiWmtyTEpERURlOVJaU1I2bkFwQlc1RVdSWUkiLCJraWQiOiJTSUdOSU5HX0tFWSIsImFsZyI6IlJTMjU2In0.eyJjbGllbnRfb2NpZCI6Im9jaWQxLmRvbWFpbmFwcC5vYzEuYXAtbXVtYmFpLTEuYW1hYWFhYWE2emJ1N2J5YTRyb2kyNjI2dWYyc2xpdmg0a2RzdzZqcjQ0Y3NrYnF1bmZlMjRhaDVjN3JxIiwidXNlcl90eiI6IkFzaWFcL0tvbGthdGEiLCJzdWIiOiJzbWJUZXN0VXNlciIsInVzZXJfbG9jYWxlIjoiZW4iLCJzaWRsZSI6NDgwLCJ1c2VyLnRlbmFudC5uYW1lIjoiaWRjcy02M2M0MDVmMTUzMjU0ZDU5YTZlMDM0NTIwNDRjN2ZiZCIsImlzcyI6Imh0dHBzOlwvXC9pZGVudGl0eS5vcmFjbGVjbG91ZC5jb21cLyIsImRvbWFpbl9ob21lIjoiYXAtbXVtYmFpLTEiLCJjYV9vY2lkIjoib2NpZDEudGVuYW5jeS5vYzEuLmFhYWFhYWFhaGhpdG82YnZibmpucWx2ZzQ2cWZwYmpwdDMybHhyb29hcWF0ZnA0bjIzbXhrbWljdzNrYSIsInVzZXJfdGVuYW50bmFtZSI6ImlkY3MtNjNjNDA1ZjE1MzI1NGQ1OWE2ZTAzNDUyMDQ0YzdmYmQiLCJjbGllbnRfaWQiOiIyMzIzRUJFNUQ2Rjc0QkQzQUVGRjUzNUE2RjJCMjRCQl9BUFBJRCIsImRvbWFpbl9pZCI6Im9jaWQxLmRvbWFpbi5vYzEuLmFhYWFhYWFhbmx1ZnVzNDVoNjRwdmphYWRoZ3J3bm14am5jM3FmaHoybXAzeXlqcXZ3ejdmdnFkZWV2cSIsInN1Yl90eXBlIjoidXNlciIsInNjb3BlIjoidXJuOm9wYzpyZXNvdXJjZTpjb25zdW1lcjo6YWxsIiwidXNlcl9vY2lkIjoib2NpZDEudXNlci5vYzEuLmFhYWFhYWFhcjVxcHNoamxscnpsYWFybHk0b3hnYWdrdmJ1dTZ6NnRmeDZpbmlpNnJ5cHFqeG1pN3g1cSIsImNsaWVudF90ZW5hbnRuYW1lIjoiaWRjcy02M2M0MDVmMTUzMjU0ZDU5YTZlMDM0NTIwNDRjN2ZiZCIsInJlZ2lvbl9uYW1lIjoiYXAtbXVtYmFpLWlkY3MtMSIsInVzZXJfbGFuZyI6ImVuIiwiZXhwIjoxNzI1ODY4MDY1LCJpYXQiOjE3MjU4NjQ0NjUsImNsaWVudF9ndWlkIjoiZjc3NWZjYmRkNWY2NDU4OGFkZWQ0ODkwZDNjMmVlMTYiLCJjbGllbnRfbmFtZSI6InNtYm5vbnByb2RvaWNwbGF0Zm9ybS1ibW9zMXJmbHl4bzctYm8iLCJ0ZW5hbnQiOiJpZGNzLTYzYzQwNWYxNTMyNTRkNTlhNmUwMzQ1MjA0NGM3ZmJkIiwianRpIjoiYmFjNzg4MjRhNjJkNDRiMDkyNTAzZjUxNTkzM2EwYjIiLCJndHAiOiJybyIsInVzZXJfZGlzcGxheW5hbWUiOiJTTUIgUmVhZCBPbmx5IFRlc3QiLCJvcGMiOnRydWUsInN1Yl9tYXBwaW5nYXR0ciI6InVzZXJOYW1lIiwicHJpbVRlbmFudCI6dHJ1ZSwidG9rX3R5cGUiOiJBVCIsImNhX2d1aWQiOiJjYWNjdC1lNzdlZTU4M2JkYWQ0NWUzYjAzM2U5ZDc0MDI3ZmUyMiIsImF1ZCI6WyJodHRwczpcL1wvZGVzaWduLmludGVncmF0aW9uLmFwLW11bWJhaS0xLm9jcC5vcmFjbGVjbG91ZC5jb20_aW50ZWdyYXRpb25JbnN0YW5jZT1zbWJub25wcm9kb2ljcGxhdGZvcm0tYm1vczFyZmx5eG83LWJvIiwiaHR0cHM6XC9cLzIzMjNFQkU1RDZGNzRCRDNBRUZGNTM1QTZGMkIyNEJCLmludGVncmF0aW9uLm9jcC5vcmFjbGVjbG91ZC5jb206NDQzIiwiaHR0cHM6XC9cL3NtYm5vbnByb2RvaWNwbGF0Zm9ybS1ibW9zMXJmbHl4bzctYm8uaW50ZWdyYXRpb24ub2NwLm9yYWNsZWNsb3VkLmNvbTo0NDMiLCJodHRwczpcL1wvc21ibm9ucHJvZG9pY3BsYXRmb3JtLWJtb3MxcmZseXhvNy1iby5pbnRlZ3JhdGlvbi5hcC1tdW1iYWktMS5vY3Aub3JhY2xlY2xvdWQuY29tOjQ0MyIsInVybjpvcGM6bGJhYXM6bG9naWNhbGd1aWQ9MjMyM0VCRTVENkY3NEJEM0FFRkY1MzVBNkYyQjI0QkIiXSwiY2FfbmFtZSI6InNoaXZhbGlrYmFua213Iiwic3R1IjoiSU5URUdSQVRJT05DQVVUTyIsInVzZXJfaWQiOiI2MTFmZWY1NzcyZGQ0MTExYjQwNDQ0NDgwNTk4NDhhMSIsImRvbWFpbiI6Ik9yYWNsZUlkZW50aXR5Q2xvdWRTZXJ2aWNlIiwidGVuYW50X2lzcyI6Imh0dHBzOlwvXC9pZGNzLTYzYzQwNWYxNTMyNTRkNTlhNmUwMzQ1MjA0NGM3ZmJkLmlkZW50aXR5Lm9yYWNsZWNsb3VkLmNvbTo0NDMiLCJyZXNvdXJjZV9hcHBfaWQiOiJmNzc1ZmNiZGQ1ZjY0NTg4YWRlZDQ4OTBkM2MyZWUxNiJ9.Mup3znU0SMnFLv-_p4ttN2vwdsSqOGBjNNNfHAQOVycQAPCQNhCXBW6Asuvumde_QaiJ2yEHGu-Cij2zfC6op99TNXtZKp8PLH8_EuCJgkaA12Ne-El5_loNTbAv53qtRo-G92GjAHr7-qhm2FTltOCC2qqaGVM2DQ8eEl5S1l-VtiyUoKQxtysslAVsfLrY9iczR8rKsH7b0sg3lJmLGGZI-O35WlrYf1PW1Q6Lqw1zG8PKvWuPehlY_ftC86WSZtwLLbHzv82LKfmnyta7LPh6DvVZqXQniPz6JLmvB4ibxcgDnfTPVYx0jK8v2JLvPezoHn0XgPCB4Fi7bT6vzA",
        "state": "NEW",
        "kycUrlExpiry": 1725867885528
    },
    "statusCode": "OK",
    "statusCodeValue": 200
}