Server-side error codes

更新时间:
复制 MD 格式

Applicable API

Code

Message

Description

General

200

success

The request succeeded.

General

400

Parameter cannot be empty

A required parameter is missing.

General

401

Invalid parameter

The input parameter does not meet the requirements.

General

402

  • Authoritative source service unavailable

  • Security policy restriction

  • No permission to call

  • The authoritative source service is unavailable.

  • The security policy configured in the console blocked the request. For more information, see Security management.

  • You do not have permission to call this API.

General

403

Excessive duplicate calls

The number of duplicate calls exceeds the limit.

  • Mobile number three-factor verification (basic)

  • Mobile number three-factor verification (advanced)

  • Two-Element Mobile Number Verification

405

Phone numbers cannot be queried.

The mobile number is not supported. The number belongs to an unsupported segment.

  • ID two-factor verification (OCR supported)

  • ID three-factor verification

  • Credential verification service

  • Face Deepfake detection

405

Invalid image format

The image format is invalid or the image size does not meet the requirements.

Face Deepfake detection

406

No face detected

No face was detected in the image.

General

410

Service not activated

The product is not activated.

General

411

No RAM permission

The Resource Access Management (RAM) user has no permission. Grant the AliyunYundunCloudAuthFullAccess permission.

General

412

Overdue payment

The product has an overdue payment. Top up your account before proceeding.

  • ID two-factor verification (OCR supported)

  • ID three-factor verification

  • Credential verification service

  • Face Deepfake detection

419

Duplicate data

  • ID two-factor verification (OCR supported): Both CertUrl and CertFileObject are provided.

  • ID three-factor verification: Both FacetUrl and FaceFileObject are provided.

  • Credential verification service: Both imageUrl and imageContext are provided.

  • Face Deepfake detection: Both faceUrl and faceBase64 are provided.

  • ID two-factor verification (OCR supported)

  • ID three-factor verification

  • Credential verification service

  • Face Deepfake detection

420

Invalid input image

The input image is invalid.

  • ID two-factor verification (OCR supported)

  • ID three-factor verification

  • Credential verification service

  • Face Deepfake detection

421

Image too large

The input image exceeds the size limit.

  • ID two-factor verification (OCR supported)

    • Server-only integration

    • DescribeCardVerify
  • ID three-factor verification

    • DescribeCardVerify

440

OCR recognition failed

OCR recognition failed.

Check the input image. Ensure the photo is clear, properly exposed, fully visible without obstruction, and captured at a reasonable angle.

General

500

System error

An internal system error occurred.

SubCodes for three-factor identity verification

Applicable API

SubCode

Message

Possible causes and recommended actions

Three-factor identity verification

101

Authentication passed

The call was successful.

201

Authentication failed. The name and ID number do not match.

The user's information may be incorrect or fraudulent. Ask the user to confirm the information and retry the operation.

202

Authentication failed. Possible match.

The person's appearance may have changed significantly, or the photo quality is poor. Provide an option for manual review or ask the user to upload a new photo.

203

Authentication failed. No photo in the database.

This may be caused by an issue with the authoritative data source. Provide an option for manual review.

204

Authentication failed. Not the same person.

The person in the photo may not be the same individual, or the photo quality is low. Handle this case as needed. If the person is the same, ask them to retry the operation.

205

Authentication failed. Failed to create a model from the image for comparison.

The quality of the portrait photo may be too low, which prevents the face detection or feature extraction algorithm from creating a model. Ask the user to take a new photo. Ensure that the photo is a front-facing view with even lighting and a clear face.

206

Authentication failed. Incorrect image format.

The uploaded image file format is not supported. Convert the image to a common format such as JPG or PNG and upload it again.

207

Authentication failed. The uploaded image is too small. Upload a new image.

The resolution or file size of the uploaded image is below the minimum system requirement. Upload a higher resolution image and ensure that the face area has sufficient pixel detail.

208

Authentication failed. The quality of the uploaded portrait photo is poor. Upload a new photo.

The overall quality is substandard. This may be due to issues such as blur, high noise, excessive compression, or facial occlusion. Upload a clear, front-facing, and unobstructed portrait photo.

301

No record found. The ID number is not in the database.

The ID number does not exist in the authoritative data source. Ask the user to confirm that the ID number is correct. If the issue persists after confirmation, it may be an issue with the coverage of the authoritative data source. Provide an option for manual review.

302

No record found. Cannot be verified.

This may be due to a timeout from the authoritative source's API, temporary unavailability of the data source, or an abnormal status of the identity information in the authoritative source. Ask the user to retry later. If the issue persists, guide the user to manual review.