跳转到主要内容
GET
/
v1
/
bic
BIC 验证
curl --request GET \
  --url https://bankvalidation.cleariflow.com/v1/bic/
{
  "bic": "DEUTDEFF500",
  "is_valid": true,
  "country_code": "DE",
  "country_name": "Germany",
  "bank_code": "DEUT",
  "bank_name": "Bank information not available",
  "location_code": "F",
  "branch_code": "500",
  "details": {
    "type": "BIC",
    "active": true,
    "institution_type": "Bank"
  }
}

​
快速开始

​
基础 URL

https://bankvalidation.cleariflow.com/v1/bic/

​
验证端点

bic 端点需要您的 API 密钥和 BIC 参数，以对业务标识码进行全面验证。 
https://bankvalidation.cleariflow.com/v1/bic/
? api_key = YOUR_UNIQUE_API_KEY
& bic = DEUTDEFF500
此成功请求验证德国 BIC 并返回详细信息： 
{
  "bic": "DEUTDEFF500",
  "is_valid": true,
  "country_code": "DE",
  "country_name": "Germany",
  "bank_code": "DEUT",
  "bank_name": "Bank information not available",
  "location_code": "F",
  "branch_code": "500",
  "details": {
    "type": "BIC",
    "active": true,
    "institution_type": "Bank"
  }
}

​
请求参数

​
api_key
String
必填
您的唯一 API 密钥。请注意，每个用户为每个 Cleariflow API 拥有 独立的 API 密钥，因此您的银行验证 API 密钥无法用于汇率 API，例如。
​
bic
String
必填
要验证的业务标识码。允许空格，处理过程中将自动移除。BIC 应遵循 ISO 9362 标准格式。

​
响应参数

API 响应以通用、轻量的 JSON 格式 返回。
​
bic
String
规范化后的 BIC，无空格，以大写格式返回。
​
is_valid
Boolean
总体验证结果，表示 BIC 是否符合所有验证规则。
​
country_code
String
两字母 ISO 国家代码（例如 DE 表示德国，US 表示美国）。
​
country_name
String
与 BIC 关联国家的全称。
​
bank_code
String
4 字符银行标识码（例如 DEUT 表示德意志银行）。
​
bank_name
String
银行名称（当前显示 “Bank information not available”）。
​
location_code
String
2 字符位置代码，表示城市或地区（例如 FF 表示法兰克福）。
​
branch_code
String
3 字符分行代码（可选，8 字符 BIC 可能为空）。
​
details
Object
关于 BIC 类型和状态的附加详细信息。
​
details.type
String
标识符类型（通常为 “BIC”）。
​
details.active
Boolean
BIC 当前是否处于活跃使用状态。
​
details.institution_type
String
金融机构类型（例如 “Bank”、“Credit Union”）。

​
示例

​
有效的德国 BIC（8 个字符）

请求： 
GET https://bankvalidation.cleariflow.com/v1/bic/?api_key=YOUR_API_KEY&bic=DEUTDEFF
响应： 
{
  "bic": "DEUTDEFF",
  "is_valid": true,
  "country_code": "DE",
  "country_name": "Germany",
  "bank_code": "DEUT",
  "bank_name": "Bank information not available",
  "location_code": "FF",
  "branch_code": "",
  "details": {
    "type": "BIC",
    "active": true,
    "institution_type": "Bank"
  }
}

​
有效的德国 BIC（11 个字符，含分行）

请求： 
GET https://bankvalidation.cleariflow.com/v1/bic/?api_key=YOUR_API_KEY&bic=DEUTDEFF500
响应： 
{
  "bic": "DEUTDEFF500",
  "is_valid": true,
  "country_code": "DE",
  "country_name": "Germany",
  "bank_code": "DEUT",
  "bank_name": "Bank information not available",
  "location_code": "FF",
  "branch_code": "500",
  "details": {
    "type": "BIC",
    "active": true,
    "institution_type": "Bank"
  }
}

​
有效的美国 BIC

请求： 
GET https://bankvalidation.cleariflow.com/v1/bic/?api_key=YOUR_API_KEY&bic=CHASUS33
响应： 
{
  "bic": "CHASUS33",
  "is_valid": true,
  "country_code": "US",
  "country_name": "United States",
  "bank_code": "CHAS",
  "bank_name": "Bank information not available",
  "location_code": "33",
  "branch_code": "",
  "details": {
    "type": "BIC",
    "active": true,
    "institution_type": "Bank"
  }
}

​
有效的英国 BIC

请求： 
GET https://bankvalidation.cleariflow.com/v1/bic/?api_key=YOUR_API_KEY&bic=NWBKGB2L
响应： 
{
  "bic": "NWBKGB2L",
  "is_valid": true,
  "country_code": "GB",
  "country_name": "United Kingdom",
  "bank_code": "NWBK",
  "bank_name": "Bank information not available",
  "location_code": "2L",
  "branch_code": "",
  "details": {
    "type": "BIC",
    "active": true,
    "institution_type": "Bank"
  }
}

​
无效的 BIC

请求： 
GET https://bankvalidation.cleariflow.com/v1/bic/?api_key=YOUR_API_KEY&bic=INVALID
响应： 
{
  "bic": "INVALID",
  "is_valid": false,
  "country_code": "",
  "country_name": "",
  "bank_code": "",
  "bank_name": "Bank information not available",
  "location_code": "",
  "branch_code": "",
  "details": {
    "type": "BIC",
    "active": true
  }
}

​
错误处理

​
缺少 BIC 参数

请求： 
GET https://bankvalidation.cleariflow.com/v1/bic/?api_key=YOUR_API_KEY
响应： 
{
  "error": {
    "message": "Missing bic",
    "code": "missing_bic"
  }
}

​
缺少 API 密钥

请求： 
GET https://bankvalidation.cleariflow.com/v1/bic/?bic=DEUTDEFF500
响应： 
{
  "error": {
    "message": "API key is required",
    "code": "missing_api_key"
  }
}

​
BIC 结构

BIC 由多个部分组成：
  1. 银行代码（4 个字符）：金融机构的唯一标识符
  2. 国家代码（2 个字符）：ISO 3166-1 alpha-2 国家代码
  3. 位置代码（2 个字符）：城市或地区标识符
  4. 分行代码（3 个字符）：可选分行标识符（主办公室为 XXX）

​
格式示例

  • 8 字符 BIC：DEUTDEFF（德意志银行，德国，法兰克福）
  • 11 字符 BIC：DEUTDEFF500（德意志银行，德国，法兰克福，分行 500）

​
常用位置代码

  • FF：德国法兰克福
  • 33：美国纽约
  • 2L：英国伦敦
  • PP：法国巴黎
  • MM：意大利米兰

​
验证规则

API 执行全面验证，包括：
  1. 长度验证：检查 BIC 是否为 8 或 11 个字符
  2. 格式验证：验证 BIC 是否符合 ISO 9362 标准
  3. 字符验证：确保仅使用字母数字字符
  4. 国家代码验证：验证国家代码格式
  5. 银行代码验证：检查银行标识符格式

​
BIC 格式要求

  • 银行代码：4 个字母数字字符
  • 国家代码：2 个字母字符 (ISO 3166-1)
  • 位置代码：2 个字母数字字符
  • 分行代码：3 个字母数字字符（可选）

​
BIC 与 SWIFT

BIC（业务标识码）和 SWIFT 经常互换使用：
  • BIC：官方 ISO 9362 标准名称
  • SWIFT：推广该代码的报文网络
  • SWIFT Code：BIC 的替代名称
所有 BIC 均可用于 SWIFT 报文，但并非所有 SWIFT 代码都是有效的 BIC。

​
支持的国家

API 支持 50 多个国家的 BIC 验证，包括：
  • 欧洲：德国、法国、意大利、西班牙、荷兰、比利时、奥地利、瑞士、英国、波兰
  • 美洲：美国、加拿大、巴西、墨西哥
  • 亚洲：日本、新加坡、香港、澳大利亚
  • 非洲：南非、埃及、尼日利亚
完整支持国家列表，请参阅支持的国家页面。

​
使用场景

BIC 验证对于以下场景至关重要：
  1. 国际电汇：确保准确的路由信息
  2. SEPA 支付：欧洲支付系统要求
  3. 银行应用：客户账户验证
  4. 金融合规：监管报告要求
  5. 支付处理：电商和金融科技应用