Skip to main content

Error Codes

Below are the possible error codes, their causes, and potential implications:

START_FAIL_CODE​

The START_FAIL_CODE error occurs when the camera fails to open due to one of the following reasons:

  • No camera is available (e.g., a desktop device without a webcam).
  • None of the available cameras meet the required resolution for a successful capture experience.
  • The user denied camera permissions.

If this error occurs once, it is likely to persist in subsequent attempts during the same session—unless the user grants the previously denied permissions or installs a webcam.

RUNTIME_ERROR_CODE​

The RUNTIME_ERROR_CODE is typically accompanied by a plain text message describing the fault. If this error occurs repeatedly, it may be due to:

  • Other tasks that interfere with the camera functionality.
  • Configuration anomalies, such as conflicts with third*party browsers or security settings.

SEQUENCE_BREAK_CODE​

The SEQUENCE_BREAK_CODE is a rare operating system error that has been observed on devices running iOS 15. It indicates that the camera stream initially opened and captured some frames but then encountered one of the following issues:

  • The video feed froze, continuously displaying the same frame.
  • The camera closed unexpectedly and stopped providing frames.

This issue is specific to iOS 15 and is caused by an underlying OS bug that cannot be mitigated further.

AUTO_CAPTURE_TIMEOUT_CODE​

The AUTO_CAPTURE_TIMEOUT_CODE error occurs when the document auto-capture feature exceeds the configured timeout duration without successfully capturing a document. This can happen when:

  • The document quality remains insufficient for capture
  • The user is unable to position the document correctly
  • Environmental conditions (lighting, glare) prevent successful capture

When this error occurs, the SDK will stop auto-capture detection. Users can:

  • Enable manual capture mode using the toggle switch
  • Restart the camera to reset the timeout
  • Adjust the autoCaptureTimeout property for a longer duration