本文介紹銀行卡要素(銀行卡二要素、銀行卡三要素和銀行卡四要素)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時,此項必選。 |
|
證件類型列表
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為成功,其他為失敗。 重要
| 200 | |
ResultObject | BizCode | String | 核驗結果:
| 1 |
SubCode | String | 核驗詳情:
| 101 |
SDK調用示例
集成前請確認您已獲取AccessKey,并已配置環境變量。具體操作,請參見: