本文介绍银行卡要素(银行卡二要素、银行卡三要素和银行卡四要素)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 |
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,并已配置环境变量。具体操作,请参见:
接口在线调试和SDK示例:OpenAPI平台