Перевірка 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-ключі для кожного з API Cleariflow, тому ключ Bank Validation API не працюватиме для Exchange Rates API, наприклад.

bic

String

обов'язково

BIC для перевірки. Пробіли дозволені та автоматично видаляються. 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

The name of the bank (currently shows “Bank information not available”).

location_code

String

2-символьний код локації — місто або регіон (наприклад, FF — Frankfurt).

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, Німеччина, Frankfurt)
11-символьний BIC: DEUTDEFF500 (Deutsche Bank, Німеччина, Frankfurt, відділення 500)

Поширені коди локацій

FF: Frankfurt, Німеччина
33: Нью-Йорк, США
2L: Лондон, Велика Британія
PP: Париж, Франція
MM: Мілан, Італія

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

API виконує комплексну перевірку:

Перевірка довжини: чи BIC має 8 або 11 символів
Перевірка формату: чи BIC відповідає ISO 9362
Перевірка символів: лише буквено-цифрові символи
Перевірка коду країни: формат коду країни
Перевірка коду банку: формат ідентифікатора банку

Вимоги до формату BIC

Код банку: 4 буквено-цифрові символи
Код країни: 2 літери (ISO 3166-1)
Код локації: 2 буквено-цифрові символи
Код відділення: 3 буквено-цифрові символи (необов’язково)

BIC vs SWIFT

BIC (Business Identifier Code) і SWIFT часто використовують як синоніми:

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

Усі BIC можна використовувати для SWIFT, але не всі SWIFT-коди є дійсними BIC.

Підтримувані країни

API підтримує перевірку BIC для 50+ країн, включаючи:

Європа: Німеччина, Франція, Італія, Іспанія, Нідерланди, Бельгія, Австрія, Швейцарія, UK, Польща
Америка: США, Канада, Бразилія, Мексика
Азія: Японія, Сінгапур, Гонконг, Австралія
Африка: ПАР, Єгипет, Нігерія

Повний список — на сторінці Підтримувані країни.

Сценарії використання

Перевірка 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 vs SWIFT

​Підтримувані країни

​Сценарії використання

Початок роботи

Базовий URL

Ендпоінт перевірки

Параметри запиту

Параметри відповіді

Приклади

Дійсний німецький BIC (8 символів)

Дійсний німецький BIC (11 символів з відділенням)

Дійсний BIC США

Дійсний BIC Великої Британії

Недійсний BIC

Обробка помилок

Відсутній параметр BIC

Відсутній API-ключ

Структура BIC

Приклади форматів

Поширені коди локацій

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

Вимоги до формату BIC

BIC vs SWIFT

Підтримувані країни

Сценарії використання