Skip to main content

eKYC Flow Error Codes

Error codes returned from the FPT AI eKYC system fall into 3 main categories: common errors, OCR/NFC errors, and face verification errors.

  1. Common errors: arise when the API is used incorrectly (missing or incorrect information, quota exceeded, ...) or from unspecified errors that prevent the request from reaching the processing engine.

  2. OCR/NFC errors: detected when the system checks the document image or the data in the NFC chip. They are grouped as follows:

  3. Face verification errors: detected when the system performs the liveness check and face matching.

How to read the Applies to column​

Some error codes only appear for certain document types, or the same code has a different meaning depending on the document type. The Applies to column shows which documents a code is used for.

  • All documents: the code can be returned for any document type.
  • A specific document type (for example: Passport, Driver's license, Chip-based Citizen ID): the code is only returned for that document type.
  • The same code on multiple rows: each row is a different meaning, so match it against the document type you are submitting.

Vietnamese identity documents fall into 5 groups. Vietnamese ID means all 5 groups; when a code applies to only some groups, the Applies to column names the specific groups:

GroupDescription
9-digit ID cardIdentity card (CMND) with a 9-digit number
12-digit ID card / barcode Citizen IDIdentity card (CMND) with a 12-digit number, and the Citizen ID card without a chip (commonly called the barcode Citizen ID)
Chip-based Citizen IDChip-based Citizen ID card (issued from 23 January 2021)
Citizen ID 2024Commonly called the Citizen ID (Căn cước), issued from 1 July 2024
Citizen ID U6Citizen ID issued to children under 6 years old

1. Common errors​

The error codes in this section apply to all document types.

HTTP CodeError CodeEnglish Error MessageVietnamese Error MessageMeaning
500-1There is something wrong. Please try again.Có lỗi xảy ra. Vui lòng thử lại.An unknown error occurred while processing the request
200400api-key must be providedMissing or incorrect API key
200400document-type header must be providedMissing document type information. Allowed values are "idr" / "dlr" / "passport"
200400document-type value is invalidThe document type information was provided but is not one of the allowed values. Allowed values are "idr" / "dlr" / "passport"
401Invalid tokenInvalid token
403403Session expiredThe eKYC session has expired
200400uuid must be providedMissing session ID information
200400country code value is invalidInvalid country code information. The allowed value is "vi"
200E101Front picture must be taken firstSai thứ tự chụp ảnh. Vui lòng chụp mặt trước rồi đến mặt sauThe front side of the document must be sent first
200E102Document type is not supportedLoại giấy tờ không được hỗ trợInvalid document type. Allowed values are "idr" / "dlr" / "passport"
200E103Please capture your rear documentVui lòng chụp mặt sau giấy tờOnce the front side has been sent in the session, the front side cannot be sent again
200E104Please ensure that you request the correct number of filesVui lòng upload số lượng file đúng yêu cầuOnly the required number of files can be uploaded (1 or 2 files per request)
200E105Your age is not within the permitted rangeTuổi của bạn không nằm trong phạm vi cho phépeKYC can only be performed if the user is within the eligible age range
403-1Session expiredPhiên làm việc đã hết hạn(Session error) The session has expired
4030Invalid hashMã băm không hợp lệ(Session error) The submitted hash code is invalid
4031Please capture your document firstHãy thực hiện bước chụp ảnh giấy tờ trước(Session error) The document capture step has not been performed yet
4032Retry limit exceededQuá số lần thử cho phép(Session error) The allowed number of attempts in the session has been exceeded
4033Session is not completePhiên làm việc chưa hoàn thành(Session error) The session is not complete
4034Document not found in the session processKhông tìm thấy tài liệu trong phiên(Session error) No document was found in the current session

2. OCR/NFC errors​

2.1. OCR input file errors​

Code 2 has a different meaning for Passport and for the other documents, so it is split into 2 rows.

HTTP CodeError CodeEnglish Error MessageVietnamese Error MessageApplies toMeaning
2001Invalid Parameters or Values!Giá trị tham số không hợp lệAll documentsIncorrect information in the request
2002Please upload only 2 images in the listChỉ được upload tối đa 2 ảnh trong 1 requestVietnamese IDMore than 2 images were sent in one request
2002Failed in croppingKhông cắt được ảnh giấy tờPassportThe system could not crop the document area from the image
2003Unable to find the selected document in the imageKhông tìm thấy tài liệu đã chọn trong ảnhAll documentsNo valid document was found in the image (no document of the correct type, or the document quality is too poor)
2004Downloading file timed outTải file bị quá thời gian chờAll documentsDownloading the image from the URL timed out
2005No URL in the requestKhông có URL trong requestAll documentsThe request has no image URL
2006Failed to open the URLKhông thể mở được URLAll documentsThe submitted image URL could not be opened
2007Invalid image fileFile ảnh không đúng định dạngAll documentsThe uploaded image file is corrupted
20011Quality check failedChất lượng ảnh không đạtAll documentsThe image does not meet the quality requirements when image quality checking is enabled. For the detailed cause, see section 2.2

2.2. OCR image quality errors​

The image quality codes apply to Vietnamese ID and Passport.

HTTP CodeError CodeEnglish Error MessageVietnamese Error MessageMeaning
200QC00Unable to find the selected document in the imageKhông tìm thấy tài liệu đã chọn trong ảnhNo valid document was found in the image (no document of the correct type, or the document quality is too poor)
200QC01Image resolution is too lowẢnh có độ phân giải quá thấpThe image resolution is too low. The minimum is 640x480
200QC02Image has bright spot(s)Ảnh bị bóng sángThe document in the image has glare
200QC03Image is blurryẢnh bị mờThe image is blurry
200QC04Image has bad luminanceẢnh bị quá sáng hoặc quá tốiThe lighting of the image is poor (too bright or too dark)
200QC05The image's document size is too small compared to the imageẢnh bị kích thước tài liệu quá nhỏ so với ảnhThe area of the document in the image is too small compared to the total image area

2.3. OCR fraud detection errors​

Each document type has different security features (QR code, chip, MRZ, fingerprint, ...), so many codes in this group only apply to some document types. See the Applies to column.

HTTP CodeError CodeEnglish Error MessageVietnamese Error MessageApplies toMeaning
200FC01Document is black-and-white photocopyGiấy tờ là bản photocopy đen trắngVietnamese IDThe document is a black-and-white photocopy. For Passport, a black-and-white photocopy is reported with code FC03
200FC02Document has been re-captured from LCD screenGiấy tờ là bản chụp lại từ màn hình LCDVietnamese ID, PassportThe document was re-captured from an LCD screen
200FC03Document has been edited or is colored photocopyGiấy tờ đã bị chỉnh sửa hoặc bản photocopy màuVietnamese IDThe document is a color photocopy or has been edited
200FC03Document has been edited or is photocopyGiấy tờ đã bị chỉnh sửa hoặc bản photocopyPassportThe document is a photocopy (black-and-white or color) or has been edited
200FC04Document has been corneredGiấy tờ bị cắt gócVietnamese ID, PassportThe document has been cornered
200FC05Missing face on front side of documentThiếu khuôn mặt trên mặt trước của giấy tờVietnamese ID, PassportNo face was found on the front side of the document
200FC06Missing QRcode on documentThiếu QRcode trên giấy tờChip-based Citizen ID, Citizen ID 2024No QR code was found on the document
200FC07Missing MRZ on back side of documentThiếu MRZ trên mặt sau của giấy tờChip-based Citizen ID, Citizen ID 2024No MRZ area was found on the back side of the document
200FC07Missing MRZ on the documentThiếu MRZ trên giấy tờPassportNo MRZ area was found on the passport
200FC08Missing emblem on front side of documentThiếu quốc huy trên mặt trước của giấy tờVietnamese IDNo national emblem was found on the front side of the document
200FC09Missing headline on front side of documentThiếu tiêu ngữ trên mặt trước của giấy tờVietnamese IDNo national motto (headline) was found on the front side of the document
200FC10Missing title on front side of documentThiếu tiêu đề trên mặt trước của giấy tờVietnamese IDNo title was found on the front side of the document
200FC11Missing fingerprint on back side of documentThiếu vân tay trên mặt sau của giấy tờVietnamese IDThe fingerprint is missing on the back side of the document
200FC12Missing stamp on back side of documentThiếu con dấu trên mặt sau của giấy tờVietnamese IDNo stamp was found on the back side of the document
200FC13Missing chip on back side of documentThiếu chip trên mặt sau của giấy tờChip-based Citizen ID, Citizen ID 2024, Citizen ID U6No chip was found on the back side of the document
200FC14OCR result is uncertainKết quả OCR không chắc chắnVietnamese IDThe recognition (OCR) result is not reliable enough
200FC15ID is uncertainKết quả OCR của trường ID không chắc chắnVietnamese IDThe recognition (OCR) result of the ID number field is not reliable enough
200FC16Front side and back side are not from the same backgroundMặt trước và mặt sau có nền không giống nhauVietnamese IDThe backgrounds of the front and back side images are unusually different
200FC17Missing barcode on back side of documentThiếu mã vạch trên mặt sau của giấy tờ12-digit ID card / barcode Citizen IDNo barcode area was found on the back side of the document
200FC18Missing Anti-counterfeiting stamps on back side of documentThiếu tem chống hàng giả trên mặt sau của giấy tờ12-digit ID card / barcode Citizen IDNo anti-counterfeiting stamp was found on the back side of the document
200FC19Document has been watermarkGiấy tờ bị đóng dấu mờVietnamese IDThe document has been watermarked
200FC20Document has been perforatedGiấy tờ bị đục lỗPassportThe passport shows signs of perforation in the MRZ area
200FC21Document is partially coveredGiấy tờ bị che khuất một phầnVietnamese IDThe document is partially covered in the image

2.4. OCR post-check errors​

The post-check function compares the information on the document against the rules of each document type, so the same error code can have different meanings across document types (for example E05, E10, E21, E22, E23, E30). When a code appears on multiple rows, choose the row whose Applies to column matches the document type you are submitting.

HTTP CodeError CodeEnglish Error MessageVietnamese Error MessageApplies toMeaning
200E-1Cannot do postcheckKhông thể thực hiện postcheckAll documentsAn error occurred during the post-check
200E01There is a blank fieldCó một hoặc nhiều trường bị trốngAll documentsThere is a blank field in the OCR result
200E02ID format is not correctCấu trúc ID saiVietnamese ID, PassportThe format of the ID number is incorrect
200E02ID format is not correctCấu trúc số bằng lái xe saiDriver's licenseThe format of the driver's license number is incorrect
200E03DoB format is not correctCấu trúc ngày sinh saiAll documentsThe format of the date of birth is incorrect
200E04DoB is later than todayNgày sinh không thể sau ngày hôm nayAll documentsThe date of birth in the OCR result cannot be later than today
200E05Current age cannot be smaller than 14Tuổi hiện tại không thể dưới 149-digit ID card, 12-digit ID card / barcode Citizen ID, Chip-based Citizen IDA current age under 14 is invalid. Citizen ID 2024 uses the age 6 threshold (code E36)
200E05Current age is invalidTuổi hiện tại không hợp lệDriver's licenseThe holder's current age is invalid (the minimum age may differ by country)
200E06Nationality is not correctQuốc tịch không đúngChip-based Citizen ID, Citizen ID 2024, Citizen ID U6The nationality must be Vietnam
200E07Year in DoB does not match with ID numberNăm sinh không khớp với số ID12-digit ID card / barcode Citizen ID, Chip-based Citizen ID, Citizen ID 2024, Citizen ID U6, PassportThe year of birth does not match the ID number
200E08Gender code does not matchMã giới tính không khớp với số ID12-digit ID card / barcode Citizen ID, Chip-based Citizen ID, Citizen ID 2024, Citizen ID U6, PassportThe gender code in the ID number does not match
200E09DoE format is not correctCấu trúc ngày hết hạn không đúngAll documents except 9-digit ID cardThe format of the expiry date is incorrect
200E10ID card has been expiredGiấy tờ hết hạnVietnamese IDThe document has expired
200E10Driving License has been expiredGiấy phép lái xe hết hạnDriver's licenseThe driver's license has expired
200E11DoE cannot be KHÔNG THỜI HẠNNgày hết hạn không thể là không thời hạn12-digit ID card / barcode Citizen ID, Chip-based Citizen ID, Citizen ID 2024, Citizen ID U6The document shows the expiry date as KHÔNG THỜI HẠN (no expiry), but the holder is not yet old enough to be issued a no-expiry document
200E12DoI format is not correctCấu trúc ngày cấp không đúngAll documentsThe format of the issue date is incorrect
200E13DoI is later than todayNgày cấp không thể sau ngày hôm nayAll documentsThe issue date in the OCR result cannot be later than today
200E15Please send images of the front and the back side of same type ID (old or new ID)Hai mặt của giấy tờ không khớpVietnamese ID, Driver's licenseThe two sides of the document are not of the same type. For Vietnamese documents, only a front and back side of the same group are accepted; Citizen ID 2024 and Citizen ID U6 share the same Citizen ID back side
200E18DoE should be DoI + 15 yearsNgày hết hạn phải là ngày cấp cộng thêm 15 năm12-digit ID cardThe expiry date of the submitted document must be 15 years after the issue date
200E19DoE should be birthday at 25 years oldNgày hết hạn phải là ngày sinh nhật 25 tuổiBarcode Citizen ID, Chip-based Citizen ID, Citizen ID 2024The expiry date of the submitted document must be the 25th birthday
200E20DoE should be birthday at 40 years oldNgày hết hạn phải là ngày sinh nhật 40 tuổiBarcode Citizen ID, Chip-based Citizen ID, Citizen ID 2024The expiry date of the submitted document must be the 40th birthday
200E21DoE should be birthday at 60 years oldNgày hết hạn phải là ngày sinh nhật 60 tuổiBarcode Citizen ID, Chip-based Citizen ID, Citizen ID 2024The expiry date of the submitted document must be the 60th birthday
200E21Passport has been expiredHộ chiếu đã hết hạnPassportThe passport has expired
200E22DoE should be KHÔNG THỜI HẠNNgày hết hạn phải là không thời hạnBarcode Citizen ID, Chip-based Citizen ID, Citizen ID 2024The holder is old enough to be issued a no-expiry document, but the submitted document shows a specific expiry date
200E22Passport number format is not correctSố hộ chiếu không đúng định dạngPassportThe format of the passport number is incorrect
200E23Name format is not correctTên không đúng định dạngPassportThe format of the full name on the passport is incorrect
200E30Front side and back side are not from the same cardMặt trước và mặt sau giấy tờ không khớpChip-based Citizen ID, Citizen ID 2024, Citizen ID U6The two sides are not from the same document (the MRZ information on the back side does not match the front side). This code can also be returned when the system cannot complete the MRZ check, so it does not necessarily mean the document shows signs of forgery
200E30MRZ data does not match OCR resultThông tin MRZ không khớp với kết quả OCRPassportThe information in the MRZ area does not match the OCR information read from the passport page
200E31Issue location does not match issue dateNơi cấp không khớp với ngày cấp12-digit ID card / barcode Citizen IDDepending on the period in which the document was issued, the place of issue changes accordingly
200E32Type of document does not match issue dateLoại giấy tờ không khớp với ngày cấpChip-based Citizen ID, Citizen ID 2024, Citizen ID U6Chip-based Citizen ID started to be issued on 23 January 2021. Citizen ID 2024 started to be issued on 1 July 2024
200E33DoE should be birthday at 14 years oldNgày hết hạn phải là ngày sinh nhật 14 tuổiBarcode Citizen ID, Chip-based Citizen ID, Citizen ID 2024, Citizen ID U6The expiry date of the document must be the 14th birthday
200E36Current age cannot smaller than 6Tuổi hiện tại không thể dưới 6Citizen ID 2024 (not Citizen ID U6)The holder of the Citizen ID 2024 is currently under 6 years old. People under 6 are issued the Citizen ID U6
200E37Age at issue date cannot smaller than 6Tuổi trên giấy tờ dưới 6 ở thời điểm cấpCitizen ID 2024 (not Citizen ID U6)The Citizen ID 2024 was issued when the holder was under 6 years old. People under 6 are issued the Citizen ID U6
200E110Wrong side-type of documentSai mặt giấy tờAll documentsThe wrong side of the document was sent. For example: side-type is "front" but an image of the back side was sent
200EDB01Invalid personal informationThông tin cá nhân không hợp lệVietnamese IDThe personal information on the document is invalid when compared (after the identity fraud check feature is enabled)
200QR01QR code does not match OCR resultQR code không khớp với kết quả OCRChip-based Citizen ID, Citizen ID 2024, Citizen ID U6At least one information field in the QR code result does not match the OCR result
200QR02QR code format is not correctQR code không đúng định dạngChip-based Citizen ID, Citizen ID 2024, Citizen ID U6The QR code is invalid for the document type, or an error occurred while processing the QR code
200MRZ01MRZ format errorLỗi định dạng MRZChip-based Citizen ID, Citizen ID 2024, Citizen ID U6, PassportThe MRZ area on the document is invalid (for example: wrong format or incorrect data in the MRZ)

2.5. NFC data verification errors​

The codes in this section only apply to Chip-based Citizen ID and Citizen ID 2024 (verification of the data in the NFC chip).

HTTP CodeError CodeEnglish Error MessageVietnamese Error MessageMeaning
2000Check chip successfullyCheck chip thành côngThe chip check request succeeded
200CC01Data is not integrityDữ liệu trong chip không toàn vẹnThe data in the chip is not intact
200CC02Data is cloneDữ liệu bị sao chépThe data has been cloned
200CC03C06 authentication failedXác thực BCA thất bạiRAR authentication failed

3. Face verification errors​

The face verification error codes (liveness check and face matching) apply to all document types.

HTTP CodeError CodeEnglish Error MessageVietnamese Error MessageMeaning
200200No error
200301Face in video is spoofKiểm tra thực thể sống không thành côngThe liveness check failed
200302Video seems like deepfakeVideo có dấu hiệu chỉnh sửaThe video shows signs of editing
200303Face is not matching with documentKhuôn mặt không khớp với giấy tờThe face in the video/selfie image does not match the face on the document
200406Face quality is not good enough (covered, too dark/bright..)Chất lượng video không đạt (khuôn mặt bị che, ngược sáng,..)The face image quality is poor (covered, too dark or too bright, ...)
200407No face/More than 1 face in documentKhông tìm thấy hoặc có nhiều hơn 1 khuôn mặt trong giấy tờNo face was found, or more than 1 face was found, in the document
200408More than 1 face in the videoXuất hiện nhiều hơn 1 khuôn mặt trong khung hìnhMore than 1 face was found in the video/selfie image
200409No video uploaded/Wrong extension/Video is too short/Invalid inputVideo quá ngắnNo video was uploaded / the video has the wrong format / the video is too short / the video is invalid
200410No face/Lost face in the videoMất dấu khuôn mặt trong quá trình quay videoNo face was found, or the face was lost, in the video
200411The face is too smallKhuôn mặt quá nhỏ, vui lòng đưa lại gần màn hình hơnThe face in the video is too small
200412The face is too blurryVideo quá mờThe face in the video is blurry
200413Video is still imageVideo trông giống ảnhThe video is a recording of a still image
200422No frontal face in videoKhông xuất hiện khuôn mặt thẳng trong khung hìnhNo frame with a frontal face was found in the video
200423Face is out of frame during videoKhuôn mặt bị ra khỏi khung hìnhThe face went out of the frame
200424The requested face pose is not validQuay trái phải không hợp lệThe left/right head turning is invalid
200500Internal server errorLỗi hệ thốngA system error occurred during the face check. Please try again
200504Read timed outQuá thời gian chờThe face matching system took too long to respond. Please try again
200W100Please do not close your eyesVui lòng không nhắm mắtBoth eyes were detected as closed
200W103Please do not close your eyesVui lòng không nhắm mắtOne eye (left or right) was detected as closed
200W105Glasses detectedPhát hiện đeo kínhThe user was detected wearing glasses. Please remove the glasses and try again