Domain name for API request: faceid.intl.tencentcloudapi.com.
This API is used to verify the authenticity and consistency of the bank card number, name, and ID number of information.
A maximum of 20 requests can be initiated per second for this API.
The following request parameter list only provides API request parameters and some common parameters. For the complete common parameter list, see Common Request Parameters.
| Parameter Name | Required | Type | Description |
|---|---|---|---|
| Action | Yes | String | Common Params. The value used for this API: BankCardVerification. |
| Version | Yes | String | Common Params. The value used for this API: 2018-03-01. |
| Region | No | String | Common Params. This parameter is not required for this API. |
| IdCard | Yes | String | ID number for account opening. -The document type must match the Type parameter, for example: input the ID card number for an identity card. |
| Name | Yes | String | Name |
| BankCard | Yes | String | Bank card. |
| CertType | No | Integer | Document type. -Please confirm this document is the document type used when opening an account. Document information not used for account opening is not supported for verification. -Currently default: 0 ID card. Other document types are not currently supported. |
| Encryption | No | Encryption | Sensitive data encryption info. -Users with encryption requirements for incoming information (name, identity card number, bank card number) can use this parameter. For details, please click the left-side link. |
| Parameter Name | Type | Description |
|---|---|---|
| Result | String | Verification result code. -Result code for charges '0': 'Authentication passed'. '-1': 'Authentication failed'. '-5': 'Cardholder information is incorrect'. '-6': 'Cardless payment not enabled'. '-7': 'Card confiscated'. '-8': 'Invalid card number'. '-9': 'No corresponding issuing bank for this card'. '-10': 'The card is uninitialized or a Sleep Card'. '-11': 'Cheat card, card retention'. '-12': 'Reported lost'. '-13': 'The card has expired.' '-14': 'Restricted card'. '-15': 'Exceeded the number of password errors.' '-16': 'Issuer does not support this transaction'. '-20': 'Card status exception or card number error'. -Result code with no charge '-2': 'Name verification failed'. '-3': 'Identity number error'. '-4': 'Incorrect bank card number format'. '-17': 'Verification Center Service busy'. '-18': 'Exceeded verification attempts. Please retry the next day.' '-19': 'The ID number is not currently supported for verification. Currently only support second-generation resident identity card.' |
| Description | String | Business result description. |
| RequestId | String | The unique request ID, generated by the server, will be returned for every request (if the request fails to reach the server for other reasons, the request will not obtain a RequestId). RequestId is required for locating a problem. |
https://faceid.intl.tencentcloudapi.com/?Action=BankCardVerification
&IdCard=11204416541220243X
&Name=Wei Xiaobao
&BankCard= 6226090210146748
&<Common request parameters>
{
"Response": {
"Result": "0",
"Description": "Authentication passed",
"RequestId": "a5fdb909-5ee6-43ff-a152-bb1b9744ee8b"
}
}
https://faceid.intl.tencentcloudapi.com/?Action=BankCardVerification
&IdCard= 11204416541220243X
&Name=Wei Xiaobao
&BankCard= 6225768888888888
&<Common request parameters>
{
"Response": {
"Result": "-1",
"Description": "Authentication failed",
"RequestId": "89f695b2-18fd-44b6-bffc-96972052666f"
}
}
TencentCloud API 3.0 integrates SDKs that support various programming languages to make it easier for you to call APIs.
The following only lists the error codes related to the API business logic. For other error codes, see Common Error Codes.
| Error Code | Description |
|---|---|
| FailedOperation.DecryptSystemError | Decryption failed. |
| FailedOperation.StsUnAuthErrError | STS unauthorized. |
| FailedOperation.UnKnown | Unknown internal error. |
| InvalidParameter | Invalid parameter. |
| InvalidParameter.UnsupportEncryptField | Unencrypted fields exist. Refer to the documentation to modify. |
| InvalidParameterValue | Incorrect parameter value. |
| UnauthorizedOperation.Arrears | The account is in arrears. |
| UnauthorizedOperation.ChargeStatusException | The billing status is abnormal. |
| UnauthorizedOperation.NonAuthorize | Identity verification has not been completed for the account. |
| UnauthorizedOperation.Nonactivated | The service has not been activated. |
Was this page helpful?
You can also Contact sales or Submit a Ticket for help.
Help us improve! Rate your documentation experience in 5 mins.
Feedback