全部产品
Search
文档中心

ID Verification:BANK_CARD_N_META

更新时间:Oct 23, 2026

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

接口说明

  • 接口名:BankMetaVerifyIntl

  • 请求方法:POST和GET

  • 传输协议:HTTPS

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

    • 银行卡二要素(银行卡号 + 姓名)

    • 银行卡三要素(银行卡号 + 姓名 + 证件号码 )

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

  • QPS限量:API独享QPS限量,详情请参见服务端API QPS限量说明。

  • 服务地址:

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

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

    中国香港

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

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

在线调试和集成

说明

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

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

请求参数

名称

类型

是否必选

描述

示例值

ProductCode

String

是

固定值:BANK_CARD_N_META

BANK_CARD_N_META

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

ParamType

String

是

加密方式:

  • normal:明文不加密

  • sm2:SM2加密

说明

SM2参数加密的相关信息,请参考SM2加密说明。

normal

BankCard

String

是

银行卡号。

  • 当paramType 取值 normal 时:传入银行卡号明文。

  • 当paramType取值sm2 时,传入银行卡号SM2密文。

  • 明文:12345678******

  • SM2 密文:MHUCIQDD5rrj8x5xZEXe9d2lI131M4Ql8bWmeMG+ba6KGT3IgekQYhgDtxaDuoRD4bde/5fnFdlUp4YoxlEnIFLLm2mQEILkctuy6Rw6lfAUxBtkpPoPVCJAeD5al/RX8JFUvTACEBAYAgLJjBe0=

UserName

String

是

姓名。

  • 当paramType取值normal时,传入姓名明文。

  • 当paramType取值sm2 时,传入姓名SM2密文。

  • 明文:张三

  • SM2 密文:MG8CIQCxI0wNYbc0c2BRL+7+tSethTXfQC391ZFnszRRcvRZ9AIgekQYhgDtxaDuoRD4bde/5fnFdlUp4YoxlEnIFLLm2mQEILkctuy6Rw6lfAUxBtkpPoPVCJAeD5al/RX8JFUvTACEBAYAgLJjBe0=

IdentityType

String

否

证件类型(传空值默认为身份证,其他证件类型详见证件类型列表)。

01

IdentifyNum

String

条件必选

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

  • BANK_CARD_3_META

  • BANK_CARD_4_META

证件号。

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

  • paramType 传入 sm2 时:输入身份证号SM2密文。

  • 明文:429001********8211

  • SM2密文:MHsCIEPDt1ycBNSVgA2yKsMnvWGheiI+STWqJLmYWlZnklhnAiEAwq1bk5YVepHwqfMsd9ErlK71OrdXx8E+wfqbzyFCwoMEIM1QdrFeekvQh6fwK7sVXAsNePiNm7Eulqm/zahRosbKBBKgtyhm3SopJ3tO/wALKXQQW+g=

Mobile

String

条件必选

ProductType = BANK_CARD_4_META时,此项必选。

手机号。

  • 当paramType取值normal时,传入手机号明文。

  • 当paramType取值 传 sm2 时,传入手机号SM2密文

  • 明文:131****8888

  • SM2 密文:MHUCIQDD5rrj8x5xZEXe9d2lI131M4Ql8bWmeMG+ba6KGT38xAIhAJErofLS0A/uMn/tU2lbHPRBnJKvDdLjJ5kARYOq4gHHBCBzZ3kecz1p80B8nPWNnQQMOkQeERWiOvLdhw/b7hjUZQQLqPBQkFGbfHZDCAE=

证件类型列表

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,具体信息请参见服务端返回HTTP状态码说明。

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