/data/verify_id_name_bankcard_phone_validdate_cvv2

1.接口描述

该API的功能是验证信用卡六要素(身份证号、姓名、银行卡号,银行预留手机号,有效期,cvv2)是否一致

请求方式

POST

请求 URL

https://cloudapi.linkface.cn/data/verify_id_name_bankcard_phone_validdate_cvv2

2.请求参数

字段 类型 必需 描述 备注
api_id string API 账户
api_secret string API 密钥
name string 姓名
id_number string 身份证号
card_number string 银行卡号
phone_number string 手机号
valid_date string 有效期 格式:mmyy;如:0919
cvv2 string 安全码 三位数字

所有中文和特殊字符必需以UTF-8编码转义。

3.返回参数

正常响应

字段 类型 说明
request_id string 本次请求的id
status string 状态,正常为 OK,其他值表示失败,详见错误码
result int 验证结果,详情见收费详情

收费详情

result 说明 是否收费
1 信息正确
2 信息不正确
4 卡状态不正确或卡号错误
5 证件号码或类型有误
32 卡号无效
39 发卡行不支持此交易,请联系发卡行
40 受限制的卡,建议换卡操作

输入样例:

{
  "request_id": "TID2af751b4bff24be781d60af10bf84102",
  "status": "OK",
  "result": 1
}

4.错误码

错误响应

状态码 status 字段 说明
400 ENCODING_ERROR 参数非UTF-8编码
400 INVALID_ARGUMENT 请求参数错误,具体原因见 reason 字段内容
401 UNAUTHORIZED 账号或密钥错误
401 KEY_EXPIRED 账号过期
403 RATE_LIMIT_EXCEEDED 调用频率过高
403 NO_PERMISSION 无调用权限
403 OUT_OF_QUOTA 调用次数超出限额
404 NOT_FOUND 请求路径错误
500 DATA_SERVER_ERROR 数据服务异常
500 INTERNAL_ERROR 内部服务异常

INVALID_ARGUMENT reason 字段详细描述

reason 字段 字段解释 错误说明
argument 'name': not found 未输入姓名
argument 'id_number': not found 未输入身份证号
argument 'card_number': not found 未输入银行卡号
argument 'phone_number': not found 未输入手机号
argument 'valid_date': not found 未输入有效期
argument 'cvv2': not found 未输入安全码
argument 'name': blank string 姓名为空
argument 'id_number': blank string 身份证号为空
argument 'card_number': blank string 银行卡号为空
argument 'phone_number': blank string 手机号为空
argument 'valid_date': blank string 有效期为空
argument 'cvv2': blank string 安全码为空
Input parameter error 姓名输入错误 可能包含数字、字母、空格或标点符号等特殊字符
Invalid id_number 身份证号错误 可能包含特殊字符或身份证号不符合编码规则
Invalid card_number 银行卡号错误 可能包含字母、空格或标点符号等特殊字符
Invalid phone_number 手机号错误 不满11位,或可能包含字母、空格或标点符号等特殊字符
Invalid valid_date 有效期错误 可能包含字母、空格或标点符号等特殊字符
Invalid cvv2 安全码错误 可能包含字母、空格或标点符号等特殊字符

输出样例:

{
  "status": "INVALID_ARGUMENT",
  "reason": "argument 'name': not found",
  "request_id": "TID2af751b4bff24be781d60af10bf84102"
}
{
  "status": "INVALID_ARGUMENT",
  "reason": "Invalid id_number",
  "request_id": "TIDe43421b4631844049c8780d24a86585b"
}

5.输入示例

  • cURL 样例
curl -X POST "https://cloudapi.linkface.cn/data/verify_id_name_bankcard_phone?api_id=ID&api_secret=SECRET" \
  -F name="孙悟空" -F id_number=1010000000000001 -F card_number=6225110011001100 -F phone_number=13811888888 -F valdiDate_number=0910 -F cvv2_number=345

6.支持银行

绝大部分的银行贷记卡均支持查询验证。

results matching ""

    No results matching ""