在金融和支付領域，獲取銀行卡的歸屬信息是一個常見的需求。**萬維易源提供的“銀行卡歸屬信息查詢”API為開發者和企業提供了高效、便捷的銀行卡信息查詢服務，可以通過簡單的接口調用獲取銀行卡的歸屬地、銀行名稱、電話號碼、網址、卡種、銀聯Luhn效驗和BIN碼等詳細信息。**本文將詳細介紹如何使用該API，以及其核心功能和調用方法。
一、API概述
1. 接入點說明
- 功能：通過銀行卡號查詢銀行卡的歸屬地，并附加返回卡號對應的地區、銀行名、電話號碼、網址、卡種、銀聯Luhn效驗和BIN碼等信息。當歸屬地查詢失敗時，不扣費。
- 用途：廣泛應用于金融分析、支付系統、風險管理等場景，幫助用戶快速獲取銀行卡的相關信息。
2. 接口地址
https://route.showapi.com/30-7?appKey={your_appKey}
請將 {your_appKey} 替換為你在萬維易源平臺申請的個人 appKey。
二、請求參數
以下是提交銀行卡歸屬信息查詢任務所需的請求參數：
| 參數名稱 | 類型 | 示例值 | 必須 | 描述 |
|---|---|---|---|---|
| cardNum | String | 6228480402564890018 | 是 | 銀行卡號。 |
| needBin | String | 1 | 否 | 是否需要返回銀行卡BIN碼信息和銀聯Luhn效驗。1 表示需要，0 表示不需要，默認不會返回這些信息，返回這些信息將使得查詢更加耗時。 |
三、返回參數
以下是接口返回的參數及其描述：
| 參數名稱 | 類型 | 示例值 | 描述 |
|---|---|---|---|
| ret_code | Number | 0 | 返回代碼：0 表示成功，其他表示失敗。 |
| area | String | 江蘇省 - 蘇州 | 地區。 |
| cardType | String | 借記卡 | 銀行卡種。 |
| brand | String | 金穗通寶卡(銀聯卡) | 銀行卡產品名稱（品牌）。 |
| tel | String | 95599 | 銀行客服電話。 |
| bankName | String | 中國農業銀行 | 銀行名稱。 |
| url | String | www.abchina.com | 銀行官網。 |
| simpleCode | String | ABC | 銀行簡碼（該字段為銀聯支付網關簡碼，不一定有該字段返回）。 |
| formatBankName | String | 農業銀行 | 規范化的銀行名稱，部分銀行為空字符串。 |
| logo | String | http://app2.showapi.com/banklogo/abc.png | 銀行logo，部分銀行為空字符串。 |
| card_bin | String | 622848 | 銀行卡BIN碼（需要請求參數中 needBin=1 才有該值返回）。當無法查詢到該銀行卡BIN碼時返回空字符串。 |
| bin_digits | String | 6 | 銀行卡BIN碼長度（需要請求參數中 needBin=1 才有該值返回）。 |
| card_digits | String | 19 | 銀行卡卡號長度（需要請求參數中 needBin=1 才有該值返回）。 |
| isLuhn | String | 1 | 是否能通過中國銀聯Luhn效驗，1 表示可以，0 表示不能，空字符串表示不支持（需要請求參數中 needBin=1 才有該值返回）。 |
四、調用示例
以下是一個使用 curl 命令調用該接口的示例：
curl 'https://route.showapi.com/30-7?appKey=your_appKey' \-H 'Content-Type: application/x-www-form-urlencoded' \-d 'needBin=1' \-d 'cardNum=6228480402564890018'
請將 your_appKey 替換為你在萬維易源平臺申請的 appKey。
五、返回示例
以下是接口返回的JSON示例：
{"showapi_res_code": 0,"showapi_res_error": "","showapi_res_id": "ce135f6739294c63be0c021b76b6fbff","showapi_res_body": {"ret_code": 0,"area": "江蘇省 - 蘇州","tel": "95599","brand": "金穗通寶卡(銀聯卡)","bankName": "中國農業銀行","cardType": "借記卡","url": "www.abchina.com","cardNum": "622848***********018","simpleCode": "ABC","formatBankName": "農業銀行","logo": "http://app2.showapi.com/banklogo/abc.png","card_bin": "622848","bin_digits": "6","card_digits": "19","isLuhn": "1"}
}
六、獲取 appKey
要獲取 appKey，請訪問萬維易源的控制臺頁面：
查看 appKey
七、總結
萬維易源的“銀行卡歸屬信息查詢”API為開發者和企業提供了一個高效、便捷的工具，可以通過簡單的接口調用獲取銀行卡的詳細信息。通過該API，可以快速查詢銀行卡的歸屬地、銀行名稱、電話號碼、網址、卡種、銀聯Luhn效驗和BIN碼等信息，適用于金融分析、支付系統、風險管理等多種場景。希望本文能幫助你更好地了解和使用該API。如果你有任何問題或需要進一步的幫助，請隨時訪問萬維易源的官方文檔或聯系技術支持。
