银行卡二三四要素实名核验接口

更新时间：2023-04-28

1.功能说明

1.1.可根据「银行卡号」、「姓名」、「身份证号」、「预留手机号」等信息随机组合进行验证信息一致性，辨别用户信息的真实性，降低运营风险。如：风控审核、个人信用审核、小额贷款审核等；
1.2.广泛应用于互联网金融、贷款、担保、支付、P2P、旅游、租赁、保险、人力资源、网约车等各类政府、企业、第三方的风控审核和身份核验环节；
1.3.接口发送调用地址：http(s)://api.guoyangyun.com/api/verify/bankcard.htm
1.4.请求方式：以HTTP POST请求的方式（推荐使用post方式）；
1.5.汉字字符集：UTF-8，请注意参数的大小写。

2.输入参数

参数	名称	类型	必须	描述
公共参数	公共参数	—	是	详见《公共参数和配置》文档
bankCardNo	银行卡号码	String	是	银行卡号码
idCardNo	身份证号码	String	否	身份证号码
mobile	手机号码	String	否	手机号码
name	姓名	String	是	中文请使用 utf-8编码，防止乱码导致验证不通过

支持三种组合验证方式，可根据需要传参：

1）[银行卡号码+姓名]二要素核验
2）[银行卡号码+姓名+身份证号码]三要实名核验
3）[银行卡号码+姓名+身份证号码+手机号码]四要素实名核验

3.调用示例

http(s)://api.guoyangyun.com/api/verify/bankcard.htm?appkey=xxxxxx&appsecret=xxxxxx&idCardNo=xxxxxx&name=xxxxx&mobile=xxxxxx&bankCardNo=xxxxxxx

4.Json返回

4.1.返回参数

参数	名称	类型	描述
code	返回码	String	提交返回结果。0：表示成功，其他：失败。（状态码详见：《公共错误代码定义》）
msg	信息描述	String	返回码对应的中文描述。
data	核验结果	List	核验结果返回详情
responseCode	校验结果	String	0：验证通过；其他：验证不通过
responseDesc	结果描述	String	核验结果描述
traceNo	流水号	String	商户流水号

4.2.调用成功样例

{
    "code":"0",
    "msg":"成功",
    "data": {
            "responseCode": "0",        //0：验证通过；其他：验证不通过
            "responseDesc": "验证通过",  //核验结果描述
            "traceNo": "3b71a1773a7f"   //商户流水号
            }
}

4.3.调用失败样例

{
    "code":"XXXX",
    "msg":"错误提示内容"
}

results matching ""

No results matching ""