CKYC Matching HyperStream

The CKYC Matching Hyperstream will perform the following functions:

  • CKYC search using the initial_input. If the user is not found in CKYC Search, the flow ends and the same is informed to the customer in the response message.
  • If the user is found from the CKYC Search, we use the CKYC ID received from the CKYC Search API and hit CKYC Download API with perform_ocr parameter set to true
  • If download data is not found, then the flow ends. If the CKYC Download data is found, the following documents to be checked to perform OCR:
    • PAN
    • Aadhaar
  • If none of the above documents are found, then the next priority documents to be checked to perform OCR:
    • Passport
    • Driving License
    • Voter ID
  • Mandatorily two documents are to undergo through OCR. If only one document is present, only one OCR is to be done. If more than two documents are present, only two OCRs are to be done based on priority.
  • Once the OCR is done, the matching logic to be performed based on the checks at the Decentro level
  • After performing all matching and logic, the response to be shown to the customer along with mandatory and informatory parameters
  • Send the collective response back to the user. Flow ends.

Since this Hyperstream utilizes the Matching Module, the input requires a mandatory object called matching_input. Using the matching_input you can match the following fields with the input provided by the user:

  • full_name: string, optional
  • father_name: string, optional
  • dob: string, optional
  • permanent_address: string, optional
  • communication_address: string, optional
  • pincode: string, optional
  • gender: string, optional
  • mobile_last_four_digits: string, optional

Sample Contracts

{
    "reference_id": "DEC001",
    "consent": true,
    "consent_purpose": "To onboard user into platform",
    "hyperstream": "CKYC_MATCHING",
    "initial_input": {
        "document_type": "PAN",
        "id_number": "START1000X",
        "auth_factor_type": 1,
        "auth_factor": "1975-01-01"
    },
    "matching_input": {
        "full_name": {
            "value": "Luke Skywalker",
            "threshold": 75
        },
        "father_name": {
            "value": "Darth Vader",
            "threshold": 75
        },
        "permanent_address": {
            "value": "Central Street",
            "threshold": 75
        },
        "gender": {
            "value": "FEMALE",
            "threshold": 75
        }
    }
}
{
    "decentro_txn_id": "XXXXXXXXXXXXXXXXX",
    "status": "SUCCESS",
    "http_status_code": 200,
    "response_key": "success_hyperstream",
    "data": {
        "CKYC_SEARCH_AND_DOWNLOAD": {
            "gender": {
                "status": true,
                "message": "Match successful",
                "match_percentage": 100
            },
            "full_name": {
                "status": true,
                "message": "Match successful",
                "match_percentage": 90
            },
            "father_name": {
                "status": false,
                "message": "Match failed",
                "match_percentage": 69
            },
            "permanent_address": {
                "status": false,
                "message": "Match failed",
                "match_percentage": 14
            }
        },
        "OCR": {
            "AADHAAR": {
                "gender": {
                    "status": false,
                    "message": "Match failed",
                    "match_percentage": 0
                },
                "full_name": {
                    "status": false,
                    "message": "Match failed",
                    "match_percentage": 0
                },
                "father_name": {
                    "status": false,
                    "message": "Match failed",
                    "match_percentage": 0
                },
                "permanent_address": {
                    "status": false,
                    "message": "Match failed",
                    "match_percentage": 0
                }
            },
            "PASSPORT": {
                "gender": {
                    "status": false,
                    "message": "Match failed",
                    "match_percentage": 40
                },
                "full_name": {
                    "status": false,
                    "message": "Match failed",
                    "match_percentage": 44
                },
                "father_name": {
                    "status": false,
                    "message": "Data not found with source",
                    "match_percentage": 0
                },
                "permanent_address": {
                    "status": false,
                    "message": "Match failed",
                    "match_percentage": 36
                }
            }
        }
    },
    "message": "Successfully Completed Hyperstream",
    "reference_id": "XXXXXXXXXX"
}