银行卡核验

本文介绍银行卡要素(银行卡二要素、银行卡三要素和银行卡四要素)API接口。

接口信息

  • 接口名:BankMetaVerify

  • 服务地址:

    • 北京地域:cloudauth.cn-beijing.aliyuncs.com(IPv4)或cloudauth-dualstack.cn-beijing.aliyuncs.com(IPv6)

    • 上海地域:cloudauth.cn-shanghai.aliyuncs.com(IPv4)或cloudauth-dualstack.cn-shanghai.aliyuncs.com(IPv6)

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

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

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

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

  • QPS限量:API独享QPS限量,详情请参见信息核验接口QPS限量说明

请求参数

名称

类型

是否必选

描述

示例值

ParamType

String

加密方式:

  • normal:明文不加密

  • md5:MD5加密

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

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

normal

VerifyMode

Strng

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******

  • 密文:

    12345678f8ee21920e37807b43e7e912ab829b6e

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

  • 密文:

    42900132fa7bcd874161bea8ec8fd98f390ec98211

Mobile

String

手机号:

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

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

重要

ProductType = BANK_CARD_4_META时,此项必选。

  • 明文:186****2055

  • 密文:

    849169cd3b20621c1c78bd61a11a4fc2

证件类型列表

IdentityType

对应证件

01

身份证

02

军官证

03

护照

04

港澳居民来往内地通行证

05

台湾居民来往大陆通行证

06

警官证

07

士兵证

08

外国护照

09

外国人永久居留身份证

10

港澳居民居住证

11

台湾居民居住证

响应参数

名称

类型

描述

示例值

RequestId

String

请求ID。

130A2C10-B9EE-4D84-88E3-5384FF039795

Message

String

返回信息。

success

Code

String

返回码:200为成功,其他为失败。

重要
  • 此参数代表是否正确调用了接口,详细的返回码说明请参见错误码

  • 业务核验结果请通过ResultObject中的字段查看。

200

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

SDK调用示例

重要

集成前请确认您已获取AccessKey,并已配置环境变量。具体操作,请参见:

  • 接口在线调试和SDK示例:OpenAPI平台

    关于SDK示例和安装包获取:

    • 您可以在OpenAPI的在线接口调试页面的右侧找到对应的SDK调用示例,并在代码示例的右上角点击SDK安装信息查看SDK的安装信息。

      image

    • 如果您有离线安装的需求,可以进入SDK安装页面选择需要语言的SDK,并转到发布地址获取。

      image

  • 各编程语言调用示例:代码示例工程