ID Verification:CheckResult

Name

Type

Required

Description

Example

MerchantBizId

String

Yes

A unique business identifier that you customize. Use it to track and troubleshoot issues later. The identifier can be a combination of letters and digits up to 32 characters long. Make sure the identifier is unique.

e0c34a77f5ac40a5aa5e6ed20c35****

TransactionId

String

Yes

hksb7ba1b28130d24e015d6********

IsReturnImage

String

No

Specifies whether to return the authentication image data.

• Y: Required

• N: No (default)

Y

Name

Type

Description

Example

HTTP status code

Integer

The HTTP status code.

200

HTTP Body

RequestId

String

The request ID.

130A2C10-B9EE-4D84-88E3-5384FF03****

Code

String

Back to Code.

Success

Message

String

A detailed description of the response code.

success

Result.Passed

String

The final authentication result. Valid values:

• Y: Passed

• N: Failed

Y

Result.SubCode

String

A description of the authentication result. For more information, see ResultObject.SubCode error codes.

200

Result.ExtFaceInfo

String

Information about the face liveness verification result. For the JSON format, see the example on the right. For more information, see ExtFaceInfo.

{
  "faceAttack": "N",
  "faceImg": "/9j/4AAQSkZJRgABAQAAAQqviV6oa...",
  "faceQuality": 95.45,
  "faceOcclusion": "N",
   "docVideoUrl": "https://aliyun-cloudauth.oss-aliyuncs.com/******.webm" 
}

Name

Type

Description

Example

faceImg

String

The captured face image in the Base64 format. This parameter is returned if you set isReturnImage=Y in the request and the face scanning process is completed.

Base64-encoded image

faceAttack

String

Indicates whether a liveness attack was detected during face capture.

Valid values:

• Y: An attack was detected.

• N: No attack was detected.

N

faceQuality

Double

The quality score of the face image. The score ranges from 0 to 100.

99.99

faceOcclusion

String

Indicates whether the face is occluded. Valid values:

• Y: The face is occluded.

• N: The face is not occluded.

N

docVideoUrl

String

https://aliyun-cloudauth.oss-aliyuncs.com/******.webm

faceAge

String

The predicted age of the individual based on the face image. If the prediction fails, this parameter is not returned.

30

faceGender

String

The predicted gender of the individual based on the face image. If the prediction fails, this parameter is not returned. Valid values:

• M: Male

• F: Female

M

faceAttackScore

Double

The probability of a fake face attack predicted by the facial recognition algorithm. A higher score indicates a higher probability of a fake face.

The score ranges from 0 to 100.

80

guardRiskScore

Double

The probability of device risk predicted by the face guard algorithm. A higher score indicates a higher device risk.

The score ranges from 0 to 100.

90