Version 6

Changed the checking value, added livenessFaceBase64Image, livenessFaceBase64Image, idBrightnessDetection, removed Edge Detection

POST https://okaydocdemo.innov8tif.com/ekyc/api/ekyc/v6/doc-verify/mykad

Request Body

NameTypeDescription

caseNo

string

Reference code given by user

livenessFaceBase64Image

string

Selfie image in base64

idBrightnessDetection

boolean

Default is False. Set True to detect the brightness of the id image.

idBlurDetection

boolean

Default is False. Set True to detect the blurriness of id image

faceBrightnessDetection

boolean

Default is False. Set True to detect the brightness of the face image(livenessFaceBase64Image); If livenessFaceBase64Image is not given, idImageBase64Image will be used instead.

ghostPhotoColorDetection

boolean

Default is False. Set True to do ghost photo color detection.

screenDetection

boolean

Default is False. Set True to do screen detection.

hologram

boolean

Default is False. Set True to do hologram detection.

colorMode

boolean

Default is False. Set True to do color checking.

icTypeCheck

boolean

Default is False. Set True to do IC type checking.

photoSubstitutionCheck

boolean

Default is False. Set True to do photo substitution checking.

microprintCheck

boolean

Default is False. Set True to do microprint checking.

fontCheck

boolean

Default is False. Set True to do font checking.

landmarkCheck

boolean

Default is False. Set True to do landmark checking.

apiKey

string

To be assigned by Innov8tif

idImageBase64Image

string

Front id card image in base64

idNumber

string

Id card number as shown on id card. If this value is provided, higher chance of getting higher score for font checking.

otherDocList

array

Type can be: high quality, with flash, without flash, with no specific order. At least one of the listed field above is required.

{
    "status": "success",
    "messageCode": "api.success",
    "message": "",
    "id": "14d4ca15-63d7-4159-92eb-25bb2977e0e5",
    "methodList": [
        {
            "method": "landmark",
            "label": "Landmark Analysis Result",
            "componentList": [
                {
                    "code": "l-mykad-header",
                    "label": "Kad Pengenalan Header",
                    "value": "34.4541",
                    "imageUrl": "/public/image/v2/14d4ca15-63d7-4159-92eb-25bb2977e0e5?type=l-mykad-header",
                    "refImageUrl": null
                },
                {
                    "code": "l-mykad-logo",
                    "label": "MyKad Logo",
                    "value": "95.68870000000001",
                    "imageUrl": "/public/image/v2/14d4ca15-63d7-4159-92eb-25bb2977e0e5?type=l-mykad-logo",
                    "refImageUrl": null
                },
                {
                    "code": "l-my-flag-logo",
                    "label": "Malaysia Flag",
                    "value": "95.82770000000001",
                    "imageUrl": "/public/image/v2/14d4ca15-63d7-4159-92eb-25bb2977e0e5?type=l-my-flag-logo",
                    "refImageUrl": null
                },
                {
                    "code": "l-chip",
                    "label": "Chip",
                    "value": "72.1268",
                    "imageUrl": "/public/image/v2/14d4ca15-63d7-4159-92eb-25bb2977e0e5?type=l-chip",
                    "refImageUrl": null
                },
                {
                    "code": "l-hibiscus",
                    "label": "Hibiscus",
                    "value": "69.985",
                    "imageUrl": "/public/image/v2/14d4ca15-63d7-4159-92eb-25bb2977e0e5?type=l-hibiscus",
                    "refImageUrl": null
                },
                {
                    "code": "l-msc",
                    "label": "MSC",
                    "value": "93.8832",
                    "imageUrl": "/public/image/v2/14d4ca15-63d7-4159-92eb-25bb2977e0e5?type=l-msc",
                    "refImageUrl": null
                }
            ]
        },
        {
            "method": "font",
            "label": "MyKad Font Checking Result",
            "componentList": [
                {
                    "code": "f-id-no",
                    "label": "ID No",
                    "value": "Pass",
                    "imageUrl": "/public/image/v2/14d4ca15-63d7-4159-92eb-25bb2977e0e5?type=f-id-no",
                    "refImageUrl": "/public/image/v2/14d4ca15-63d7-4159-92eb-25bb2977e0e5?type=f-id-no-ref"
                }
            ]
        },
        {
            "method": "microprint",
            "label": "Microprint Score",
            "componentList": [
                {
                    "code": "microprint",
                    "label": "Microprint",
                    "value": "12",
                    "imageUrl": "/public/image/v2/14d4ca15-63d7-4159-92eb-25bb2977e0e5?type=microprint",
                    "refImageUrl": null
                }
            ]
        },
        {
            "method": "hologram",
            "label": "Hologram",
            "componentList": [
                {
                    "code": "hologram",
                    "label": "Hologram",
                    "value": "Fail,Fail",
                    "imageUrl": "/public/image/v2/14d4ca15-63d7-4159-92eb-25bb2977e0e5?type=hologram",
                    "refImageUrl": null
                }
            ]
        },
        {
            "method": "substitution",
            "label": "Ghost Photo Comparison",
            "componentList": [
                {
                    "code": "substitution",
                    "label": "Substitution Score",
                    "value": "0",
                    "imageUrl": null,
                    "refImageUrl": null
                }
            ]
        },
        {
            "method": "docType",
            "label": "MyKad Type",
            "componentList": [
                {
                    "code": "docType",
                    "label": "IC Type",
                    "value": "New IC",
                    "imageUrl": null,
                    "refImageUrl": null
                }
            ]
        },
        {
            "method": "colorMode",
            "label": "Color Mode",
            "componentList": [
                {
                    "code": "colorMode",
                    "label": "Color",
                    "value": "Pass",
                    "imageUrl": null,
                    "refImageUrl": null
                }
            ]
        },
        {
            "method": "screen",
            "label": "Screen Detection",
            "componentList": [
                {
                    "code": "screen",
                    "label": "Screen Detection",
                    "value": "Pass",
                    "imageUrl": null,
                    "refImageUrl": null
                }
            ]
        },
        {
            "method": "holocolor",
            "label": "Ghost Photo Color Detection",
            "componentList": [
                {
                    "code": "holocolor",
                    "label": "Ghost Photo Color Detection",
                    "value": "Pass",
                    "imageUrl": null,
                    "refImageUrl": null
                }
            ]
        },
        {
            "method": "idBlurDetection",
            "label": "ID Blur Detection",
            "componentList": [
                {
                    "code": "idBlurDetection",
                    "label": "ID Blur Detection",
                    "value": "Pass",
                    "imageUrl": null,
                    "refImageUrl": null
                }
            ]
        },
        {
            "method": "idBrightnessDetc",
            "label": "ID Brightness Detection",
            "componentList": [
                {
                    "code": "idBrightnessDetc",
                    "label": "ID Brightness Detection",
                    "value": "Pass",
                    "imageUrl": null,
                    "refImageUrl": null
                }
            ]
        },
        {
            "method": "faceBrightnessDetc",
            "label": "Face Brightness Detection",
            "componentList": [
                {
                    "code": "faceBrightnessDetc",
                    "label": "Face Brightness Detection",
                    "value": "Pass",
                    "imageUrl": null,
                    "refImageUrl": null
                }
            ]
        }
    ],
    "outputImageList": [
        {
            "tag": "holoFace",
            "imageUrl": "/public/image/v2/14d4ca15-63d7-4159-92eb-25bb2977e0e5?type=holoFace"
        },
        {
            "tag": "idFace",
            "imageUrl": "/public/image/v2/14d4ca15-63d7-4159-92eb-25bb2977e0e5?type=idFace"
        }
    ]
}

Input Example

{
    "apiKey": "apiKey",
    "caseNo": "", 
    "idImageBase64Image": "",
    "livenessFaceBase64Image": "",
    "idNumber": "",
    "otherDocList": [
        {
            "base64Image": "",
            "type": "high_quality"
        },
        {
            "base64Image": "",
            "type": "without_flash"
        },
        {
            "base64Image": "",
            "type": "with_flash"
        }
    ],
    "photoSubstitutionCheck": true,
    "landmarkCheck": true,
    "screenDetection":true,
    "ghostPhotoColorDetection":true,
    "fontCheck": true,
    "colorMode": true,
    "hologram": true,
    "icTypeCheck": true,
    "microprintCheck": false,
    "faceBrightnessDetection": true,
    "idBlurDetection": true,
    "idBrightnessDetection": true
}

Last updated