银行卡三要素认证---非大陆居民

服务说明

[!NOTE]
验证银行卡卡号、姓名、证件号是否一致，支持借记卡和贷记卡。请注意：每张银行卡每日调用最多5次；不同银行卡同一身份证号最多10次，超了就会报错，超限。该接口涉及到身份认证费用，如果未购买需要联系商务进行购买。

http请求方式

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

http请求地址

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

http请求参数

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

参数	类型	是否必填	默认值	说明
name	string	*		姓名
identityCard	string	*		证件号
cardNo	string	*		银行卡号
identityType	integer	*		证件类型：2(护照)、3(台湾通行证(台胞证))、4(港澳通行证(回乡证))

代码实现

JAVA实现

        Map<String,Object> params=bodyParams;
        String url=SERVICE_URL+"/v2/auth/otherIdNo/bankThreeVerify";
        params.put("name","杨XXX");
        params.put("identityCard","04XXX7");
        params.put("cardNo","623XXXXXXXX012");
        params.put("identityType","3");

        String str= HttpClientUtils.init().getPost(url,null,params,true);
        System.out.println(str);

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	int	*	0 成功

[!NOTE]
返回结果，参考：

//正确响应：
{"data":{"bankName":"未知银行名称","code":"0","excuteStatus":"EXECUTE_SUCCESS","orderNo":"lo1y2p0ij32dzvxOO1y2ozx07yu62d","verifyStatus":"VERIFY_CARD_SUCCESS"},"success":true}
//错误响应：
{"msg":"app_secret不可用","resultCode":"HTTP_PARAM_ERROR","success":false}

results matching ""

No results matching ""