全部產品
Search

搜尋本產品

    ID Verification：BANK_CARD_N_META

    文件中心

    ID Verification：BANK_CARD_N_META

    更新時間：Sep 30, 2025

    本文介紹銀行卡二/三/四要素核驗API介面。

    介面說明

    • 介面名：BankMetaVerifyIntl

    • 要求方法：POST和GET

    • 傳輸協議：HTTPS

    • 介面說明：銀行卡要素一致性核驗， 包含：

      • 銀行卡二要素（銀行卡號 + 姓名）

      • 銀行卡三要素（銀行卡號 + 姓名 + 證件號碼 ）

      • 銀行卡四要素（銀行卡號 + 姓名 + 證件號碼 + 手機號）

    • QPS限量：API獨享QPS限量，詳情請參見ID Verification服務端API QPS限量說明。

    • 服務地址：

      說明

      內網指的是阿里雲同地區產品之間的內部通訊網路，如果您的商務服務器部署在阿里雲的對應地區，可以通過內網網域名稱訪問 ID Verification 服務，以獲得更安全、穩定的網路通訊品質。

      中國香港

      • 公網：cloudauth-intl.cn-hongkong.aliyuncs.com

      • 內網：cloudauth-intl-vpc.cn-hongkong.aliyuncs.com

    線上調試和整合

    說明

    在調試和整合前，請確保您已完整閱讀使用OpenAPI調試和整合服務端API文檔，充分瞭解API介面在OpenAPI平台的調用方式和SDK及其代碼的擷取方式。

    您可以在OpenAPI Explorer中直接運行本介面進行調試，並產生本介面的SDK程式碼範例。

    請求參數

    名稱

    類型

    是否必選

    描述

    樣本值

    ProductCode

    String

    是

    固定值：BANK_CARD_N_META

    BANK_CARD_N_META

    ParamType

    String

    是

    加密方式：

    • normal：明文不加密

    • md5：MD5加密

    重要

    • 所有參數的密文均取 32位小寫 MD5 字串形式。

    • 不同MD5工具得出的密文可能不同，如果加密前介面可以調通但加密後不行，請嘗試更換MD5工具。

    normal

    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

    BankCard

    String

    是

    銀行卡號：

    • paramType 傳 normal 時：傳入銀行卡號明文。

    • paramType 傳 md5 時：傳入卡號最後6位前明文 + 最後6位密文。

    • 明文：12345678******

    • 密文：12345678f8ee21920e37807b43e7e912ab******

    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

    • 密文：42900132fa7bcd874161bea8ec8fd98f******8211

    Mobile

    String

    否

    手機號：

    • paramType 傳 normal 時：傳入手機號明文。

    • paramType 傳 md5 時：傳入手機號密文。

    重要

    ProductType = BANK_CARD_4_META時，此項必選。

    • 明文：186****2055

    • 密文：849169cd3b20621c1c78bd61a1******

    證件類型列表

    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。

    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

    返回Code

    HTTP狀態代碼

    Code

    Message描述

    200

    Success

    請求成功。

    400

    MissingParameter

    參數不可為空。

    InvalidParameter

    非法參數。

    403

    Forbidden.RAMUserAccessDenied

    需要給RAM使用者授予AliyunAntCloudAuthFullAccess操作許可權。更多資訊，請參見授權RAM使用者訪問服務。

    Forbidden.AccountAccessDenied

    確保您開通了ID verifycation，並且保證賬戶未欠費。

    Throttling.Api

    API限流攔截。

    500

    InternalError

    系統內部錯誤，請反饋工程師排查。