tencent cloud

PrevNext

Feedback

search by keyword

Recent Pages

Documentation
eKYC
    Documentation
    Download PDF

    Error Codes

    Last updated: 2023-07-04 16:31:45
    Download PDF
      This document describes all error codes of the eKYC product and whether a request is billed ("N" for no and "Y" for yes) in the case of an error code.

      Common Error Codes (for All Services)

      Error Code
      Description
      Billed
      InvalidParameter
      Invalid parameter
      N
      InvalidParameterValue.BizTokenIllegal
      Invalid BizToken
      N
      InvalidParameterValue.BizTokenExpired
      BizToken expired
      N
      UnauthorizedOperation.Nonactivated
      The service has not been activated.
      N
      UnauthorizedOperation.Activating
      The service is being activated
      N
      UnauthorizedOperation.ActivateError
      The service has not been activated
      N
      UnauthorizedOperation.Arrears
      The account has overdue payments
      N
      OperationDenied
      Operation denied
      N
      UnauthorizedOperation.NonAuthorize
      Identity verification has not been completed for the account.
      N
      UnauthorizedOperation
      Unauthorized operation
      N
      FailedOperation.ImageSizeTooLarge
      Image size too large
      N
      InternalError
      Internal error
      N
      The following tables list the error codes of the eKYC subproducts:

      Liveness Detection and Face Comparison (Mobile HTML5) Error Codes

      Error Code
      Description
      Billed
      0
      Success
      Y
      1
      Invalid parameter
      N
      2
      Incorrect parameter value
      N
      3
      Bad request
      N
      4
      Internal service error
      N
      8
      Internal service error
      N
      9
      Internal service error
      N
      10
      Internal service error
      N
      11
      Internal service error
      N
      14
      Verification has been completed
      N
      15
      Token expired
      N
      16
      Retry limit has been reached
      N
      202
      Failed to get video
      N
      1001
      Failed to call the liveness engine
      N
      1002
      Suspected spoofed recording.
      N
      1003
      Real person detection failed
      N
      1004
      Face detection failed
      N
      1005
      Liveness detection failed
      N
      1101
      No sound is detected
      N
      1102
      The face is not fully exposed
      N
      1103
      Speech recognition failed
      N
      1104
      The video format is incorrect
      N
      1105
      Failed to pull the video. Please try again
      N
      1106
      The volume of the video is too low
      N
      1107
      The video is empty or its size is inappropriate. The recording duration should be about 6 seconds
      N
      1108
      The video definition is too low
      N
      1109
      The lip movement range is too small
      N
      1201
      The lighting is too dim
      N
      1202
      The lighting is too strong
      N
      1203
      The face is too close to the screen
      N
      1204
      The face is too far right from the screen
      N
      1205
      The face is too far from the screen
      N
      1206
      The face is too far left from the screen
      N
      1207
      No motions of eye closing are detected
      N
      1208
      The first motion is not detected
      N
      1209
      No motions of mouth opening are detected
      N
      1210
      Failed to detect a full face
      N
      1301
      Real person detection failed
      N
      1302
      Real person detection did not reach the passing standard
      N
      1303
      The video is too short. Please capture a video longer than 2 seconds
      N
      2001
      Error calling the comparison engine
      N
      2004
      The image passed in is too large or too small
      N
      2010
      Multiple faces are detected
      N
      2011
      Real person comparison failed
      N
      2012
      Failed to detect a full face
      N
      2013
      No faces are detected
      N
      2014
      The resolution of the image passed in is too low. Please upload a new one
      N
      2015
      Comparison failed
      N
      2016
      The comparison similarity did not reach the passing standard
      Y
      1401
      face reflect liveness detect failed
      N

      Liveness Detection and Face Comparison (App SDK) Error Codes

      Error Code
      Description
      Billed
      0
      Succeeded
      Y
      1001
      System error
      N
      1004
      Liveness detection and face comparison failed
      N
      2004
      The image passed in is too large or too small
      N
      2012
      Several faces were detected
      N
      2013
      No face was detected, or the face detected was incomplete
      N
      2014
      The image resolution is too low or the quality does not meet the requirements
      N
      2015
      Face comparison failed
      N
      2016
      The similarity did not reach the standard passing threshold
      Y
      -999
      The verification process wasn't finished
      N

      Liveness Detection and Face Comparison (Pure API) Error Codes

      Error Code
      Description
      Billed
      Success
      Success
      Y
      FailedOperation.CompareLowSimilarity
      The comparison similarity did not reach the passing standard.
      Y
      FailedOperation.ActionCloseEye
      No motions of eye closing are detected.
      N
      FailedOperation.ActionFaceClose
      The face is too close to the screen.
      N
      FailedOperation.ActionFaceFar
      The face is too far from the screen.
      N
      FailedOperation.ActionFaceLeft
      The face is too far left from the screen.
      N
      FailedOperation.ActionFaceRight
      The face is too far right from the screen.
      N
      FailedOperation.ActionFirstAction
      No movement is detected.
      N
      FailedOperation.ActionLightDark
      The lighting is too dim.
      N
      FailedOperation.ActionLightStrong
      The lighting is too strong.
      N
      FailedOperation.ActionNodetectFace
      Failed to detect a full face.
      N
      FailedOperation.ActionOpenMouth
      No motions of mouth opening are detected.
      N
      FailedOperation.CompareFail
      Comparison failed.
      N
      FailedOperation.CompareSystemError
      Error calling the comparison engine API.
      N
      FailedOperation.DownLoadError
      File download failed.
      N
      FailedOperation.DownLoadTimeoutError
      File download timed out.
      N
      FailedOperation.LifePhotoDetectFaces
      Multiple faces are detected.
      N
      FailedOperation.LifePhotoDetectFake
      Real person comparison failed.
      N
      FailedOperation.LifePhotoDetectNoFaces
      Failed to detect a full face.
      N
      FailedOperation.LifePhotoPoorQuality
      The resolution of the image passed in is too low. Please upload a new one.
      N
      FailedOperation.LifePhotoSizeError
      The image passed in is too large or too small.
      N
      FailedOperation.LipFaceIncomplete
      The face is not fully exposed.
      N
      FailedOperation.LipMoveSmall
      The lip movement range is too small.
      N
      FailedOperation.LipNetFailed
      Failed to pull the video. Please try again.
      N
      FailedOperation.LipSizeError
      The video is empty or its size is inappropriate. The recording duration should be about 6 seconds.
      N
      FailedOperation.LipVideoInvalid
      The video format is incorrect.
      N
      FailedOperation.LipVideoQuaility
      The video definition is too low.
      N
      FailedOperation.LipVoiceDetect
      No sound is detected.
      N
      FailedOperation.LipVoiceLow
      The volume of the video is too low.
      N
      FailedOperation.LipVoiceRecognize
      Speech recognition failed.
      N
      FailedOperation.LivessBestFrameError
      Face detection failed. Unable to extract the photo for comparison.
      N
      FailedOperation.LivessDetectFail
      Liveness detection failed.
      N
      FailedOperation.LivessDetectFake
      Suspected spoofed recording.
      N
      FailedOperation.LivessSystemError
      Error calling the liveness engine API.
      N
      FailedOperation.LivessUnknownError
      Video-based real person detection failed.
      N
      FailedOperation.SilentDetectFail
      Real person detection failed.
      N
      FailedOperation.SilentEyeLiveFail
      Eye detection failed.
      N
      FailedOperation.SilentFaceDetectFail
      No face is detected in the video.
      N
      FailedOperation.SilentFaceQualityFail
      Low face quality.
      N
      FailedOperation.SilentFaceWithMaskFail
      A face mask is detected.
      N
      FailedOperation.SilentMouthLiveFail
      Mouth detection failed.
      N
      FailedOperation.SilentMultiFaceFail
      Multiple faces are detected in the video.
      N
      FailedOperation.SilentPictureLiveFail
      The video might be spoofed.
      N
      FailedOperation.SilentThreshold
      Real person detection did not reach the passing standard.
      N
      FailedOperation.SilentTooShort
      The video is too short. Please capture a video longer than 2 seconds.
      N
      FailedOperation.UnKnown
      Unknown internal error.
      N
      InvalidParameter
      Invalid parameter.
      N
      InvalidParameterValue
      Incorrect parameter value.
      N
      UnauthorizedOperation
      Unauthorized operation.
      N
      UnauthorizedOperation.Arrears
      The account has overdue payments
      N
      UnauthorizedOperation.NonAuthorize
      Identity verification has not been completed for the account.
      N
      UnauthorizedOperation.Nonactivated
      The service has not been activated.
      N
      UnsupportedOperation
      Unsupported operation.
      N

      Identity Verification (App SDK) Error Codes

      Error Code
      Description
      Billed
      0
      Success
      Y
      1001
      Failed to call the liveness engine
      Y
      1004
      Face detection failed
      Y
      2004
      The image passed in is too large or too small
      Y
      2012
      Failed to detect a full face
      Y
      2013
      No faces are detected
      Y
      2014
      The resolution of the image passed in is too low. Please upload a new one
      Y
      2015
      Comparison failed
      Y
      2016
      The comparison similarity did not reach the passing standard
      Y
      
      Contact Us

      Contact our sales team or business advisors to help your business.

      Contact Us
      Technical Support

      Open a ticket if you're looking for further assistance. Our Ticket is 7x24 avaliable.

      Submit a Ticket
      7x24 Phone Support
      Copyright © 2013-2024 Tencent Cloud. All Rights Reserved.
      Privacy PolicyLegalCookie Policy