银行卡二三四要素核验 API|接口返回参数与状态码详解

简介: 线上支付、资金结算场景中,企业需要用户绑定银行卡并完成实名核验。业务系统需要校验用户提交信息,确认银行卡归属为本人,规避卡号填写错误、身份冒充等资金风险。银行卡二/三/四要素核验API就是用于该场景的实名校验能力。

涉及到线上支付的行为,用户需要绑定银行卡并进行实名认证,相关企业也需要校对用户提交的信息,确认这张银行卡,确实是这个人本人的卡,防止填错、冒充,这时候就需要用到银行卡二/三/四要素。

接口 核验字段 安全等级 适用场景
银行卡二要素 姓名 + 银行卡号 低 低风险绑卡、卡面基础校验
银行卡三要素 姓名 + 银行卡号 + 身份证号 中(主流) 会员实名、账户绑卡、基础风控
银行卡四要素 姓名 + 银行卡号 + 身份证号 + 银行预留手机号 高 支付开户、提现、信贷等高风险场景

重要提示:接口仅返回信息一致/不一致的核验结论。根据银联风控规则,同一张银行卡24小时内最多支持5次核验,短时间频繁调用会触发风控拦截。

接口说明

请求参数

按需传入核验字段:例如二要素接口,入参为姓名、银行卡号;三要素增加身份证号;四要素额外传入银行预留手机号。

返回示例JSON

{
   
    "code": 1,
    "msg": "操作成功",
    "data": {
   
        "result": 1, //验证结果 0一致 1不一致 2未认证 3已注销
        "msg": "不一致",
        "desc": "无效卡号或卡状态异常,请换卡重试或联系发卡行",
        "bank_info": {
   
            "bin_digits": 6,
            "city": "合肥",
            "abbreviation": "BOCOM",
            "type": "借记卡",
            "bank": "交通银行",
            "province": "安徽",
            "card_digits": 19,
            "weburl": "www.bankcomm.com",
            "card_name": "交银IC卡",
            "tel": "95559",
            "isLuhn": false,
            "card_bin": "622262"
        }
    }
}

注意:外层code=1代表HTTP接口调用成功,不等于银行卡核验通过,真实核验结果以result字段为准。

  • result=0:核验一致
  • result=1:核验不一致
  • result=2:未认证
  • result=3:卡片已注销

bank_info是卡号BIN解析信息,可获取发卡行、卡种、归属地等基础信息,该部分不属于实名比对结果。

应用场景举例

  1. 达人佣金结算平台:用户提交银行卡用于佣金提现,调用接口校验身份,防止他人冒用银行卡领取佣金。
  2. 理财类小程序:用户绑卡充值、提现场景,使用银行卡四要素核验,确认卡片归属本人,降低冒名开户、资金盗刷风险。
  3. 保险业务平台:保险理赔打款前核验银行卡信息,确保理赔资金发放给投保人本人。

选型建议

  • 低风险结算场景,仅做基础身份校验:选用二要素、三要素
  • 涉及充值、提现等资金交易,风控要求高:推荐四要素核验
相关文章
|
2月前
|
存储 缓存 JSON
身份证二要素核验接口接入指南:参数设计、调用示例与常见问题
本文面向需要在业务系统中校验姓名与身份证号码是否一致的开发者,介绍身份证二要素核验接口的能力、参数设计、接入流程与调用规范。接口通过 AppCode 鉴权,以 GET 方式调用,Query 携带 name 与 idcard 两个参数;校验一致时返回生日、性别、籍贯等附加信息,不一致时返回明确失败标识。文章给出多语言调用示例、返回结构说明、错误码排查思路,以及参数前置校验、频控幂等、重试降级、合规脱敏等工程实践,供在金融、电商、社交、政务等实名核验场景中落地参考。
236 0
身份证二要素核验接口接入指南:参数设计、调用示例与常见问题
|
JSON 自然语言处理 搜索推荐
银行卡归属地及开户行查询API查询实战指南
银行卡归属地及开户行查询API,通过卡号快速识别发卡行、开户地及卡种信息,支持全国1500+银行,数据实时更新。提供结构化数据返回,广泛应用于支付、风控、用户画像等场景,助力金融系统高效、安全运行。
4648 126
|
SQL 关系型数据库 MySQL
Ruoyi从mysql切换到postgresql的几个坑
本文详细介绍基于ruoyi的数据库从mysql切换到postgresql详细步骤。
2441 0
Ruoyi从mysql切换到postgresql的几个坑
|
安全 开发工具 Android开发
几个Flutter常见诊断错误与解决Android toolchain - develop for Android devices X Unable to locate Android SDK
几个Flutter常见诊断错误与解决Android toolchain - develop for Android devices X Unable to locate Android SDK
5613 0
|
23天前
|
人工智能 小程序 API
垃圾分类识别 API‑图片辨垃圾‑生活垃圾图像分类‑垃圾物品识别‑四大类垃圾判定‑实拍垃圾识别 API 接口介绍
本接口提供AI垃圾分类图像识别服务,支持URL/ Base64图片输入,自动识别垃圾名称及所属类别(可回收/有害/厨余/其他),返回可信度与投放提示,适配日常实拍场景,助力智慧社区与环保应用高效落地。
100 0
|
2月前
|
存储 缓存 监控
银行卡二三四要素-银行卡四要素-银行卡二要素-银行卡三要素-银行卡实名认证接口
本文从技术视角梳理银行卡二、三、四要素实名核验接口的接入流程、参数规范与调用示例。二要素校验银行卡号与持卡人姓名一致性,三要素增加证件号校验,四要素进一步加入绑定手机号,构成递进的校验维度。文章给出 GET 请求与 APPCODE 鉴权方式、完整 Query 参数表、Python 与 Node.js 调用示例及返回字段结构,并覆盖在线调试要点、调用限制与规范、错误码排查与工程实践(前置校验、幂等去重、熔断降级、结果缓存、监控),以及合规与数据安全要求,供金融风控、账户安全与合规登记场景参考。
232 0
银行卡二三四要素-银行卡四要素-银行卡二要素-银行卡三要素-银行卡实名认证接口
|
2月前
|
存储 缓存 监控
银行卡二三四要素认证技术解析:接入流程、参数设计与风控实践
银行卡二三四要素认证用于核验持卡人身份与银行卡的一致性,是电商支付、金融借贷、共享经济等场景风控的基础环节。本文从原理与要素选型出发,系统讲解接入流程、参数设计、错误码排查,并补充合规要求与工程最佳实践,给出一套可落地的接入方案。
417 1
银行卡二三四要素认证技术解析:接入流程、参数设计与风控实践
|
2月前
|
存储 缓存 自然语言处理
身份证二要素实名认证接口|姓名 + 身份证号一致性核验方案,快速完成业务实名核验接入
本文以云市场身份证二要素实名认证接口为对象,介绍姓名与身份证号一致性核验的完整接入方案:接口参数设计与两种鉴权方式(APPCODE 简单认证、AppKey/AppSecret 签名认证)、多语言调用示例、返回结构解析与业务错误码排查(0 匹配、1 不匹配、2 无此号码、12 号码不合法、101/103 频控),以及前置校验、同证件 60 秒冷却与 24 小时级频控、敏感信息脱敏存储等工程实践要点,适合需要在注册、开卡、信贷、政务办事等流程中落地实名核验环节的开发者参考。
1124 0
身份证二要素实名认证接口|姓名 + 身份证号一致性核验方案,快速完成业务实名核验接入
|
2月前
|
缓存 监控 Java
银行卡二三四要素实名认证接口:接入流程、参数设计与工程实践
本文面向开发者,系统介绍银行卡二要素、三要素、四要素实名认证接口的能力说明、五步接入流程、多语言调用示例与返回结构解析,并覆盖调用规范、工程实践(前置校验、重试与熔断、结果缓存、监控告警)及错误码排查指南,适用于在线支付、金融开户、电商绑卡、风控合规等场景。
238 0
银行卡二三四要素实名认证接口:接入流程、参数设计与工程实践
|
3月前
|
人工智能 安全 API
计算巢 X DeepSeek Harness — 云端智能体工作台
DeepSeek Harness是DeepSeek推出的开源云端AI协作者,支持一键部署、多模型切换与安全审批。内置133个插件,可读写代码、执行命令、任务分解、子代理委派,真正“能干活”。团队共享、浏览器即用,告别本地环境噩梦。
计算巢 X DeepSeek Harness — 云端智能体工作台