全部产品
Search

搜索本产品

    ID Verification：BANK_CARD_N_META

    文档中心

    ID Verification：BANK_CARD_N_META

    更新时间：Jan 09, 2026

    本文介绍银行卡二/三/四要素核验API接口。

    接口说明

    • 接口名：BankMetaVerifyIntl

    • 请求方法：POST和GET

    • 传输协议：HTTPS

    • 接口说明：银行卡要素一致性核验， 包含：

      • 银行卡二要素（银行卡号 + 姓名）

      • 银行卡三要素（银行卡号 + 姓名 + 证件号码 ）

      • 银行卡四要素（银行卡号 + 姓名 + 证件号码 + 手机号）

    • QPS限量：API独享QPS限量，详情请参见ID Verification服务端API QPS限量说明。

    • 服务地址：

      说明

      • 内网访问优势：内网指阿里云同一地域内各产品间的私有通信网络。若您的业务服务器部署于阿里云对应地域，请使用内网域名访问 ID Verification 服务，以获得更安全、稳定的通信质量。 

      • 海外访问优化建议：海外网络环境复杂，建议参考服务端网络耗时分析与优化，优化集成方案，降低网络延迟及请求失败概率。

      中国香港

      • 公网：cloudauth-intl.cn-hongkong.aliyuncs.com

      • 内网：cloudauth-intl-vpc.cn-hongkong.aliyuncs.com

    在线调试和集成

    说明

    在调试和集成前，请确保您已完整阅读使用OpenAPI调试和集成服务端API文档，充分了解API接口在OpenAPI平台的调用方式和SDK及其代码的获取方式。

    您可以在OpenAPI Explorer中直接运行本接口进行调试，并生成本接口的SDK代码示例。

    请求参数

    名称

    类型

    是否必选

    描述

    示例值

    ProductCode

    String

    是

    固定值：BANK_CARD_N_META

    BANK_CARD_N_META

    ParamType

    String

    是

    加密方式：

    • normal：明文不加密

    • md5：MD5加密

    重要

    • 所有参数的密文均取 32位小写 MD5 字符串形式。

    • 不同MD5工具得出的密文可能不同，如果加密前接口可以调通但加密后不行，请尝试更换MD5工具。

    normal

    VerifyMode

    String

    是

    VERIFY_BANK_CARD：银行卡认证模式。

    表示将传入的银行卡号和用户的真实姓名、证件号、手机号是否匹配。

    VERIFY_BANK_CARD

    ProductType

    String

    是

    调用产品类型：

    • BANK_CARD_2_META：银行卡号+姓名核验

    • BANK_CARD_3_META：银行卡号+姓名+证件号核验

    • BANK_CARD_4_META：银行卡号+姓名+证件号+手机号核验

    BANK_CARD_4_META

    BankCard

    String

    是

    银行卡号：

    • paramType 传 normal 时：传入银行卡号明文。

    • paramType 传 md5 时：传入卡号最后6位前明文 + 最后6位密文。

    • 明文：12345678******

    • 密文：12345678f8ee21920e37807b43e7e912ab******

    UserName

    String

    是

    姓名：

    • paramType 传 normal 时：传入姓名明文。

    • paramType 传 md5 时：传入姓名第一个字密文 + 姓名其他部分明文。

    • 明文：张三

    • 密文：6499fc7409049355527ef6a2ba5706b8三

    IdentityType

    String

    否

    证件类型（传空值默认为身份证，其他证件类型详见证件类型列表）。

    01

    IdentifyNum

    String

    否

    证件号：

    • paramType 传 normal 时：传入证件号明文。

    • paramType 传 md5 时：

      • 身份证号前6位（明文）+ 出生年月日（密文）+ 身份证号后4位（明文）。

      • 其他证件最后两位MD5加密。

    重要

    ProductType为以下取值时，此项必选。

    • BANK_CARD_3_META

    • BANK_CARD_4_META

    • 明文：429001********8211

    • 密文：42900132fa7bcd874161bea8ec8fd98f******8211

    Mobile

    String

    否

    手机号：

    • paramType 传 normal 时：传入手机号明文。

    • paramType 传 md5 时：传入手机号密文。

    重要

    ProductType = BANK_CARD_4_META时，此项必选。

    • 明文：186****2055

    • 密文：849169cd3b20621c1c78bd61a1******

    证件类型列表

    IdentityType

    对应证件

    01

    身份证

    02

    军官证

    03

    护照

    04

    港澳居民来往内地通行证

    05

    台湾居民来往大陆通行证

    06

    警官证

    07

    士兵证

    08

    外国护照

    09

    外国人永久居留身份证

    10

    港澳居民居住证

    11

    台湾居民居住证

    12

    旅行证

    13

    出入境通行证

    响应参数

    名称

    类型

    描述

    示例值

    RequestId

    String

    请求ID。

    130A2C10-B9EE-4D84-88E3-5384FF******

    Code

    String

    返回Code。

    Success

    Message

    String

    返回Code的详细描述。

    success

    ResultObject

    BizCode

    String

    核验结果：

    • 1：校验⼀致（计费）

    • 2：校验不⼀致（计费）

    • 3：查⽆记录（不计费）

    1

    SubCode

    String

    核验详情：

    • 101：验证通过。

    • 201：认证信息不一致，持卡人信息有误。

    • 202：认证信息不一致，银行卡未开通认证支付。

    • 203：认证信息不一致，银行卡已过期。

    • 204：认证信息不一致，银行卡为受限制的卡。

    • 205：认证信息不一致，此卡被没收。

    • 206：认证信息不一致，银行卡无效。

    • 207：认证信息不一致，此卡无对应发卡行。

    • 208：认证信息不一致，该卡未初始化或睡眠卡。

    • 209：认证信息不一致，此卡为作弊卡、吞卡。

    • 210：认证信息不一致，此卡已挂失。

    • 211：认证信息不一致，密码错误次数超限。

    • 212：认证信息不一致，发卡行不支持此交易。

    • 213：认证信息不一致，卡状态不正常或卡无效。

    • 214：认证信息不一致，未预留手机号。

    • 215：认证信息不一致，输入的密码、有效期或CVN2有误。

    • 216：认证信息不一致，其他卡异常情况。

    • 301：无法验证，银行卡不支持该业务。

    • 302：无法验证，验证失败或银行拒绝验证，请联系发卡行。

    • 303：无法验证，银行卡暂不支持手机号验证。

    • 304：无法验证，银行卡号有误。

    • 305：无法验证，其他原因。

    • 306：无法验证，验证次数超限。

    101

    返回Code

    HTTP状态码

    Code

    Message描述

    200

    Success

    请求成功。

    400

    MissingParameter

    参数不能为空。

    InvalidParameter

    非法参数。

    403

    Forbidden.RAMUserAccessDenied

    需要给RAM用户授予AliyunAntCloudAuthFullAccess操作权限。更多信息，请参见授权RAM用户访问服务。

    Forbidden.AccountAccessDenied

    确保您开通了ID verifycation，并且保证账户未欠费。

    Throttling.Api

    API限流拦截。

    500

    InternalError

    系统内部错误，请反馈工程师排查。