银行卡三要素认证--详版

服务说明

[!NOTE]
君子签提供个人银行卡三要素校验(详版),该接口主要通过身份证号,姓名及银行卡号进行校验,如果验证不一致,则返回具体验证不通过原因。请注意:每张银行卡每日调用最多5次;不同银行卡同一身份证号最多10次,超了就会报错,超限。该接口涉及到身份认证费用,如果未购买需要联系商务进行购买。

http请求方式

[!NOTE]
POST application/x-www-form-urlencoded

http请求地址

[!NOTE]
$SERVICE_URL/v2/auth/bankThreeVerifyDetail #其中$SERVICE_URL为生产或测试的地址

http请求参数

除公共必填参数外,还需要传以下参数

参数 类型 是否必填 默认值 说明
name string * 姓名
identityCard string * 证件号
cardNo string * 银行卡号

代码实现

JAVA实现
        RequestUtils requestUtils=RequestUtils.init(SERVICE_URL,APP_KEY,APP_SECRET);//建议生成为spring bean
        //构建请求参数
        Map<String,Object> params=new HashMap<>();
        params.put("name","易XX");
        params.put("identityCard","500240XXXXXXXXXXXXXXX");
        params.put("cardNo","62122631XXXXXXXXXX");

        ResultInfo<Void> ri= requestUtils.doPost("/v2/auth/bankThreeVerifyDetail",params);

http返回参数

[!NOTE]
返回response为application/json的数据,其字段说明如下

参数 类型 是否必返回 说明
success bool * 成功true;异常false
msg string ? 异常时,返回异常原因
resultCode string ? 异常时返回
data object ? 返回业务内容

data参数说明

参数 类型 是否必返回 说明
orderNo string ? 订单号
bankName string ? 银行
verifyStatus string * 验证结果
excuteStatus string * 执行结果
resultMessage string ? 验证失败原因
code string * 状态码

code参数说明

code msg
10415 银行卡号有误,请检查卡号或换卡重试
10416 姓名或身份证号有误
0 验证成功

[!NOTE]
返回结果,参考:

//正确响应:
{"data":{"bankName":"农业银行·金穗通宝卡(银联卡)","code":"0","excuteStatus":"EXECUTE_SUCCESS","orderNo":"tc4723101554","verifyStatus":"VERIFY_CARD_SUCCESS"},"success":true}
//错误响应:
{"msg":"银行卡账户名称不能为空","resultCode":"HTTP_PARAM_ERROR","success":false}

results matching ""

    No results matching ""