全部
在线测试

银行卡二三四要素认证


接口地址: http://api.vv-tool.com/tool/accounts/bankcardFourAuthentication


接口介绍: 银行卡二三四要素认证
二元素验证支持:(卡号 + 姓名)
三元素验证支持:(卡号 + 姓名 + 身份证号)
四元素验证支持:(卡号 + 姓名 + 身份证号 + 预留手机号)


请求方式: POST


返回格式: JSON


接口收费: 联系客服


频率限制: 10 次/秒


请求头参数

参数 类型 必选 示例
Authorization string 授权 access_token Bearer 1798c6aadec33d1bc2f5b707f1049aefexxxx

请使用新的生成 token 接口 点击查看详情

请求参数

参数 类型 必选 描述
name string 持卡人姓名
accountNo string 银行卡卡号
idCardCode string 身份证号码
bankPreMobile string 银行预留手机号码

请求示例

"name":"aa",
"accountNo":"5295296565256",

请求代码示例

cURL请求代码示例
curl --location --request POST 'http://api.vv-tool.com/tool/accounts/bankcardFourAuthentication' --header 'Authorization: Bearer 8a9ba3df21981e6af84834fbc73b8953bd76b93d' --header 'Content-Type: application/json' --data-raw '{
    "name":"张三",
    "accountNo":"62154852484891",
    "idCardCode":"44444444444444444"
}'
PHP请求代码示例
<?php

$curl = curl_init();

curl_setopt_array($curl, array(
  CURLOPT_URL => 'http://api.vv-tool.com/tool/accounts/bankcardFourAuthentication',
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => '',
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 0,
  CURLOPT_FOLLOWLOCATION => true,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => 'POST',
  CURLOPT_POSTFIELDS =>'{
    "name":"张三",
    "accountNo":"621484512184881",
    "idCardCode":"41222222222222229"
}',
  CURLOPT_HTTPHEADER => array(
    'Authorization: Bearer 8a9ba3df21981e6af84834fbc73b8953bd76b93d',
    'Content-Type: application/json'
  ),
));

$response = curl_exec($curl);

curl_close($curl);
echo $response;

JAVA请求代码示例

OkHttpClient client = new OkHttpClient().newBuilder()
  .build();
MediaType mediaType = MediaType.parse("application/json");
RequestBody body = RequestBody.create(mediaType, "{\r\n    \"name\":\"张三\",\r\n    \"accountNo\":\"215454548454545\",\r\n    \"idCardCode\":\"412245454648539\"\r\n}");
Request request = new Request.Builder()
  .url("http://api.vv-tool.com/tool/accounts/bankcardFourAuthentication")
  .method("POST", body)
  .addHeader("Authorization", "Bearer 8a9ba3df21981e6af84834fbc73b8953bd76b93d")
  .addHeader("Content-Type", "application/json")
  .build();
Response response = client.newCall(request).execute();

响应参数

名称 类型 描述
code int 返回状态码
msg string 返回码描述
msec int 接口执行时间
time int 接口返回时间
data object 数据信息
--name string 用户传递上来的参数脱敏原封返回
--accountNo string 用户传递上来的参数脱敏原封返回
--idCardCore string 用户传递上来的参数脱敏原封返回
--idCardCore string 用户传递上来的参数脱敏原封返回
--bankPreMobile string 用户传递上来的参数脱敏原封返回
--result string T 表示有效的,F 表示无效的,N 表示无法认证的,P 表示网络连接超时
--withholding_money int 该接口扣费金额(点券)

返回数据

{
  "code": 0,
  "mag": "",
  "msec": "",
  "time": 1656564848,
  "data": {
        "accountNo": "62284*******",
        "name": "张*",
        "idCardCore": "13032*******",
        "bankPreMobile": "18600******",
        "result": "T",
        "message": "认证信息匹配",
        "withholding_money": "认证信息匹配"
    }
}

响应代码

代码 代码描述 解决方案
0 成功
100 请求参数错误 检查您的请求参数是否正确
101 请求超时,请重试 检查您的网络情况或者联系客服解决
200 系统错误,请联系客服 检查您的接口地址填写是否正确,其他问题联系客服解决
203 暂不支持当前接口
204 请求异常:无该接口权限,请前往官网开通正式接口。 前往官网开通该接口权限