Malaysian Cards

Currently Supported Malaysian Cards include:

1. MyKad

2. MyTentera

3. MyKas

4. MyPR

Note: Backside card support can be enabled through configuration, and the KYC flow will follow the idSubType you provide (for example, use idSubType = MyKad to apply the correct setup).

MyKad

Request

Request for Front Side Only

{
  "operations": ["idVerification"],
  "payload": {
    "partnerTrxId": "random-uuid",
    "groupId": "random-uuid",
    "idType": "ID_CARD",
    "country": "MYS",
    "idSubtype": "MyKad",
    "idFrontSideImage": "Base64 encoded image of ID front side"
  },
  "userConsent": {
    "userIP": "0.0.0.0",
    "country": "MYS",
    "obtained": true,
    "obtainedAt": "1680700959"
  }
}

Request for Front Side and Back Side

{
  "operations": ["idVerification"],
  "payload": {
    "partnerTrxId": "random-uuid",
    "groupId": "random-uuid",
    "idType": "ID_CARD",
    "country": "MYS",
    "idSubtype": "MyKad",
    "idFrontSideImage": "Base64 encoded image of ID front side",
    "idBackSideImage": "Base64 encoded image of ID back side" //if enabled
  },
  "userConsent": {
    "userIP": "0.0.0.0",
    "country": "MYS",
    "obtained": true,
    "obtainedAt": "1680700959"
  }
}

Success Response

HTTP Status Code: 200

Success JSON Response for Front Side Only

{
    "transactionId": "unique transaction id generated to identify this transaction",
    "partnerTrxId": "partner transaction id submitted by customer in request",
    "groupId": "partner group id submitted by customer in request",
    "card": {
        "country": "MALAYSIA",
        "type": "MyKad",
        "isoAlpha3CountryCode": "MYS",
        "isoAlpha2CountryCode": "MY"
    },
    "imageQualityResult": {
        "front": {
            "glare": {
                "score": 0,
                "threshold": 0.95
            },
            "blurriness": {
                "score": 0.000004,
                "threshold": 0.95
            },
            "lowLight": {
                "score": 0.138068,
                "threshold": 0.95
            }
        }
    },
    "idVerificationResult": {
        "front": {
            "spoofingResult": {
                "message": "Success",
                "code": 5000,
                "recapScore": {
                    "score": 0.186553,
                    "threshold": 0.95
                },
                "blackWhite": {
                    "score": 0.00359,
                    "threshold": 0.95
                },
                 },
                "colorPrint": {
                    "score": 0.477745,
                    "threshold": 0.95
                }
            },
            "landmarkResult": {
                "code": 5000,
                "message": "Success",
                "threshold": 0.95,
                "containerResult": [
                    {
                        "name": "ghost",
                        "score": 0.9929
                    },
                    {
                        "name": "portrait",
                        "score": 0.9795
                    },
                    {
                        "name": "hibiscus_logo",
                        "score": 0.9849
                    },
                   -----[TRUNCATED]------ 
                ]
            },
            "forgeryResult": {
                "code": 5000,
                "message": "Success",
                "summary": {
                    "score": 0.25716,
                    "threshold": 0.95
                }
            }
        }
    }
}

Success JSON Response for Front Side and Back Side

{
   "transactionId": "unique transaction id generated to identify this transaction",
   "partnerTrxId": "partner transaction id submitted by customer in request",
   "groupId": "partner group id submitted by customer in request",
    "card": {
        "country": "MALAYSIA",
        "type": "MyKad",
        "isoAlpha3CountryCode": "MYS",
        "isoAlpha2CountryCode": "MY"
    },
    "imageQualityResult": {
        "front": {
            "glare": {
                "score": 0,
                "threshold": 0.95
            },
            "blurriness": {
                "score": 0.0008,
                "threshold": 0.95
            },
            "lowLight": {
                "score": 0.076793,
                "threshold": 0.95
            }
        },
        "back": {
            "blurriness": {
                "score": 0.003535,
                "threshold": 0.95
            },
            "lowLight": {
                "score": 0,
                "threshold": 0.95
            }
        }
    },
    "idVerificationResult": {
        "front": {
            "spoofingResult": {
                "message": "Success",
                "code": 5000,
                "recapScore": {
                    "score": 0.156807,
                    "threshold": 0.95
                },
                "blackWhite": {
                    "score": 0.005257,
                    "threshold": 0.95
                },
                "colorPrint": {
                    "score": 0.477745,
                    "threshold": 0.95
                }
                
            },
            "landmarkResult": {
                "code": 5000,
                "message": "Success",
                "threshold": 0.95,
                "containerResult": [
                    {
                        "name": "card_logo",
                        "score": 0.9831
                    },
                    {
                        "name": "chip",
                        "score": 0.9748
                    },
                    {
                        "name": "hibiscus_logo",
                        "score": 0.9832
                    },
                    {
                        "name": "malaysia_flag",
                        "score": 0.9882
                    },
                       -----[TRUNCATED]------                
                   ]
            },
            "forgeryResult": {
                "code": 5000,
                "message": "Success",
                "summary": {
                    "score": 0.257167,
                    "threshold": 0.95
                }
            }
        },
        "back": {
            "spoofingResult": {
                "message": "Success",
                "code": 5000,
                "recapScore": {
                    "score": 0.270645,
                    "threshold": 0.95
                },
                "blackWhite": {
                    "score": 0.014498,
                    "threshold": 0.95
                },
                 "colorPrint": {
                    "score": 0.1397,
                    "threshold": 0.95
                }
            },
            "landmarkResult": {
                "code": 5000,
                "message": "Success",
                "threshold": 0.95,
                "containerResult": [
                    {
                        "name": "coat_of_arm",
                        "score": 0.9956
                    },
                    {
                        "name": "kopiah",
                        "score": 0.995
                    },
                     -----[TRUNCATED]------
                ]
            }
        }
    }
}

Forged Card Response

HTTP Status Code: 400

Forged card JSON Response

{
    "transactionId": "unique transaction id generated to identify this transaction",
    "partnerTrxId": "partner transaction id submitted by customer in request",
    "groupId": "partner group id submitted by customer in request",
    "errors": [
        {
            "message": "The card appears to be forged.",
            "code": 5024,
            "operations": [
                "idVerification"
            ]
        }
    ],
    "imageQualityResult": {
        "front": {
            "glare": {
                "score": 0,
                "threshold": 0.95
            },
            "blurriness": {
                "score": 0.008268,
                "threshold": 0.95
            },
            "lowLight": {
                "score": 0.029575,
                "threshold": 0.95
            }
        }
    }
}

Landmark Warning Response

HTTP Status Code: 200

Landmark Card JSON Response

{
    "transactionId": "unique transaction id generated to identify this transaction",
    "partnerTrxId": "partner transaction id submitted by customer in request",
    "groupId": "partner group id submitted by customer in request",
    "warnings": [
        {
            "message": "Image has Occlusion, please check [msc_logo] from landmarkResult for more details",
            "code": 10017,
            "operations": [
                "idVerification"
            ]
        }
    ],
    "card": {
        "country": "MALAYSIA",
        "type": "MyKad",
        "isoAlpha3CountryCode": "MYS",
        "isoAlpha2CountryCode": "MY"
    },
    "imageQualityResult": {
        "front": {
            "glare": {
                "score": 0.865832,
                "threshold": 0.95
            },
            "blurriness": {
                "score": 0.005475,
                "threshold": 0.95
            },
            "lowLight": {
                "score": 0.068952,
                "threshold": 0.95
            }
        }
    },
    "idVerificationResult": {
        "front": {
            "spoofingResult": {
                "message": "Success",
                "code": 5000,
                "recapScore": {
                    "score": 0.220021,
                    "threshold": 0.95
                },
                "blackWhite": {
                    "score": 0.003927,
                    "threshold": 0.95
                }
            },
            "landmarkResult": {
                "code": 5000,
                "message": "Success",
                "threshold": 0.95,
                "containerResult": [
                    {
                        "name": "chip",
                        "score": 0.9752
                    },
                    {
                        "name": "portrait",
                        "score": 0.9733
                    },
                    {
                        "name": "card_logo",
                        "score": 0.981
                    },
                    -----TRUNCATED-----
                ]
            },
            "forgeryResult": {
                "code": 5000,
                "message": "Success",
                "summary": {
                    "score": 0.257168,
                    "threshold": 0.95
                }
            }
        }
    }
}

Spoof Error Response

Note: This happens when 1 or more than 1 spoof check fails.

HTTP Status Code: 400

Spoof Card JSON Response

{
   "transactionId": "unique transaction id generated to identify this transaction",
   "partnerTrxId": "partner transaction id submitted by customer in request",
   "groupId": "partner group id submitted by customer in request",
   "errors": [
        {
            "message": "Spoof check failed. Image submitted is Recaptured",
            "code": 5601,
            "operations": [
                "idVerification"
            ]
        },
        {
            "message": "Spoof check failed. Image submitted is either B&W or Photocopy",
            "code": 5602,
            "operations": [
                "idVerification"
            ]
        },
        {
            "message": "Spoof check failed. Image submitted is color reprint",
            "code": 5603,
            "operations": [
                "idVerification"
            ]
        }
    ],
    "imageQualityResult": {
        "front": {
            "glare": {
                "score": 0.097592,
                "threshold": 0.95
            },
            "blurriness": {
                "score": 0.004796,
                "threshold": 0.95
            },
            "lowLight": {
                "score": 0.058688,
                "threshold": 0.95
            }
        }
    }
}

MyTentera

Note:

There are two versions of MyTentera cards:

• An old version (without a ghost image)

• A new version (with a ghost image)

The ghost image is treated as an optional landmark:

• If detected, it will be included in the response.

• If not detected, it will be silently omitted — no warning will be triggered.

Request

Request for Front Side Only

{
  "operations": ["idVerification"],
  "payload": {
    "partnerTrxId": "random-uuid",
    "groupId": "random-uuid",
    "idType": "ID_CARD",
    "country": "MYS",
    "idSubtype": "MyTentera",
    "idFrontSideImage": "Base64 encoded image of ID front side"
  },
  "userConsent": {
    "userIP": "0.0.0.0",
    "country": "MYS",
    "obtained": true,
    "obtainedAt": "1680700959"
  }
}

Request for Front and Back Side

{
  "operations": ["idVerification"],
  "payload": {
    "partnerTrxId": "random-uuid",
    "groupId": "random-uuid",
    "idType": "ID_CARD",
    "country": "MYS",
    "idSubtype": "MyTentera",
    "idFrontSideImage": "Base64 encoded image of ID front side",
    "idBackSideImage": "Base64 encoded image of ID back side" //if enabled
  },
  "userConsent": {
    "userIP": "0.0.0.0",
    "country": "MYS",
    "obtained": true,
    "obtainedAt": "1680700959"
  }
}

Success Response

HTTP Status Code: 200

Success JSON Response for Front Side Only

{
    "transactionId": "unique transaction id generated to identify this transaction",
    "partnerTrxId": "partner transaction id submitted by customer in request",
    "groupId": "partner group id submitted by customer in request",
    "card": {
        "country": "MALAYSIA",
        "type": "MyTentera",
        "isoAlpha3CountryCode": "MYS",
        "isoAlpha2CountryCode": "MY"
    },
    "imageQualityResult": {
        "front": {
            "blurriness": {
                "score": 0.000613,
                "threshold": 0.95
            },
            "lowLight": {
                "score": 0.150821,
                "threshold": 0.95
            }
        }
    },
    "idVerificationResult": {
        "front": {
            "spoofingResult": {
                "message": "Success",
                "code": 5000,
                "recapScore": {
                    "score": 0.166092,
                    "threshold": 0.95
                },
                "blackWhite": {
                    "score": 0.012025,
                    "threshold": 0.95
                },
                "colorPrint": {
                    "score": 0.477745,
                    "threshold": 0.95
                }
            },
            "landmarkResult": {
                "code": 5000,
                "message": "Success",
                "threshold": 0.95,
                "containerResult": [
                    {
                        "name": "chip",
                        "score": 0.9981
                    },
                    {
                        "name": "hibiscus_logo",
                        "score": 0.9977
                    },
                       -----[TRUNCATED]------  
                ]
            }
        }
    }
}

Success JSON Response for Front Side and Back Side

{
   "transactionId": "ee6a6407-c56b-45ea-9607-24c4e5960169",
    "partnerTrxId": "01cfe276-e5b5-42f9-b069-9f71fbb5ce5b",
    "groupId": "cf95b45b-b443-4e90-b15b-7e868641e1d3",
    "card": {
        "country": "MALAYSIA",
        "type": "MyTentera",
        "isoAlpha3CountryCode": "MYS",
        "isoAlpha2CountryCode": "MY"
    },
    "imageQualityResult": {
        "front": {
            "blurriness": {
                "score": 0.03898,
                "threshold": 0.95
            },
            "lowLight": {
                "score": 0.003386,
                "threshold": 0.95
            }
        },
        "back": {
            "blurriness": {
                "score": 0.021608,
                "threshold": 0.95
            },
            "lowLight": {
                "score": 0,
                "threshold": 0.95
            }
        }
    },
    "idVerificationResult": {
        "front": {
            "spoofingResult": {
                "message": "Success",
                "code": 5000,
                "recapScore": {
                    "score": 0.105434,
                    "threshold": 0.95
                },
                "blackWhite": {
                    "score": 0.005061,
                    "threshold": 0.95
                },
                "colorPrint": {
                    "score": 0.058626,
                    "threshold": 0.95
                }
            },
            "landmarkResult": {
                "code": 5000,
                "message": "Success",
                "threshold": 0.95,
                "containerResult": [
                    {
                        "name": "chip",
                        "score": 0.9983
                    },
                    {
                        "name": "hibiscus_logo",
                        "score": 0.9978
                    },
                    {
                        "name": "portrait",
                        "score": 0.9976
                    },
                    {
                        "name": "ghost",
                        "score": 0.9973
                    },
                    {
                        "name": "name",
                        "score": 0.9972
                    },
                    {
                        "name": "card_logo",
                        "score": 0.9969
                    },
                    {
                        "name": "msc_logo",
                        "score": 0.9967
                    },
                    {
                        "name": "kad_pengenalan_header",
                        "score": 0.9961
                    },
                    {
                        "name": "malaysia_flag",
                        "score": 0.9949
                    },
                    {
                        "name": "id_number",
                        "score": 0.9929
                    }
                ]
            }
        },
        "back": {
            "spoofingResult": {
                "message": "Success",
                "code": 5000,
                "recapScore": {
                    "score": 0.127194,
                    "threshold": 0.95
                },
                "blackWhite": {
                    "score": 0.091711,
                    "threshold": 0.95
                },
                "colorPrint": {
                    "score": 0.102728,
                    "threshold": 0.95
                }
            },
            "landmarkResult": {
                "code": 5000,
                "message": "Success",
                "threshold": 0.95,
                "containerResult": [
                    {
                        "name": "kopiah",
                        "score": 0.9976
                    },
                    {
                        "name": "military_logo",
                        "score": 0.9952
                    },
                    {
                        "name": "coat_of_arm",
                        "score": 0.9948
                    },
                    {
                        "name": "state_registrar",
                        "score": 0.9931
                    },
                    {
                        "name": "twin_tower",
                        "score": 0.993
                    },
                    {
                        "name": "id_number",
                        "score": 0.992
                    }
                ]
            }
        }
    },
                     -----[TRUNCATED]------
                ]
            }
        }
    }
}

Landmark Warning Response

HTTP Status Code: 200

Landmark Card JSON Response

{
    "transactionId": "unique transaction id generated to identify this transaction",
    "partnerTrxId": "partner transaction id submitted by customer in request",
    "groupId": "partner group id submitted by customer in request",
    "warnings": [
        {
            "message": "Image has Occlusion, please check [msc_logo] from landmarkResult for more details",
            "code": 10017,
            "operations": [
                "idVerification"
            ]
        }
    ],
    "card": {
        "country": "MALAYSIA",
        "type": "MyTentera",
        "isoAlpha3CountryCode": "MYS",
        "isoAlpha2CountryCode": "MY"
    },
    "imageQualityResult": {
        "front": {
            "blurriness": {
                "score": 0.000857,
                "threshold": 0.95
            },
            "lowLight": {
                "score": 0.056495,
                "threshold": 0.95
            }
        }
    },
    "idVerificationResult": {
        "front": {
            "spoofingResult": {
                "message": "Success",
                "code": 5000,
                "recapScore": {
                    "score": 0.153728,
                    "threshold": 0.95
                },
                "blackWhite": {
                    "score": 0.00566,
                    "threshold": 0.95
                }
            },
            "landmarkResult": {
                "code": 5000,
                "message": "Success",
                "threshold": 0.95,
                "containerResult": [
                    {
                        "name": "chip",
                        "score": 0.9982
                    },
                    {
                        "name": "card_logo",
                        "score": 0.9975
                    },
                    {
                        "name": "portrait",
                        "score": 0.9951
                    },
                     -----[TRUNCATED]------
                ]
            }
        }
    }
}

Spoof Error Response

Note: This happens when 1 or more than 1 spoof check fails.

HTTP Status Code: 400

Spoof Card JSON Response

{
   "transactionId": "unique transaction id generated to identify this transaction",
   "partnerTrxId": "partner transaction id submitted by customer in request",
   "groupId": "partner group id submitted by customer in request",
   "errors": [
        {
            "message": "Spoof check failed. Image submitted is Recaptured",
            "code": 5601,
            "operations": [
                "idVerification"
            ]
        },
        {
            "message": "Spoof check failed. Image submitted is either B&W or Photocopy",
            "code": 5602,
            "operations": [
                "idVerification"
            ]
        },
        {
            "message": "Spoof check failed. Image submitted is color reprint",
            "code": 5603,
            "operations": [
                "idVerification"
            ]
        }
    ],
    "imageQualityResult": {
        "front": {
            "glare": {
                "score": 0.097592,
                "threshold": 0.95
            },
            "blurriness": {
                "score": 0.004796,
                "threshold": 0.95
            },
            "lowLight": {
                "score": 0.058688,
                "threshold": 0.95
            }
        }
    }
}

MyKas

Request for Front Side Only

{
  "operations": ["idVerification"],
  "payload": {
    "partnerTrxId": "random-uuid",
    "groupId": "random-uuid",
    "idType": "ID_CARD",
    "country": "MYS",
    "idSubtype": "MyKas",
    "idFrontSideImage": "Base64 encoded image of ID front side"
  },
  "userConsent": {
    "userIP": "0.0.0.0",
    "country": "MYS",
    "obtained": true,
    "obtainedAt": "1680700959"
  }
}

Request for Front Side and Back Side

{
  "operations": ["idVerification"],
  "payload": {
    "partnerTrxId": "random-uuid",
    "groupId": "random-uuid",
    "idType": "ID_CARD",
    "country": "MYS",
    "idSubtype": "MyKas",
    "idFrontSideImage": "Base64 encoded image of ID front side",
    "idBackSideImage": "Base64 encoded image of ID back side" //if enabled
  },
  "userConsent": {
    "userIP": "0.0.0.0",
    "country": "MYS",
    "obtained": true,
    "obtainedAt": "1680700959"
  }
}

Success Response

HTTP Status Code: 200

Success JSON Response for Front Side Only

{
    "transactionId": "unique transaction id generated to identify this transaction",
    "partnerTrxId": "partner transaction id submitted by customer in request",
    "groupId": "partner group id submitted by customer in request",
    "card": {
        "country": "MALAYSIA",
        "type": "MyKas",
        "isoAlpha3CountryCode": "MYS",
        "isoAlpha2CountryCode": "MY"
    },
    "imageQualityResult": {
        "front": {
            "blurriness": {
                "score": 0.000112,
                "threshold": 0.95
            },
            "lowLight": {
                "score": 0.195976,
                "threshold": 0.95
            }
        }
    },
    "idVerificationResult": {
        "front": {
            "spoofingResult": {
                "message": "Success",
                "code": 5000,
                "recapScore": {
                    "score": 0.144961,
                    "threshold": 0.95
                },
                "blackWhite": {
                    "score": 0.004127,
                    "threshold": 0.95
                },
                "colorPrint": {
                    "score": 0.477745,
                    "threshold": 0.95
                }
            },
            "landmarkResult": {
                "code": 5000,
                "message": "Success",
                "threshold": 0.95,
                "containerResult": [
                    {
                        "name": "chip",
                        "score": 0.9987
                    },
                    {
                        "name": "malaysia_flag",
                        "score": 0.998
                    },
                    {
                        "name": "card_logo",
                        "score": 0.9967
                    },
                    {
                        "name": "portrait",
                        "score": 0.9961
                    },
                    {
                        "name": "kad_pengenalan_header",
                        "score": 0.9952
                    },
                    {
                        "name": "name",
                        "score": 0.9947
                    },
                    {
                        "name": "id_number",
                        "score": 0.9939
                    }
                ]
            }
        }
    }
}

Success JSON Response for Front Side and Back Side

{
   "transactionId": "unique transaction id generated to identify this transaction",
   "partnerTrxId": "partner transaction id submitted by customer in request",
   "groupId": "partner group id submitted by customer in request",
    "card": {
        "country": "MALAYSIA",
        "type": "MyKas",
        "isoAlpha3CountryCode": "MYS",
        "isoAlpha2CountryCode": "MY"
    },
    "imageQualityResult": {
        "front": {
            "blurriness": {
                "score": 0.000004,
                "threshold": 0.95
            },
            "lowLight": {
                "score": 0.114706,
                "threshold": 0.95
            }
        },
        "back": {
            "blurriness": {
                "score": 0.000009,
                "threshold": 0.95
            },
            "lowLight": {
                "score": 0,
                "threshold": 0.95
            }
        }
    },
    "idVerificationResult": {
        "front": {
            "spoofingResult": {
                "message": "Success",
                "code": 5000,
                "recapScore": {
                    "score": 0.1315,
                    "threshold": 0.95
                },
                "blackWhite": {
                    "score": 0.005892,
                    "threshold": 0.95
                },
                "colorPrint": {
                    "score": 0.063851,
                    "threshold": 0.95
                }
            },
             "landmarkResult": {
                "code": 5000,
                "message": "Success",
                "threshold": 0.95,
                "containerResult": [
                    {
                        "name": "card_logo",
                        "score": 0.9976
                    },
                    {
                        "name": "chip",
                        "score": 0.9968
                    },
                    {
                        "name": "portrait",
                        "score": 0.9958
                    },
                    {
                        "name": "id_number",
                        "score": 0.9951
                    },
                    {
                        "name": "kad_pengenalan_header",
                        "score": 0.9951
                    },
                    {
                        "name": "name",
                        "score": 0.9949
                    },
                    {
                        "name": "malaysia_flag",
                        "score": 0.9927
                    }
                ]
            }
        },
        "back": {
            "spoofingResult": {
                "message": "Success",
                "code": 5000,
                "recapScore": {
                    "score": 0.097179,
                    "threshold": 0.95
                },
                "blackWhite": {
                    "score": 0.040484,
                    "threshold": 0.95
                },
                "colorPrint": {
                    "score": 0.118763,
                    "threshold": 0.95
                }
            },
        "back": {
            "spoofingResult": {
                "message": "Success",
                "code": 5000,
                "recapScore": {
                    "score": 0.097179,
                    "threshold": 0.95
                },
                "blackWhite": {
                    "score": 0.040484,
                    "threshold": 0.95
                },
                "colorPrint": {
                    "score": 0.118763,
                    "threshold": 0.95
                }
            },
            "landmarkResult": {
                "code": 5000,
                "message": "Success",
                "threshold": 0.95,
                "containerResult": [
                    {
                        "name": "my_logo",
                        "score": 0.9973
                    },
                    {
                        "name": "id_number",
                        "score": 0.9963
                    },
                    {
                        "name": "coat_of_arm",
                        "score": 0.991
                    },
                    {
                        "name": "state_registrar",
                        "score": 0.9846
                    }
                ]
            }
        }
    },
                     -----[TRUNCATED]------
                ]
            }
        }
    }
}

Landmark Warning Response

HTTP Status Code: 200

Landmark Card JSON Response

{
    "transactionId": "unique transaction id generated to identify this transaction",
    "partnerTrxId": "partner transaction id submitted by customer in request",
    "groupId": "partner group id submitted by customer in request",
    "warnings": [
        {
            "message": "Image has Occlusion, please check [name] from landmarkResult for more details",
            "code": 10022,
            "operations": [
                "idVerification"
            ]
        }
    ],
    "card": {
        "country": "MALAYSIA",
        "type": "MyKas",
        "isoAlpha3CountryCode": "MYS",
        "isoAlpha2CountryCode": "MY"
    },
    "imageQualityResult": {
        "front": {
            "blurriness": {
                "score": 0.000792,
                "threshold": 0.95
            },
            "lowLight": {
                "score": 0.327588,
                "threshold": 0.95
            }
        }
    },
    "idVerificationResult": {
        "front": {
            "spoofingResult": {
                "message": "Success",
                "code": 5000,
                "recapScore": {
                    "score": 0.181131,
                    "threshold": 0.95
                },
                "blackWhite": {
                    "score": 0.003997,
                    "threshold": 0.95
                }
            },
            "landmarkResult": {
                "code": 5000,
                "message": "Success",
                "threshold": 0.95,
                "containerResult": [
                    {
                        "name": "card_logo",
                        "score": 0.9991
                    },
                    {
                        "name": "malaysia_flag",
                        "score": 0.9977
                    },
                    {
                        "name": "chip",
                        "score": 0.9956
                    }
                    -----[TRUNCATED]------
                ]
            }
        }
    }
}

Spoof Error Response

Note: This happens when 1 or more than 1 spoof check fails.

HTTP Status Code: 400

Spoof Card JSON Response

{
    "transactionId": "unique transaction id generated to identify this transaction",
    "partnerTrxId": "partner transaction id submitted by customer in request",
    "groupId": "partner group id submitted by customer in request",
    "errors": [
        {
            "message": "Spoof check failed. Image submitted is Recaptured",
            "code": 5601,
            "operations": [
                "idVerification"
            ]
        },
        {
            "message": "Spoof check failed. Image submitted is either B&W or Photocopy",
            "code": 5602,
            "operations": [
                "idVerification"
            ]
        },
        {
            "message": "Spoof check failed. Image submitted is color reprint",
            "code": 5603,
            "operations": [
                "idVerification"
            ]
        }
    ],
    "imageQualityResult": {
        "front": {
            "blurriness": {
                "score": 0.000002,
                "threshold": 0.95
            },
            "lowLight": {
                "score": 0.009899,
                "threshold": 0.95
            }
        }
    }
}

MyPR

Request for Front Side Only

{
  "operations": ["idVerification"],
  "payload": {
    "partnerTrxId": "random-uuid",
    "groupId": "random-uuid",
    "idType": "ID_CARD",
    "country": "MYS",
    "idSubtype": "MyPR",
    "idFrontSideImage": "Base64 encoded image of ID front side"
  },
  "userConsent": {
    "userIP": "0.0.0.0",
    "country": "MYS",
    "obtained": true,
    "obtainedAt": "1680700959"
  }
}

Request for Front Side and Back Side

{
  "operations": ["idVerification"],
  "payload": {
    "partnerTrxId": "random-uuid",
    "groupId": "random-uuid",
    "idType": "ID_CARD",
    "country": "MYS",
    "idSubtype": "MyPR",
    "idFrontSideImage": "Base64 encoded image of ID front side",
    "idBackSideImage": "Base64 encoded image of ID back side" //if enabled
  },
  "userConsent": {
    "userIP": "0.0.0.0",
    "country": "MYS",
    "obtained": true,
    "obtainedAt": "1680700959"
  }
}

Success Response

HTTP Status Code: 200

Success JSON Response for Front Side Only

{
    "transactionId": "unique transaction id generated to identify this transaction",
    "partnerTrxId": "partner transaction id submitted by customer in request",
    "groupId": "partner group id submitted by customer in request",
    "card": {
        "country": "MALAYSIA",
        "type": "MyPR",
        "isoAlpha3CountryCode": "MYS",
        "isoAlpha2CountryCode": "MY"
    },
    "imageQualityResult": {
        "front": {
            "blurriness": {
                "score": 0.000057,
                "threshold": 0.95
            },
            "lowLight": {
                "score": 0.644854,
                "threshold": 0.95
            }
        }
    },
    "idVerificationResult": {
        "front": {
            "spoofingResult": {
                "message": "Success",
                "code": 5000,
                "recapScore": {
                    "score": 0.17317,
                    "threshold": 0.95
                },
                "blackWhite": {
                    "score": 0.003875,
                    "threshold": 0.95
                },
                "colorPrint": {
                    "score": 0.477745,
                    "threshold": 0.95
                }
            },
            "landmarkResult": {
                "code": 5000,
                "message": "Success",
                "threshold": 0.95,
                "containerResult": [
                    {
                        "name": "chip",
                        "score": 0.9972
                    },
                    {
                        "name": "portrait",
                        "score": 0.9963
                    },
                    -----[TRUNCATED]------ 
                ]
            }
        }
    }
}

Success JSON Response for Front Side and Back Side

{
   "transactionId": "4e708e41-567b-4230-988d-26bd660b2797",
    "partnerTrxId": "4dfe72a5-fdb1-4127-8fe6-b778fb853a95",
    "groupId": "581edbe0-887b-4533-8254-7cd6ff9c89b2",
    "card": {
        "country": "MALAYSIA",
        "type": "MyPR",
        "isoAlpha3CountryCode": "MYS",
        "isoAlpha2CountryCode": "MY"
    },
    "imageQualityResult": {
        "front": {
            "blurriness": {
                "score": 0.000053,
                "threshold": 0.95
            },
            "lowLight": {
                "score": 0.166888,
                "threshold": 0.95
            }
        },
        "back": {
            "blurriness": {
                "score": 0.000209,
                "threshold": 0.95
            },
            "lowLight": {
                "score": 0,
                "threshold": 0.95
            }
        }
    },
    "idVerificationResult": {
        "front": {
            "spoofingResult": {
                "message": "Success",
                "code": 5000,
                "recapScore": {
                    "score": 0.147336,
                    "threshold": 0.95
                },
                "blackWhite": {
                    "score": 0.005015,
                    "threshold": 0.95
                },
                "colorPrint": {
                    "score": 0.355417,
                    "threshold": 0.95
                }
            },
            "landmarkResult": {
                "code": 5000,
                "message": "Success",
                "threshold": 0.95,
                "containerResult": [
                    {
                        "name": "kad_pengenalan_header",
                        "score": 0.9966
                    },
                    {
                        "name": "chip",
                        "score": 0.9965
                    },
                    {
                        "name": "portrait",
                        "score": 0.9962
                    },
                    {
                        "name": "card_logo",
                        "score": 0.996
                    },
                    {
                        "name": "malaysia_flag",
                        "score": 0.9947
                    },
                    {
                        "name": "id_number",
                        "score": 0.9946
                    },
                    {
                        "name": "name",
                        "score": 0.9935
                    }
                ]
            }
        },
        "back": {
            "spoofingResult": {
                "message": "Success",
                "code": 5000,
                "recapScore": {
                    "score": 0.116926,
                    "threshold": 0.95
                },
                "blackWhite": {
                    "score": 0.011473,
                    "threshold": 0.95
                },
                "colorPrint": {
                    "score": 0.319818,
                    "threshold": 0.95
                }
            },
            "landmarkResult": {
                "code": 5000,
                "message": "Success",
                "threshold": 0.95,
                "containerResult": [
                    {
                        "name": "coat_of_arm",
                        "score": 0.9972
                    },
                    {
                        "name": "id_number",
                        "score": 0.9952
                    },
                    {
                        "name": "my_logo",
                        "score": 0.9937
                    },
                    {
                        "name": "state_registrar",
                        "score": 0.9927
                    },
                    {
                        "name": "negara_asal",
                        "score": 0.9912
                    },
                     -----[TRUNCATED]------
                ]
            }
        }
    }
}

Landmark Warning Response

HTTP Status Code: 200

Landmark Card JSON Response

{
    "transactionId": "unique transaction id generated to identify this transaction",
    "partnerTrxId": "partner transaction id submitted by customer in request",
    "groupId": "partner group id submitted by customer in request",
    "warnings": [
        {
            "message": "Image has Occlusion, please check [name] from landmarkResult for more details",
            "code": 10022,
            "operations": [
                "idVerification"
            ]
        }
    ],
    "card": {
        "country": "MALAYSIA",
        "type": "MyKas",
        "isoAlpha3CountryCode": "MYS",
        "isoAlpha2CountryCode": "MY"
    },
    "imageQualityResult": {
        "front": {
            "blurriness": {
                "score": 0.000792,
                "threshold": 0.95
            },
            "lowLight": {
                "score": 0.327588,
                "threshold": 0.95
            }
        }
    },
    "idVerificationResult": {
        "front": {
            "spoofingResult": {
                "message": "Success",
                "code": 5000,
                "recapScore": {
                    "score": 0.181131,
                    "threshold": 0.95
                },
                "blackWhite": {
                    "score": 0.003997,
                    "threshold": 0.95
                }
            },
            "landmarkResult": {
                "code": 5000,
                "message": "Success",
                "threshold": 0.95,
                "containerResult": [
                    {
                        "name": "card_logo",
                        "score": 0.9991
                    },
                    {
                        "name": "malaysia_flag",
                        "score": 0.9977
                    },
                    {
                        "name": "chip",
                        "score": 0.9956
                    },
                    {
                        "name": "kad_pengenalan_header",
                        "score": 0.9934
                    },
                    {
                        "name": "portrait",
                        "score": 0.9865
                    },
                    {
                        "name": "id_number",
                        "score": 0.9612
                    },
                    {
                        "name": "name",
                        "score": 0
                    }
                ]
            }
        }
    }
}

Spoof Error Response

Note: This happens when 1 or more than 1 spoof check fails.

HTTP Status Code: 400

Spoof Card JSON Response

{
    "transactionId": "unique transaction id generated to identify this transaction",
    "partnerTrxId": "partner transaction id submitted by customer in request",
    "groupId": "partner group id submitted by customer in request",
    "errors": [
        {
            "message": "Spoof check failed. Image submitted is Recaptured",
            "code": 5601,
            "operations": [
                "idVerification"
            ]
        },
        {
            "message": "Spoof check failed. Image submitted is either B&W or Photocopy",
            "code": 5602,
            "operations": [
                "idVerification"
            ]
        },
        {
            "message": "Spoof check failed. Image submitted is color reprint",
            "code": 5603,
            "operations": [
                "idVerification"
            ]
        }
    ],
    "imageQualityResult": {
        "front": {
            "glare": {
                "score": 0,
                "threshold": 0.95
            },
            "blurriness": {
                "score": 0.008268,
                "threshold": 0.95
            },
            "lowLight": {
                "score": 0.029575,
                "threshold": 0.95
            }
        }
    }
}