Liveness

The Liveness capability provides automated checks that ensure the end user is physically present during the verification and is not attempting a spoofing attack.

Dependencies

• Usability

  The Selfie that is acquired for the workflow must be PASSED by the Usability capability.

Supported Credentials:

• Facemap

  A Facemap is optional, but significantly improves the reliability of the Liveness checks. The Facemap can only be acquired by using the Web Client or one of the Jumio SDKs.

• Selfie

Response

Response data is available for transactions that include the Liveness capability. For information on transaction data see Viewing or Retrieving Workflow Transactions.

Response Structure

    "liveness": [
      {
        "id": "a070b186-d678-4de8-9a5f-5a15a35e99a4",
        "credentials": [
          {
            "id": "fe84b047-c9fb-490b-8358-009ee4e695a5",
            "category": "SELFIE"
          },
          {
            "id": "398cf6bf-524d-4fd5-b2a8-586e3df89502",
            "category": "FACEMAP"
          }
        ],
        "decision": {
          "type": "PASSED",
          "details": {
            "label": "OK"
          }
        },
        "data": {
          "type": "JUMIO_STANDARD",
          "predictedAge": 49,
          "ageConfidenceRange": "37-61"
        }
      }
    ],

Decision Details Labels

Decision Type	Label	Description
NOT_EXECUTED	PRECONDITION_NOT_FULFILLED	Required data from another capability is not available.
NOT_EXECUTED	TECHNICAL_ERROR	An error prevented execution.
PASSED	OK	Analysis determined that the end user was physically present during the verification process.
REJECTED	LIVENESS_UNDETERMINED	Liveness cannot be determined.
REJECTED	ID_USED_AS_SELFIE	An ID photo was used for the selfie.
REJECTED	MULTIPLE_PEOPLE	More than one person appears in the selfie.
REJECTED	DIGITAL_COPY	The selfie was captured from a screen.
REJECTED	PHOTOCOPY	The selfie was captured from a paper printout.
REJECTED	MANIPULATED	The selfie was manipulated prior to uploading (for example, a background swap).
REJECTED	NO_FACE_PRESENT	A face does not appear in the selfie.
REJECTED	FACE_NOT_FULLY_VISIBLE	The face is only partially visible in the selfie.
REJECTED	BLACK_WHITE	The selfie image is black and white.
WARNING	AGE_DIFFERENCE	There is a large difference between the estimated selfie age and the date of birth on the ID.
WARNING	BAD_QUALITY	The selfie is of bad quality.

Data

Key	Type	Description
type	string	The service that is used. Possible values: IPROOV_STANDARD* JUMIO_STANDARD IPROOV_PREMIUM* (requires additional configuration for your tenant)
predictedAge	integer	Estimated age of the end user based on the selfie.
ageConfidenceRange	string	Age range into which the end user would fall.