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 |
|
|
General | 403 | Excessive duplicate calls | The number of duplicate calls exceeds the limit. |
| 405 | Phone numbers cannot be queried. | The mobile number is not supported. The number belongs to an unsupported segment. |
| 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. |
| 419 | Duplicate data |
|
| 420 | Invalid input image | The input image is invalid. |
| 421 | Image too large | The input image exceeds the size limit. |
| 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. |