银行卡三要素验证api接口定义

在实名认证、线上支付、金融、电商等业务场景中，经常需要用到银行卡三要素核验接口，它是通过比对实时比对姓名、身份证号、银行卡号三个关键信息来进行一致性核验的API服务。

通过传入姓名、身份证号码及银行卡号，与银行预留信息进行实时校验此三项是否匹配，主要用户核验用户身份和银行卡信息的真实性、一致性。

银行卡三要素验证api目的与价值

身份真实性核验：确保用户是银行卡的合法持有人，防止冒用他人身份信息。

降低交易风险： 在支付、转账、提现等场景下，通过银行卡三要素核验接口，验证卡主身份，有效减少盗刷、欺诈等风险。

提高绑卡成功率与安全性： 在用户绑定银行卡进行支付时，通过接口进行验证，确保绑定的是用户本人的有效卡。

满足合规要求：金融、支付等行业的实名制和反洗（AML）监管要求，银行卡三要素验证是基础的手段之一。

防止垃圾注册与作弊：在需要强实名认证的场景（如社交平台、游戏平台），用于验证用户身份的真实性。

接口对接

以数脉API的银行卡三要素验证为例：

示例代码（java）

private static final String appId = "数脉分配给你的appid";

    private static final String appSecurity = "数脉分配给你的appsecurity";

    public static void main(String[] args){

String timestamp = System.currentTimeMillis() + "";

        //参数

        String name = "姓名";

String idcard = "身份证号码";

String bankcard = "卡号";

        //接口地址

        String url = "https://api.shumaidata.com/v4/bankcard3/check";

        //MD5Utils文件请联系工作人员索取

        String sign = MD5Utils.encrypt(appId+"&"+timestamp+"&"+appSecurity);

        System.out.println("sign: "+sign);

        Map<String,Object> params = new HashMap<String,Object>();

        params.put("appid",appId);

        params.put("timestamp",timestamp);

        params.put("sign",sign);

        params.put("name", name);

params.put("bankcard", bankcard);

params.put("idcard", idcard);

        //HttpUtils文件请联系工作人员索取

        String result = HttpUtils.get(url,null,params);

        System.out.println(result);

    }

对接后传入姓名、身份证号、银行卡号，验证三要素是否一致。返回示例如下:

正确返回：

{

    "msg": "成功",

    "success": true,

    "code": 200,

    "data": {

        "result": 0,

        "order_no": "567655125267648512",

        "desc": "认证信息匹配",

        "msg": "一致"

    }

}

错误返回：

{

    "msg": "参数错误",

    "success": false,

    "code": 400,

    "data": {}

}