CKYC Download

CKYC Download API can be used by the platform to check if they are present on the CKYC repository. The platform can access the download ONLY if the customer is present with the repository.

CKYC Download shares a detailed list of documents uploaded by a regulated entity as well as customer information as detailed in the response.

This API accepts the below parameters.

  • Enter your CKYC number from CKYC Search
  • Type of authentication of the person whose CKYC details are to be downloaded. Can be 1 / 2 / 3.
  • Auth factor - Depends on the auth_factor_type, refer to the table below for details.

Decentro returns a response from this API only if CERSAI returns a response basis the auth factor parameters passed by the platform.

📘

CKYC Download with OCR

OCR can be performed directly on CKYC Documents by selecting the perform_ocr parameter and passing it as true.

📘

Heads Up!

identityDetails is received directly from CKYC. If we don't get this block for a few customers, it means we have not received that block from CKYC.

Auth Factor

auth_factor_typeauth_factor
1 Date of birth in the format: "yyyy-mm-dd".
Example: "1993-03-29".
2A combination of the 6-digit pin code and the year of birth.
Example: "5600171992" where 560017 is the pin code and 1992 is the year of birth.
3A valid 10-digit mobile number of the person whose AADHAAR is linked with.
Example: "9001122339".

Sample API

{
    "reference_id": "ABCDEF12345",
    "id_number": "XXXXXXXXXXXXXX",
    "auth_factor_type": 1,
    "auth_factor": "1993-03-29",
    "consent": true,
    "consent_purpose": "For bank account purpose",
    "perform_ocr": false
}'
{
    "decentroTxnId": "7CF40604AF8B46159925553024E780F4",
    "responseCode": "S00000",
    "responseKey": "success_ckyc_download",
    "data": {
        "kycStatus": "SUCCESS",
        "kycResult": {
            "personalIdentifiableData": {
                "personalDetails": {
                    "constituitonType": "Individual",
                    "accountType": "Normal",
                    "ckycNo": "00000000000000",
                    "ckycReferenceId": "IN000000000000",
                    "prefix": "Mr",
                    "firstName": "ABC",
                    "middleName": "DEF",
                    "lastName": "QWE",
                    "fullName": "Mr ABC DEF QWE",
                    "fatherPrefix": "Mr",
                    "fatherFname": "DEF",
                    "fatherLname": "QWE",
                    "fatherFullname": "Mr DEF QWE",
                    "motherPrefix": "Mrs",
                    "motherFname": "RTY",
                    "motherFullname": "Mrs RTY QWE",
                    "gender": "MALE",
                    "dob": "01-01-2000",
                    "pan": "ABCPE1234F",
                    "permLine1": "SO address line 1",
                    "permLine2": "address line 2",
                    "permCity": "Bangalore",
                    "permDist": "Bangalore",
                    "permState": "KR",
                    "permCountry": "IN",
                    "permPin": "676102",
                    "permPoa": "E-KYC Authentication",
                    "permCorresSameflag": "Y",
                    "corresLine1": "SO address line 1",
                    "corresLine2": "address line 2",
                    "corresCity": "Bangalore",
                    "corresDist": "Bangalore",
                    "corresState": "KR",
                    "corresCountry": "IN",
                    "corresPin": "676102",
                    "corresPoa": "09",
                    "mobCode": "91",
                    "mobNum": "9999999999",
                    "decDate": "01-01-2015",
                    "decPlace": "Bangalore",
                    "kycDate": "********",
                    "docSub": "Equivalent E-Document",
                    "kycName": "********",
                    "kycDesignation": "********",
                    "kycBranch": "********",
                    "kycEmpcode": "********",
                    "numIdentity": "2",
                    "numRelated": "0",
                    "numImages": "3"
                },
                "identityDetails": {
                    "identity": [
                        {
                            "sequenceNo": "1",
                            "identityType": "Proof of Possession of Aadhaar",
                            "identityNumber": "XXXXXXXX1840",
                            "idVerificationStatus": "NO"
                        },
                        {
                            "sequenceNo": "2",
                            "identityType": "E-KYC Authentication",
                            "identityNumber": "XXXXXXXX1840",
                            "idVerificationStatus": "NO"
                        }
                    ]
                },
                "imageDetails": {
                    "image": [
                        {
                            "sequenceNo": "1",
                            "imageType": "JPG",
                            "imageCode": "Photograph",
                            "branchCode": "BR001",
                            "imageData": "XXXXX"
                        },
                        {
                            "sequenceNo": "2",
                            "imageType": "JPG",
                            "imageCode": "E-KYC Authentication",
                            "branchCode": "BR001",
                            "imageData": "XXXXX"
                        },
                        {
                            "sequenceNo": "3",
                            "imageType": "PDF",
                            "imageCode": "Proof of Possession of Aadhaar",
                            "branchCode": "MUM02BR",
                            "imageData": "XXXXX"
                        }
                    ]
                }
            }
        },
        "message": "KYC Details from CKYC downloaded successfully."
    },
    "status": "SUCCESS"
}