Проверка BIC - Cleariflow API

GET

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-ключ. У каждого пользователя уникальные ключи для каждого API Cleariflow, поэтому ключ Bank Validation не будет работать, например, с 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 для Deutsche Bank).

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 состоит из нескольких компонентов:

Банковский код (4 символа): уникальный идентификатор финансового учреждения
Код страны (2 символа): ISO 3166-1 alpha-2 код страны
Код местоположения (2 символа): идентификатор города или региона
Код филиала (3 символа): необязательный идентификатор филиала (XXX для головного офиса)

Примеры форматов

8-символьный BIC: DEUTDEFF (Deutsche Bank, Германия, Франкфурт)
11-символьный BIC: DEUTDEFF500 (Deutsche Bank, Германия, Франкфурт, филиал 500)

Распространённые коды местоположения

FF: Франкфурт, Германия
33: Нью-Йорк, США
2L: Лондон, Великобритания
PP: Париж, Франция
MM: Милан, Италия

Правила проверки

API выполняет комплексную проверку, включая:

Проверка длины: BIC содержит 8 или 11 символов
Проверка формата: BIC соответствует стандарту ISO 9362
Проверка символов: только буквенно-цифровые символы
Проверка кода страны: валидация формата кода страны
Проверка банковского кода: формат банковского идентификатора

Требования к формату BIC

Банковский код: 4 буквенно-цифровых символа
Код страны: 2 буквенных символа (ISO 3166-1)
Код местоположения: 2 буквенно-цифровых символа
Код филиала: 3 буквенно-цифровых символа (необязательно)

BIC и SWIFT

BIC (Business Identifier Code) и SWIFT часто используются как синонимы:

BIC: официальное название по стандарту ISO 9362
SWIFT: сеть обмена сообщениями, популяризировавшая код
SWIFT Code: альтернативное название BIC

Все BIC можно использовать для SWIFT-сообщений, но не все SWIFT-коды являются валидными BIC.

Поддерживаемые страны

API поддерживает проверку BIC для 50+ стран, включая:

Европа: Германия, Франция, Италия, Испания, Нидерланды, Бельгия, Австрия, Швейцария, Великобритания, Польша
Америка: США, Канада, Бразилия, Мексика
Азия: Япония, Сингапур, Гонконг, Австралия
Африка: ЮАР, Египет, Нигерия

Полный список поддерживаемых стран см. на странице Поддерживаемые страны.

Сценарии использования

Проверка BIC необходима для:

Международные переводы: точная маршрутизация
Платежи SEPA: требования европейской платёжной системы
Банковские приложения: проверка счетов клиентов
Финансовое соответствие: требования регуляторной отчётности
Обработка платежей: e-commerce и fintech-приложения

Поддерживаемые страныПолный список поддерживаемых стран для проверки IBAN и 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

​Эндпоинт

​Параметры запроса

​Параметры ответа

​Примеры

​Валидный немецкий BIC (8 символов)

​Валидный немецкий BIC (11 символов с филиалом)

​Валидный BIC США

​Валидный BIC Великобритании

​Невалидный BIC

​Обработка ошибок

​Отсутствует параметр BIC

​Отсутствует API-ключ

​Структура BIC

​Примеры форматов

​Распространённые коды местоположения

​Правила проверки

​Требования к формату BIC

​BIC и SWIFT

​Поддерживаемые страны

​Сценарии использования

Начало работы

Базовый URL

Эндпоинт

Параметры запроса

Параметры ответа

Примеры

Валидный немецкий BIC (8 символов)

Валидный немецкий BIC (11 символов с филиалом)

Валидный BIC США

Валидный BIC Великобритании

Невалидный BIC

Обработка ошибок

Отсутствует параметр BIC

Отсутствует API-ключ

Структура BIC

Примеры форматов

Распространённые коды местоположения

Правила проверки

Требования к формату BIC

BIC и SWIFT

Поддерживаемые страны

Сценарии использования