The ZOLOZ Connect checkresult API is used to request a result about the face verification process results. This API is idempotent.
Required. A unique business ID for tracing purpose. For example，the sequence ID from the merchant's business-related database.
Note: The ZOLOZ server does not perform uniqueness check on the value of this field. For better tracking, it is strongly recommended to enable the merchant server to guarantee the uniqueness of the business ID.
Required. The unique transaction ID that is returned in the response of the initialize API.
#Result process logic
For different request results, different actions are to be performed. See the following for details:
- If the value of the result.resultCode is
NOT_SAME_PERSON, the ZOLOZ Connect checkresult API is invoked successfully, and results about face verification are returned.
- Otherwise, the invocation of the ZOLOZ Connect checkresult API fails. Check the error code and message for more information about the possible reasons.
#Common error codes
For the full list of common error codes, see the Common error codes section in the Error handling topic.
#API-specific error codes
The following table shows the possible error codes that are specific for the Connect checkresult API.
The API call is successful.
Input parameters are invalid. For more information about which parameter is invalid, check the result message or the related log.
Other internal errors. For more information about the error details, check the result message or the related log.
The face verification fails because similarity score is lower than threshold or spoofing behavior/high risk behavior is detected.
Enrolled image is not available or invalid.
The face verification is still in processing.
The following sample shows what a request that the merchant server sends looks like.
The following sample shows what a response that the ZOLOZ server returns looks like.
The following table shows the fields that can be specified in the ExtFaceInfo data model.
The face selfie image, which is encoded in base64. This field is specified only when the face verification process runs successfully.
The face enrolled image, which is encoded in base64. This field is specified only when the face verification process runs successfully.
Specifies the score that indicates a result of comparing the live face (selfie) against the enrolled face. Required if the face verification process runs successfully. The value of this field is in the range of 0-100.
Specifies whether the face selfie image is detected as a fake face attack by using the face liveness check algorithm. If the image is not a fake face attack, the value of