ID Verification:CheckResult

Category

Field

Description

Shared output

Common response parameters, authentication result, and ExtFaceInfo (includes face liveness results, face comparison/1:N search results, and face registration results)

Can be returned in both integration modes. Whether these fields are returned depends on the authentication flow and the InitializeV2 configuration.

Web SDK specific

procedurePriority

If compatibility degradation occurs, this field returns the degradation strategy used.

App SDK specific

None

None

Parameter

Type

Required

Description

Example

MerchantBizId

String

Yes

A unique business ID from the merchant, consisting of 32 letters and numbers. It must be consistent with the value used in the InitializeV2 request.

e0c34a77f5ac40a5aa5e6ed20c35****

TransactionId

String

Yes

hksb7ba1b28130d24e015d6********

IsReturnImage

String

No

Specifies whether to return the face image:

• Y: Return

• N: Do not return (default)

Y

Parameter

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

The API response code. For more information, see Server-side HTTP status codes.

Success

Message

String

A description of the response code.

success

Result.Passed

String

The final authentication result:

• Y: Passed

• N: Failed

Y

Result.SubCode

String

A description of the authentication result. For more information, see Result.SubCode authentication result subcodes.

200

Result.ExtFaceInfo

String

Results related to face liveness verification. For more information, see Result.ExtFaceInfo.

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

Result.ExtInfo

String

Other authentication information, which primarily includes details on actual degradation for mobile H5 integrations. For more information, see Result.ExtInfo.

{
  "procedurePriority": "keep"
}

Parameter

Type

Description

Example

faceImg

String

The live face image in Base64 format. Returned only when IsReturnImage=Y and the face scan is successful.

Base64 format

docVideoUrl

String

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

faceAttack

String

Indicates whether a liveness attack was detected:

• Y: Yes

• N: No

N

faceAttackScore

(Deprecated)

Double

The liveness attack risk score, ranging from 0 to 100.

The risk of liveness attacks is now determined by a Large Language Model (LLM), so the concept of a risk score is no longer applicable. This field is offline.

80

guardRiskScore

Double

The device risk score, ranging from 0 to 100. A higher score indicates a higher device risk.

90

deviceToken

String

The DeviceToken for Face Guard. It is returned when the Face Guard module is fully integrated and can be used to query the Face Guard server-side API operations to get device risk details.

• Face Guard is a paid service. For more information, see Billing overview.

• This token is valid for 7 days and is not unique.

e0c34a77f5ac40a5aa5e6ed20c35****

faceAttributeInfo

String

{
        gender: 1
        glasses: 0
        hat: 1
        mask: 1
        tattoo: 0
        smoking: 0
        others: 1
        env：office
        expression：1
        age：16
}

faceComparisonScore

Double

The face comparison result is returned when VerifyModel=1/2. The comparison score ranges from 0 to 100. The default system threshold is 90. You can also customize the decision based on your business requirements.

90

duplicateFace

List

Returns the duplicate face search result when VerifyModel is 0 or 2 and a similar face is found.

The returned fields are defined as follows:

• faceGroupCode: The code of the face group that contains the similar face.

• faceId: The ID of the similar face.

• merchantUserId: The unique user ID for a similar face.

• score: The similarity score of the face.

[
  {
    "faceGroupCode": "sg7****uzt",
    "faceId": "f5a921*******9e792ec84c8f0ca592a"
    "merchantUserId":"face0005",
    "score":93.26
  }
]

faceRegistrationResult

Integer

Face registration result (returned when VerifyModel=0/2):

• 0: Registration failed due to an issue with the face image.

• 1: Registration successful.

• 2: Registration failed because the auto-registration conditions were not met.

• 3: Registration failed because the user already exists.

• 4: Registration successful, and the face image is updated successfully (This occurs when an entry meets the conditions for automatic registration, but has a duplicate MerchantUserId and UpdateFaceIfUserExists is set to Y).

1

faceRegistrationId

String

The ID of the registered face, which is returned when VerifyModel=0/2, AutoRegistration=0, and the registration is successful.

f5a9219aefd6*******c84c8f0ca592a

Parameter

Type

Description

procedurePriority

String

The actual downgrade method for mobile H5 authentication:

• keep: No downgrade

• url: Downgrade using a URL