Skip to main content

Transaction Statuses

When a transaction is created, it starts in the "Pending" state.

The status check returns one of the following results:

StatusValueDescription
Pending0Status is an expected result while waiting for the user to complete the requested action.
Accepted1User has completed transaction:
  • Verified transaction (biometric authentication) in Accepted state means that user has authenticated successfully. This is your indicator you can proceed with action you invoked authentication for.
  • Get Biometry (selfie request) in Accepted status indicates the selfie was obtained with all requested quality and liveness checks successfully completed and TempId contains data.
  • Get ID Document (Proof request) in Accepted state means that data is available in TempId. Note that you must inspect the available data for details to determine if you are satisfied with the results.
Rejected2
  • Verified transaction goes into Rejected state if user declines the Verification or cannot authenticate successfully after several attempts.
  • Get Biometry and Get ID Document can technically have this state, however usually user just ignores the request.
Expired3Means the user ignored or chose not to complete the requested action. The transaction lifetime can be set in the API call.
Error4Something went wrong, the response body would have an explanation if this status is returned.
Canceled5You can invalidate the transaction via backend API call, it would lead to this status.