To further optimize the prompt messages for eKYC verification failures and enhance the overall user experience, Tencent Cloud will optimize and adjust the error codes for eKYC on March 10, 2026. Details are as follows:
| Directory | Interface Name | Involves adjusting parameters |
|---|---|---|
| eKYC (Mobile HTML5) APIs | GetWebVerificationResultIntl | ErrorCode |
| Selfie Verification (App SDK) APIs | GetFaceIdResultIntl | ErrorCode |
| eKYC (App SDK) APIs | GetSdkVerificationResult | CompareResults（ErrorCode） |
Adjustment strategy：
1. eKYC (Mobile HTML5)
● Add error codes 1409, 1410 as non-billable.
● Update error code 2012 to "Multiple faces detected".
2. Selfie Verification (App SDK)
● Add error codes 1002, 1005, 1201, 2017 as billable.
● Update error code 1001 to "Failed to call the liveness engine".
● Update error code 2012 to "Multiple faces detected".
3. eKYC (App SDK)
● Add error codes 1002, 1005, 1201, 2017 as billable.
● Update error code 2012 to "Multiple faces detected".
eKYC (Mobile HTML5) Error Codes
| Error Code | Revision | Description | Billed |
|---|---|---|---|
| 1409 | Add non-billable error codes | Verification process timed out | N |
| 1410 | Add non-billable error codes | User exited voluntarily | N |
| 2012 | Update the description | Multiple faces detected | N |
Selfie Verification (App SDK) Error Codes
| Error Code | Revision | Description | Billed |
|---|---|---|---|
| 1001 | Update the description | Failed to call the liveness engine | N |
| 1002 | Add billable error codes | Suspected spoofed recording | Y |
| 1005 | Add billable error codes | Liveness detection failed | Y |
| 1201 | Add billable error codes | Lighting is too dark or overexposed | Y |
| 2012 | Update the description | Multiple faces detected | N |
| 2017 | Add billable error codes | Facial occlusion detected | Y |
| Error Code | Revision | Description | Billed |
|---|---|---|---|
| 1002 | Add billable error codes | Suspected spoofed recording | Y |
| 1005 | Add billable error codes | Liveness detection failed | Y |
| 1201 | Add billable error codes | Lighting is too dark or overexposed | Y |
| 2012 | Update the description | Multiple faces detected | N |
| 2017 | Add billable error codes | Facial occlusion detected | Y |
For details on interface parameter changes, please refer to the interface documentation: Error Codes. If you are using this service, please pay attention to this change and make corresponding adjustments according to your business situation. If you are not using this interface, you can ignore the message.If you have any questions, please submit a ticket for consultation.
