本文介绍银行卡要素(银行卡二要素、银行卡三要素和银行卡四要素)API接口。
接口信息
在使用本接口前,请确保已完整阅读接入流程,并开通服务。
接口名:BankMetaVerify
接口说明:
银行卡要素一致性核验, 包含:
重要任意要素不一致均不能通过核验,核验结果可以查看SubCode字段。
银行卡二要素(银行卡号 + 姓名)
银行卡三要素(银行卡号 + 姓名 + 证件号码 )
银行卡四要素(银行卡号 + 姓名 + 证件号码 + 手机号)
QPS限量:API独享QPS限量,详情请参见信息核验接口QPS限量说明。
服务地址(调用 API 时的 Endpoint):
地域
IPv4
IPv6
通用
cloudauth.aliyuncs.com
cloudauth-dualstack.aliyuncs.com
北京
cloudauth.cn-beijing.aliyuncs.com
cloudauth-dualstack.cn-beijing.aliyuncs.com
上海
cloudauth.cn-shanghai.aliyuncs.com
cloudauth-dualstack.cn-shanghai.aliyuncs.com
说明服务地址可选择与业务服务器距离相近的 endpoint ,以降低延迟。
也可以构建列表轮询使用,以提高可用性。
请求参数
名称 | 类型 | 是否必选 | 描述 | 示例值 |
ParamType | String | 是 | 加密方式:
重要
| normal |
VerifyMode | Strng | 是 | VERIFY_BANK_CARD:银行卡认证模式。 表示将传入的银行卡号和用户的真实姓名、证件号、手机号是否匹配。 | VERIFY_BANK_CARD |
ProductType | String | 是 | 调用产品类型:
| BANK_CARD_4_META |
BankCard | String | 是 | 银行卡号:
|
|
UserName | String | 是 | 姓名:
|
|
IdentityType | String | 否 | 证件类型(传空值默认为身份证,其他证件类型详见下表)。 | 01 |
IdentifyNum | String | 否 | 证件号:
重要 ProductType为以下取值时,此项必选。
|
|
Mobile | String | 否 | 手机号:
重要 ProductType = BANK_CARD_4_META时,此项必选。 |
|
响应参数
名称 | 类型 | 描述 | 示例值 | |
RequestId | String | 请求ID。 | 130A2C10-B9EE-4D84-88E3-5384FF039795 | |
Message | String | 返回信息。 | success | |
Code | String | 返回码:200为成功,其他为失败。 重要
| 200 | |
ResultObject | BizCode | String | 核验结果:
| 1 |
SubCode | String | 核验详情:
| 101 |
SDK调用示例
集成前请确保您已完整阅读接入流程,开通了服务并获取AccessKey且正确配置环境变量。