/data/verify_bank_accounttype

1.接口描述

该API的功能是验证银行卡四要素(身份证号、姓名、银行卡号,银行预留手机号)一致后,判断是否为一类户

请求方式

POST

请求 URL

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

2.请求参数

字段 类型 必需 描述
api_id string API 账户
api_secret string API 密钥
name string 姓名
id_number string 身份证号
card_number string 银行卡号
phone_number string 手机号

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

3.返回参数

正常响应

字段 类型 说明
request_id string 本次请求的id
status string 状态,正常为 OK,其他值表示失败,详见错误码
result int 验证结果,详情见收费详情
bank_account_type int 1 Ⅰ类户;4 非Ⅰ类户;5 无法判断

收费详情

result 说明 是否收费
1 信息一致,匹配成功
2 不匹配
30 未开通无卡支付
31 此卡被没收
32 无效卡号
33 此卡无对应发卡行
34 此卡未初始化或睡眠卡
35 作弊卡、吞卡
36 此卡已挂失
37 此卡已过期
38 密码错误次数超限
39 发卡行不支持此交易,请联系发卡行
40 受限制的卡,建议换卡操作

输入样例:

{
  "request_id": "TID2af751b4bff24be781d60af10bf84103",
  "status": "OK",
  "result": 1,
  "bank_account_type":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 'name': blank string 姓名为空
argument 'id_number': blank string 身份证号为空
argument 'card_number': blank string 银行卡号为空
argument 'phone_number': blank string 手机号为空
Input parameter error 姓名输入错误 可能包含数字、字母、空格或标点符号等特殊字符
Invalid id_number 身份证号错误 可能包含特殊字符或身份证号不符合编码规则
Invalid card_number 银行卡号错误 可能包含字母、空格或标点符号等特殊字符
Invalid phone_number 手机号错误 不满11位,或可能包含字母、空格或标点符号等特殊字符

输出样例:

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

5.输入示例

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

6.支持银行

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

results matching ""

    No results matching ""