Get Scorecard Result

Scorecard result is used to return the Overall's submission journey by each user to return the verification results.

Overview

This Get Scorecard Result API is to calculate all the results that have been tested in the previous API by the user under one JourneyId and output the results based on the metrics. The metrics can be customized by the user based on their preferences to allow flexibility on the security checks.

Steps:

1. After successfully calling the API components in the EMAS eKYC Portal, the user can proceed to the final API which is the Get Scorecard Result API.

2. Place the JourneyId and the content mentioned in the API Method below.

3. After expanding API method, the user can place the details accordingly following this Example.

4. Upon successfully calling, the user will get a result either "Clear", "Cautious", or "Suspicious" based on the default Scorecard result.

5. Users can choose to refer or not refer to the Scorecard Result when they are integrating with their own application. However, it is recommended to use the Scorecard is designed for EMAS eKYC purposes.

This requires all of the centralized APIs has been called at least once under the same JourneyId to get the status from the Get Scorecard API. (This only applies to default Scorecard Config)

API Method

GET https://ekycportaldemo.innov8tif.com/api/ekyc/scorecard?journeyId={{journeyid}}

Request Body

Name	Type	Description
journeyId*	string	Retrieve from 'Create JourneyID' API

200 Response of MyKad's scorecard

Response Code Block

{
    "status": "success",
    "messageCode": null,
    "message": null,
    "scorecardResultList": [
        {
            "scorecardStatus": "clear",
            "docType": "mykad_back",
            "checkResultList": [
                {
                    "checkType": "liveFaceCheck",
                    "checkStatus": "P" 
                },
                {
                    "checkType": "facialVerification",
                    "checkStatus": "P" 
                },
                {
                    "checkType": "landmark",
                    "checkStatus": "P" 
                }
            ]
        },
        {
            "scorecardStatus": "cautious",
            "docType": "mykad_new",
            "checkResultList": [
                {
                    "checkType": "liveFaceCheck",
                    "checkStatus": "P" 
                },
                {
                    "checkType": "facialVerification",
                    "checkStatus": "P" 
                },
                {
                    "checkType": "landmark",
                    "checkStatus": "P" 
                },
                {
                    "checkType": "colorDetection",
                    "checkStatus": "P" 
                },
                {
                    "checkType": "holographicPhotoQualityCheck",
                    "checkStatus": "P" 
                },
                {
                    "checkType": "screenDetection",
                    "checkStatus": "P" 
                },
                {
                    "checkType": "idNoFontCheck",
                    "checkStatus": "P" 
                },
                {
                    "checkType": "microprint",
                    "checkStatus": "C" 
                },
                {
                    "checkType": "hologram",
                    "checkStatus": "F" 
                },
                {
                    "checkType": "holographicPhotoComparision",
                    "checkStatus": "P" 
                }
            ]
        }
    ]
}

The result will be returned only if that particular document is configured with a scorecard.

Input Example

User input journeyId

The full eKYC process flow will need to be completed in order to get the scorecard results

Postman Collection

Get the Postman Collection https://innov8tif-solutions.gitbook.io/innov8tif-emas-ekyc-portal/emas-ekyc-portal/postman-collection