LogoLogo
Useful links
  • Home
  • Product guides
  • API
  • SDKs
  • Overview
  • First steps
  • ANDROID
    • Getting Started with the SDK
    • Standalone Modules
      • Document Detector
        • Release Notes
        • Current Version
        • Requirements
        • Gradle Dependencies
        • Gradle Source Code
        • Setting up the SDK
          • Setting properties
          • Capture Stages
          • Messages Settings
          • Customization
          • Security Settings
          • Detection Steps
          • Upload Mode
          • Advanced Settings
            • Proxy configuration
            • Preview configuration
        • Start Document Detection
        • Source Code
        • Google security form
        • Reduce SDKs size
        • SDKs response
        • References
        • FAQ
      • Face Liveness
        • Release Notes
        • Current Version
        • Requirements
        • Gradle Dependencies
        • Gradle Source Code
        • SDK Lifecycle
        • Building the SDK
        • Start Liveness Verification
        • Source Code
        • References
        • Advanced Features
        • FAQ
      • Face Authenticator
        • Release Notes
      • Smart Auth
        • Release Notes
        • Current Version
        • Requirements
        • Gradle Dependencies
        • Gradle Source Code
        • Permissions
        • SDK Lifecycle
        • Building the SDK
        • Start Smart Authentication
        • Source Code
        • References
        • FAQ
      • Face Liveness (deprecated)
        • Release Notes
  • iOS
    • Getting Started with the SDK
    • Standalone Modules
      • Document Detector
        • Release Notes
        • Current Version
        • Requirements
        • Installing the SDK
        • Setting up the SDK
          • Setting properties
          • Messages Settings
          • Customization
          • Detection Steps
          • Upload Mode
          • Advanced Settings
            • Proxy configuration
            • Preview configuration
        • Start Document Detection
        • References
        • FAQ
      • Face Liveness
        • Release Notes
        • Installation
        • Current Version
        • Requirements
        • SDK Lifecycle
        • Building the SDK
        • Start Liveness Verification
        • Source Code
        • References
        • FAQ
      • Face Authenticator
        • Release Notes
        • Installation
        • Current Version
        • Requirements
        • Building the SDK
        • Start the SDK
        • References
        • FAQ
      • Smart Auth
        • Release Notes
        • Installation
        • Current Version
        • Requirements
        • SDK Lifecycle
        • Building the SDK
        • Start Smart Authentication
        • Source Code
        • References
        • FAQ
      • Face Liveness (deprecated)
        • Release Notes
  • REACT NATIVE
    • Standalone Modules
      • Document Detector
        • Release Notes
        • Current Version
        • Requirements
        • Installation
        • Hooks
        • Start Document Verification
        • Source Code
        • TypeScript References
        • Customizing Style
        • FAQ
      • Face Liveness
        • Release Notes
        • Current Version
        • Requirements
        • Installation
        • Hooks
        • Start Liveness Verification
        • Source Code
        • TypeScript References
        • FAQ
      • Face Authenticator
        • Release Notes
        • Current Version
        • Requirements
        • Installation
        • Hooks
        • Start Authentication Verification
        • Source Code
        • TypeScript References
        • FAQ
      • Smart Auth
        • Getting started
        • Release notes
        • Using Native Modules
          • Requirements
          • Gradle Source Code
          • Podfile Source Code
          • Native Module Android
          • Native Module iOS
          • Import Native Modules
          • Source Code
          • TypeScript References
          • FAQ
        • Using Expo Modules
          • Requirements
          • Create Local Expo Module
          • Gradle Source Code
          • Podspec Source Code
          • Native Module Android
          • Native Module iOS
          • Import Expo Modules
          • Source Code
          • TypeScript References
          • FAQ
  • WEB (JAVASCRIPT)
    • Standalone Modules
      • Document Detector
        • Getting started
        • SDK builder options
          • Analytics
          • Appearance
          • Messages
        • SDK methods
        • Event listeners
        • Customization
        • Release notes
      • Face Liveness
        • Customization
        • Release notes
      • Face Authenticator
        • Customization
        • Release notes
      • Smart Auth
        • SDK errors
        • Customization
        • Release notes
LogoLogo

2025 © Caf. - All rights reserved

On this page
  • Format
  • Types of errors
  • UnsupportedError
  • PermissionDeniedError
  • AlreadyRunningError
  • UserCanceledError
  • NetworkError
  • InvalidResponseError
  • InternalServerError
  • TimeoutError
  • PositionUnavailableError
  • UnknownError
  • ContextPending
  • FaceAuthentication
  1. WEB (JAVASCRIPT)
  2. Standalone Modules
  3. Smart Auth

SDK errors

Format

All errors triggered by the SDK have the following properties:

Field

Type

Description

id

string

Error identifier

message

string

Additional Message

Tip: You can use the call isSdkError(error) to check if an error is in this format:

const identity = new Sdk(identityToken, options);

try {
    const response = await identityentity.verifyPolicy(cpfInput.value, policyInput.value);
}
catch (error) {
    if(identity.isSdkError(error)) {
        // The error is in the format above
    }
}

Types of errors

UnsupportedError

ID: UNSUPPORTED

Description: Triggered when the user's browser does not support some feature necessary for the SDK to work

PermissionDeniedError

ID: PERMISSION_DENIED

Description: Triggered when the SDK has not been given permission to perform an action (such as opening the camera)

AlreadyRunningError

ID: ALREADY_RUNNING

Description: Triggered when the throwOnRecall flag is set in the SDK options and a verification call is made while another one is already in progress.

UserCanceledError

ID: USER_CANCELED

Description: Triggered when the user cancels an SDK operation

NetworkError

ID: NETWORK_ERROR

Description: Triggered when a request to our servers fails

InvalidResponseError

ID: INVALID_RESPONSE

Description: Triggered when a request to our servers did not get the expected result

InternalServerError

ID: INTERNAL_SERVER_ERROR

Description: Triggered when there was an internal error in our servers

TimeoutError

ID: TIMEOUT

Description: Triggered when some request from the SDK (not necessarily from the network) has exceeded the time limit

PositionUnavailableError

ID: POSITION_UNAVAILABLE

Description: Triggered if there is an error while capturing the user's geolocation, other than a timeout or user permission specifically for the website.

This usually occurs when the browser does not have permission from the operating system to use location services. Example: if the user is accessing the website through an Instagram webview, and does not allow the Instagram app to use location services in the iOS or Android settings.

UnknownError

ID: UNKNOWN

Description: Triggered when an unknown error occurred

ContextPending

ID: CONTEXT_PENDING

Description: Triggered when the context is pending manual analysis.

FaceAuthentication

ID: FACE_AUTHENTICATION

Description: Triggered when an error occurs in the face authentication flow.

The SDK does not return explicit exceptions about refusal reasons for authentication. Refusal reasons can be obtained from the API response that looks for a specific authentication attempt.

Last updated 1 month ago