ID-Verification

This API is used to validate an ID card's authenticity. The API would include "idVerification" in the operations list and supply relevant image data of the ID card. The API then inspects the document for landmarks, checks for potential forgery, and identifies possible spoofing attempts. The result of the verification process is returned to the user.

Users must include "idVerification" in the operations list and provide necessary data in the request's payload. After successfully processing the request, the service returns the results in a structured JSON format.

API Description

POST https://{vida-host}/api/v1/verify/summary

Headers

Name	Type	Description
Content-Type		Format type of request body
Authentication*	String	Bearer <Token>

Request Body

Name	Type	Description
operations*	String	["idVerification"]
payload*	String	{ "partnerTrxId": "random-uuid", "groupId": "random-uuid", "country": "country code", "idType": "ID_TYPE", "idSubtype": "IDSubType", "idFrontSideImage": "Base64 encoded image of ID frontside" }
userConsent*	String	{ "userIp": "0.0.0.0", "country": "MYS", "obtained": true, "obtainedAt": "1680700959" }

🔍 Spoof Check - Malaysian and KTP cards

• Malaysian Cards: Spoof detection involves multiple techniques to verify authenticity and ensure the image is not recaptured or in black and white.

• KTP Cards: Spoof detection involves various techniques to verify the card's authenticity and checks for recapture, black and white, colour print, and screenshots to prevent fraud.

📍 Landmark Check - Malaysian and KTP cards

Landmark checks for Malaysian cards and KTP cards involve examining specific features and elements designed to verify the card's authenticity.

🛡️ Forgery check - MyKad and KTP cards

⚠️ NOTE: Forgery checks are only supported for MyKad and KTP cards.

• MyKad: The process involves a series of steps to verify the card's authenticity and detect any signs of tampering or counterfeit.

• KTP: The process involves examining various security features and elements to ensure the card's authenticity and detect any signs of tampering.

NOTE: For the summary endpoint, all the above checks will still be executed, but the final response will not include detailed results for each check. Instead, it will return a simple pass/fail IDV response.