MobbID Cordova: Face Verification

Introduction

MobbID allows you to perform several biometric operations between the user that has been previously enrolled and the user using the app. This process performs a face recognition between the user's face and the face that was previously enrolled (1:1).

In the next section, the details of this method will be exposed.

MobbIdApi.faceVerification

This method opens the camera UI and starts the face verification process. The method has three parameters:

• successCallback: Function which will be called when the face recognition finishes successfully. It will receive an object with the following attributes:

  • result: This could be "USER_VERIFIED" or "USER_NOT_VERIFIED".
  • data: Extra data about the verification result, it contains the following attributes:
    • userId: Identifier of the user that has been verified.

• failureCallback: Function which will be called when the face recognition fails for any reason. It will receive an object with the following attributes:

  • result: This could be "ERROR".
  • data: data about the operation, it contains the following attributes:
    • userId: Identifier of the user that has been enrolled.
  • error: Error that happened in the process. It contains the following attributes:
    • code: Error code.
    • extraInfo: Error message.

• userId: Identifier of the user that has been previously enrolled.

• livenessDetectionMode: liveness detection mode. It could be "NONE", "HEAD_MOVEMENT", "HEAD_PASSIVE" or "HEAD_PASSIVE_IMAGE".

Example

MobbIdApi.faceVerification(
  function (result) {
    console.log("Face verification success: " + result.result);
    console.log("User verified: " + result.data.userId);
  },
  function (error) {
    console.log("Face verification error: " + error.code);
    console.log("Error message: " + error.extraInfo);
  },
  "user_id",
  "HEAD_PASSIVE"
);