調用VerifyBankElement接口發起銀行卡OCR或二三四要素認證請求。
傳入圖片格式要求
圖片大小:圖片大小建議不超過2 MB。圖片過大可能會影響接口響應速度,甚至可能導致讀取圖片超時失敗。
圖片格式:PNG、JPG、JPEG。
圖片分辨率:圖片長寬需要大于64像素且小于8192像素。
圖片質量要求:圖片模糊、內容遮擋、光線或圖片角度異常都可能會對識別結果產生影響;在識別身份證人像面時,需要確保人臉呈現正向。
接口說明
接口名稱:VerifyBankElement。
服務地址:cloudauth.cn-shanghai.aliyuncs.com
(上海地域)或cloudauth.cn-beijing.aliyuncs.com
(北京地域)。
請求方法:POST和GET。
傳輸協議:HTTPS。
接口描述:該接口支持以下四種認證方式:
銀行卡照片OCR識別:通過銀行卡照片識別出銀行卡號。
銀行卡二要素認證:識別銀行卡號和用戶的真實姓名是否匹配。
銀行卡三要素認證:識別銀行卡號和用戶的真實姓名、身份證號是否匹配。
銀行卡四要素認證:識別銀行卡號和用戶的真實姓名、身份證號、手機號是否匹配。
關于以上四種認證方式的必選請求參數,如下表所示。
表 1. 四種方式的必選請求參數說明
認證方式 | SceneId | OuterOrderNo | Mode | IdName | IdNo | Mobile | BankCardUrl和BankCardFile | |
銀行卡照片OCR識別 | 是 | 是 | 是 Mode取值為OCR_BANK_CARD。 | 否 | 否 | 否 | 否 | |
銀行卡二要素認證 | 是 | 是 | 是 Mode取值為OCR_VERIFY_BANK_CARD。 | 是 | 否 | 否 | 是 BankCardUrl和BankCardFile二選一。 | |
是 Mode取值為VERIFY_BANK_CARD。 | 是 | 否 | 否 | 否 | ||||
銀行卡三要素認證 | 是 | 是 | 是 Mode取值為OCR_VERIFY_BANK_CARD。 | 是 | 是 | 否 | 是 BankCardUrl和BankCardFile二選一。 | |
是 Mode取值為VERIFY_BANK_CARD。 | 是 | 是 | 否 | 否 | ||||
銀行卡四要素認證 | 是 | 是 | 是 Mode取值為OCR_VERIFY_BANK_CARD。 | 是 | 是 | 是 | 是 BankCardUrl和BankCardFile二選一。 | |
是 Mode取值為VERIFY_BANK_CARD。 | 是 | 是 | 是 | 否 |
請求參數
名稱 | 類型 | 是否必選 | 示例值 | 描述 |
SceneId | Long | 是 | 100000xxxx | 認證場景ID。 您必須先在增強版實人認證控制臺創建認證場景,才能獲得認證場景ID。更多信息,請參見添加認證場景。 |
OuterOrderNo | String | 是 | e0c34a77f5ac40a5aa5e6ed20c35xxxx | 商戶服務端自定義的業務請求唯一標識,用于后續定位排查問題使用,由32位字母、數字組合而成。 |
Mode | String | 是 | OCR_BANK_CARD | 銀行卡卡證核身的模式。取值:
|
BankCardNo | String | 否 | 54121234567xxxxx | 銀行卡號。 當Mode取值為VERIFY_BANK_CARD時,BankCardNo為必選參數。 |
IdName | String | 否 | 張三 | 用戶的真實姓名。 當Mode取值為OCR_VERIFY_BANK_CARD或VERIFY_BANK_CARD時,IdName為必選參數。 |
IdNo | String | 否 | 330103xxxxxxxxxxxx | 用戶的身份證號碼。 當使用銀行卡三、四要素認證方式時,IdNo為必選參數。 |
BankCardUrl | String | 否 | https://www.aliyun.com/cert.jpeg | 證件地址,公網可訪問的HTTP、HTTPS鏈接。 當Mode取值為OCR_BANK_CARD或OCR_VERIFY_BANK_CARD時,BankCardUrl和BankCardFile二選一。 |
BankCardFile | InputStream | 否 | 無 | 本地證件文件。 當Mode取值為OCR_BANK_CARD或OCR_VERIFY_BANK_CARD時,BankCardUrl和BankCardFile二選一。 |
Mobile | String | 否 | 1301234xxxxx | 用戶的手機號。 當使用銀行卡四要素認證方式時,Mobile為必選參數。 |
返回數據
名稱 | 類型 | 示例值 | 描述 |
RequestId | String | 130A2C10-B9EE-4D84-88E3-5384FF039795 | 請求ID。 |
Message | String | success | 請求信息的響應消息。 |
Code | String | 200 | 返回碼。關于返回碼的具體介紹,請參見Code和Message說明。 |
ResultObject | Object | 認證主體信息。ResultObject是一個結構體,關于ResultObject的結構描述,請參見ResultObject。 |
表 2. ResultObject
名稱 | 類型 | 示例值 | 描述 |
Passed | String | T | 認證是否通過,取值:
說明 如果接口異常或接口是未認證狀態,則不返回該參數。 |
SubCode | String | 200 | 認證結果碼。關于認證結果碼的具體介紹,請參見SubCode。 |
CertifyId | String | 08573be80f944d95ac812e019e3655a8 | 認證請求ID,認證請求的唯一標識。 |
MaterialInfo | String | {"BankCardNo": "54121234567xxxxx"} | 認證主體的卡證信息識別結果。OcrBankCardInfo是一個結構體,關于OcrBankCardInfo的結構描述,請參見OcrBankCardInfo。 |
表 3. OcrBankCardInfo
名稱 | 類型 | 示例值 | 描述 |
BankCardNo | String | 54121234567xxxxx | 銀行卡號。 |
表 4. SubCode
SubCode | 是否計費 | 描述 |
200 | 是 | 認證通過。 |
201 | 是 | 實名校驗不通過。認證不通過。可能導致失敗的原因:用戶的身份信息不匹配、信息有誤或查詢不到身份信息。 |
202 | 是 | 查詢不到身份信息。認證不通過。可能導致失敗的原因:用戶發生戶口遷移、用戶為軍人等特殊狀態。建議預留人工審核入口,用于人工審核。 |
203 | 是 | 認證信息不一致,銀行卡未開通認證支付。 |
204 | 是 | 認證信息不一致,銀行卡已過期。 |
205 | 是 | 認證信息不一致,銀行卡為受限制的卡。 |
206 | 是 | 認證信息不一致,此卡被沒收。 |
207 | 是 | 認證信息不一致,銀行卡無效。 |
208 | 是 | 認證信息不一致,此卡無對應發卡行。 |
209 | 是 | 認證信息不一致,該卡未初始化或睡眠卡。 |
210 | 是 | 認證信息不一致,此卡為作弊卡、吞卡。 |
211 | 是 | 認證信息不一致,此卡已掛失。 |
212 | 是 | 認證信息不一致,密碼錯誤次數超限。 |
213 | 是 | 認證信息不一致,發卡行不支持此交易。 |
214 | 是 | 認證信息不一致,卡狀態不正常或卡無效。 |
215 | 是 | 認證信息不一致,未預留手機號。 |
216 | 是 | 認證信息不一致,輸入的密碼、有效期或CVN2有誤。 |
217 | 是 | 認證信息不一致,其他卡異常情況。 |
218 | 是 | 無法驗證,銀行卡不支持該業務。 |
219 | 是 | 無法驗證,驗證失敗或銀行拒絕驗證,請聯系發卡行。 |
220 | 是 | 無法驗證,銀行卡暫不支持手機號驗證。 |
221 | 是 | 無法驗證,銀行卡號有誤。 |
222 | 是 | 無法驗證,驗證次數超限。 |
Code和Message說明
Code | Message | 描述 |
200 | success | 接口響應成功。 |
400 | 參數不能為空 | 參數不能為空。 |
401 | 參數非法 | 傳入的字段不符合取值范圍或長度不符合要求。 |
403 | 異常重復調用 | 異常重復調用次數超限。 |
410 | 未開通服務 | 未開通OSS產品或未完成OSS讀寫授權,請登錄增強版實人認證控制臺完成授權。 |
411 | RAM無權限 | 需要為RAM用戶授予AliyunYundunCloudAuthFullAccess的操作權限。 |
412 | 欠費中 | 增強版實人認證服務或OSS對象存儲服務存在欠費,請充值后再進行操作。 |
420 | 數據重復 | 請求參數中BankCardUrl和BankCardFile二選一。 |
428 | 格式校驗錯誤 | 傳入的姓名、身份證號碼長度必須符合國家標準且不得包含英文字母或特殊字符。 |
500 | 系統錯誤 | 系統內部錯誤,請通過智能在線聯系阿里云工程師協助排查。 |