GETbankcard-check-2
银行卡二要素
实时校验银行卡号与持卡人姓名是否匹配,返回一致结果,助力金融风控与身份认证。
接入文档
接口简介
本接口提供银行卡二要素(姓名、银行卡号)一致性核验服务。通过传入用户姓名和银行卡号,系统实时比对银行预留信息,返回两者是否匹配的验证结果,帮助开发者快速确认用户身份信息的真实性。
适用场景
- 金融开户审核:在用户绑定银行卡或开通支付功能时,验证持卡人身份。
- 电商提现风控:确保提现账户归属权,防止资金盗用风险。
- 企业薪酬发放:校验员工提交的工资卡信息准确性,减少打款失败率。
- 信贷申请初审:作为基础身份核验环节,辅助评估申请人资料可信度。
请求与返回说明
- 请求方式:GET
- 核心参数:
name:持卡人真实姓名(字符串)bankcard:待验证的银行卡号(字符串)- 返回结果:
code:状态码,SUCCESS 表示请求成功。data.result:核验结论,值为“一致”时表示姓名与卡号匹配。data.desc:结果描述,如“姓名与银行卡号一致”。
接入建议
- 隐私合规:姓名与银行卡号属于敏感个人信息,传输过程请务必使用 HTTPS 加密,并遵循相关法律法规进行数据脱敏存储。
- 异常处理:建议对
code非 SUCCESS 的情况做兼容处理,避免因网络波动或上游服务临时异常导致业务中断。 - 输入校验:在前端或业务层预先校验银行卡号格式(如长度、纯数字),减少无效请求调用,优化成本与性能。
接入示例代码
提供 Shell、Python、Go、Java、PHP 等常见接入示例,便于直接接到现有项目里。
请求示例
{
"name": "张三",
"bankcard": "6228480402564890018"
}响应示例
{
"code": "SUCCESS",
"message": "success",
"data": {
"result": "一致",
"desc": "姓名与银行卡号一致"
}
}请求字段
以下字段根据示例 JSON 自动提取,仅作接入参考。
| 字段路径 | 类型 | 示例值 |
|---|---|---|
| name | string | 张三 |
| bankcard | string | 6228480402564890018 |
响应字段
以下字段根据示例 JSON 自动提取,仅作接入参考。
| 字段路径 | 类型 | 示例值 |
|---|---|---|
| code | string | SUCCESS |
| message | string | success |
| data | object | {...} |
| data.result | string | 一致 |
| data.desc | string | 姓名与银行卡号一致 |