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, ID number, and mobile number for account opening.
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: BankCard4EVerification. |
| 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. |
| Name | Yes | String | Name |
| BankCard | Yes | String | Bank card. |
| Phone | Yes | String | Mobile number. |
| 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. |
| 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 defaults to 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, mobile 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'. '-6': 'Cardholder information is incorrect'. '-7': 'Cardless payment not enabled'. '-8': 'Card confiscated'. '-9': 'Invalid card number'. '-10': 'No corresponding issuing bank for this card'. '-11': 'The card is uninitialized or a Sleep Card'. '-12': 'Cheat card, card confiscation'. '-13': 'Reported lost'. '-14': 'The card has expired.' '-15': 'Restricted card'. '-16': 'Exceeded the number of password errors'. '-17': 'Issuer does not support this transaction'. '-21': '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'. '-5': 'Invalid phone number'. '-18': 'Verification Center Service busy'. '-19': 'Exceeded maximum verification attempts. Please retry the next day.' '-20': '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=BankCard4EVerification
&Name=Wei Xiaobao
&BankCard=6225768888888888
&Phone=16137688175
&IdCard=11204416541220243X
&<Common request parameters>
{
"Response": {
"Result": "0",
"Description": "Authentication passed",
"RequestId": "74e742e8-f91d-49c3-9744-c20f3baca117"
}
}
https://faceid.intl.tencentcloudapi.com/?Action=BankCard4EVerification
&Name=Wei Xiaobao
&BankCard=6226090210146748
&Phone=16137688175
&IdCard= 11204416541220243X
&<Common request parameters>
{
"Response": {
"Result": "-6",
"Description": "Cardholder information is incorrect"
"RequestId": "24fe7851-49e9-4a4a-ac1e-3bd5c09323fd"
}
}
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. |
フィードバック