POSTbankcard-bin-international
國際版銀行卡 BIN 查詢
透過卡號前 6-8 位 BIN,識別國際信用卡/簽帳卡的卡組織 (Visa/Mastercard/JCB 等)、卡類型、發卡國家/地區、發卡行。
10 匠幣/次
線上除錯
無需寫程式,瀏覽器中直接發起真實請求
接入文件
介面簡介
本介面基於國際標準 BIN(Bank Identification Number)資料庫,支援輸入銀行卡號前 6-8 位,快速識別卡片所屬的卡組織(如 Visa、Mastercard、JCB、American Express 等)、卡片型別(Credit/Debit/Prepaid)、髮卡國家/地區、貨幣程式碼以及具體髮卡行名稱。
適用場景
- 跨境支付風控:在交易前置環節校驗卡片歸屬地,攔截高風險國家或異常卡種交易。
- 表單自動填充:根據使用者輸入的卡號字首,自動匹配並顯示卡組織 Logo、幣種及髮卡行,提升使用者體驗。
- 多幣種結算系統:輔助判斷卡片預設結算貨幣,最佳化匯率展示與結算邏輯。
- 全球業務合規:區分中國大陸與國際銀行卡,適配不同的合規校驗流程。
請求與返回說明
- 請求方式:POST
- 核心引數:
bankcard(字串),傳入完整的卡號或至少前 6 位 BIN 碼。 - 返回資料:
scheme:卡組織標識(如 "Visa")。card_type:卡片型別(如 "Credit", "Debit")。country_name/country_code:髮卡國家名稱及 ISO 程式碼。currency/currency_code:關聯貨幣名稱及程式碼。bank_name:髮卡銀行全稱。country_flag:國家旗幟 Emoji。
接入建議
- 輸入規範:建議僅提取卡號前 6-8 位進行查詢,避免傳輸完整敏感卡號,降低資料安全合規風險。
- 快取策略:BIN 碼與髮卡行的對應關係相對穩定,建議對高頻出現的 BIN 碼進行本地快取(如 TTL 設定為 7-30 天),以減少 API 呼叫次數並降低延遲。
- 容錯處理:部分預付卡或虛擬卡的髮卡行資訊可能缺失,前端展示時需對
bank_name為空的情況做相容處理。 - 區別注意:本介面專注於國際卡組織識別,若需查詢中國大陸銀聯卡的詳細開戶行網點資訊,請選用專用的國內銀行卡歸屬地查詢介面。
接入示例程式碼
提供 Shell、Python、Go、Java、PHP 等常見接入示例,便於直接接到現有專案裡。
請求示例
{
"bankcard": "4242424242"
}響應示例
{
"code": 200,
"message": "success",
"data": {
"scheme": "Visa",
"card_type": "Credit",
"country_name": "United states of america",
"country_code": "us",
"country_flag": "🇺🇸",
"currency": "United States dollar",
"currency_code": "USD",
"bank_name": "JPMORGAN CHASE BANK NA"
}
}請求欄位
以下欄位根據示例 JSON 自動提取,僅作接入參考。
| 欄位路徑 | 型別 | 示例值 |
|---|---|---|
| bankcard | string | 4242424242 |
響應欄位
以下欄位根據示例 JSON 自動提取,僅作接入參考。
| 欄位路徑 | 型別 | 示例值 |
|---|---|---|
| code | number | 200 |
| message | string | success |
| data | object | {...} |
| data.scheme | string | Visa |
| data.card_type | string | Credit |
| data.country_name | string | United states of america |
| data.country_code | string | us |
| data.country_flag |