Product Documentation

Transaction Statuses

Suggest Edits

Overview

This section of the documentation explains the many statuses that a transaction may have, along with their definitions and interpretation guidelines. From the moment a transaction is initiated until it is completed, each status represents a particular step or result.

StatusValueDescription
Pending0Status is the expected outcome while waiting for the user to complete the requested action.
Accepted1
  • Verified transaction (biometric authentication) in Accepted state means that the user has authenticated successfully. This is an indicator that the user can proceed with the action you invoked authentication for.
  • Get Biometry (selfie request) in Accepted status indicates the selfie was obtained with all requested quality and liveness checks completed, and TempId contains data.
  • Get ID Document (Proof request) in Accepted state means that data is available in TempId. Developers must inspect the available data for details to determine if the transactions are legitimate or fraudulent. See Process the Proof Results for more information.
    Rejected2
    • Verified transaction goes into the Rejected state if the user declines the verification or cannot authenticate successfully after several attempts
    • It is possible for Get Biometry and Get ID Document to enter the Rejected state; however, it is more common for the user to ignore the request.
      Expired3This means the user ignored or chose not to complete the requested action. The transaction lifetime can be set in the API call.
      Error4If something went wrong, the response body would have an explanation if this status is returned.
      Canceled5Indicates that the sessions were canceled.

      🚧

      Rejected Message

      For rejected messages, you would usually find a message similar to this:

      • Not authorized. Biometry verification failed.
      • Not authorized. Liveness detection failed.
      • Not authorized. Biometry verification and liveness detection failed.

      Updated 6 days ago