ID Verification:CheckResult

Name

Type

Required

Description

Example

MerchantBizId

String

Yes

A unique business ID that you define to track and troubleshoot issues. It must be a combination of letters and digits up to 32 characters long. Ensure the ID is unique.

e0c34a77f5ac40a5aa5e6ed20c35****

TransactionId

String

Yes

hksb7ba1b28130d24e015d6********

IsReturnImage

String

No

Specifies whether to return 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-5384FF039795

Code

String

Return 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",
  "faceComparisonScore": 99.99,
  "faceImg": "base64 format",
  "facePassed": "Y",
  "faceQuality": 95.45,
  "faceOcclusion": "N"
   "docVideoUrl": "https://aliyun-cloudauth.oss-aliyuncs.com/******.webm" 
}

Result.ExtIdInfo

String

Information about the certificate recognition result.

For the JSON format, see the example on the right. For more information, see ExtIdInfo.

{
  "ocrIdInfoData": {
    "01": {
      "ocrIdInfo": {
        "id_number": "083099003767",
        "full_name": "MAC PHAM HOÀNG DƯƠNG",
        "nationality": "Việt Nam",
        "date_of_expiry": "",
        "date_of_birth": "16/08/1999",
        "sex": "Nam"
      },
      "ocrIdPassed": "Y",
      "spoofInfo": {
        "spoofResult": "N"
      }
    },
    "02": {
      "ocrIdInfo": {
        "date_of_issue": "10/02/2022",
        "personal_identification": "Sẹo chấm C.2cm trên sau mèp phải"
      },
      "ocrIdPassed": "Y",
      "spoofInfo": {
        "spoofResult": "N"
      }
    }
  },
  "ocrIdPassed": "Y"
}

Result.ExtSourceInfo

String

The following describes the details of the data source verification results. The Indonesian data source is used as an example.

• govId, fullName, dob: A comparison score of 1.0 indicates a complete match with the official data source information. A score below 1.0 indicates a mismatch. 

• selfiePhoto: A comparison score greater than 0.8 indicates a match with the official data source information. A score of 0.8 or lower indicates a mismatch. 

• liveness: A score higher than 0.95 indicates a liveness detection risk. 

• imgManipulationScore: A score higher than 0.95 indicates an image tampering risk.

{
  "govId": 1.0,
  "fullName": 1.0,
  "dob": 0.9,
  "selfiePhoto": 0.8777,
  "liveness": 0.1152,
  "imgManipulationScore": 0.2253
}