Проверка IBAN

GET

iban

Проверка IBAN

curl --request GET \
  --url https://bankvalidation.cleariflow.com/v1/iban/

import requests

url = "https://bankvalidation.cleariflow.com/v1/iban/"

response = requests.get(url)

print(response.text)

const options = {method: 'GET'};

fetch('https://bankvalidation.cleariflow.com/v1/iban/', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://bankvalidation.cleariflow.com/v1/iban/",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://bankvalidation.cleariflow.com/v1/iban/"

	req, _ := http.NewRequest("GET", url, nil)

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.get("https://bankvalidation.cleariflow.com/v1/iban/")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://bankvalidation.cleariflow.com/v1/iban/")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)

response = http.request(request)
puts response.read_body

{
  "iban": "DE89370400440532013000",
  "is_valid": true,
  "country_code": "DE",
  "country_name": "Germany",
  "bank_code": "37040044",
  "account_number": "0532013000",
  "length": 22,
  "expected_length": 22,
  "checksum_valid": true,
  "format_valid": true,
  "details": {
    "structure": "BBBB BBBB BBBB BBBB BB",
    "example": "DE89 3704 0044 0532 0130 00",
    "bank_name": "Bank information not available",
    "bank_bic": "BIC not available",
    "account_type": "Bank Account",
    "currency": "EUR"
  }
}

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

Базовый URL

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

Эндпоинт проверки

Эндпоинт iban требует ваш API-ключ и параметр IBAN для комплексной проверки международных банковских счётов.

https://bankvalidation.cleariflow.com/v1/iban/
? api_key = YOUR_UNIQUE_API_KEY
& iban = DE89370400440532013000

Успешный запрос проверяет немецкий IBAN и возвращает подробную информацию:

{
  "iban": "DE89370400440532013000",
  "is_valid": true,
  "country_code": "DE",
  "country_name": "Germany",
  "bank_code": "37040044",
  "account_number": "0532013000",
  "length": 22,
  "expected_length": 22,
  "checksum_valid": true,
  "format_valid": true,
  "details": {
    "structure": "BBBB BBBB BBBB BBBB BB",
    "example": "DE89 3704 0044 0532 0130 00",
    "bank_name": "Bank information not available",
    "bank_bic": "BIC not available",
    "account_type": "Bank Account",
    "currency": "EUR"
  }
}

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

api_key

String

обязательно

Ваш уникальный API-ключ. У каждого пользователя уникальные ключи для каждого API Cleariflow, поэтому ключ Bank Validation не будет работать, например, с API обменных курсов.

iban

String

обязательно

Международный банковский счёт для проверки. Пробелы допустимы и автоматически удаляются при обработке. IBAN должен соответствовать формату стандарта ISO 13616.

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

Ответ API возвращается в универсальном лёгком формате JSON.

iban

String

Нормализованный IBAN без пробелов в верхнем регистре.

is_valid

Boolean

Общий результат проверки — валиден ли IBAN по всем правилам.

country_code

String

Двухбуквенный ISO-код страны (например, DE для Германии, FR для Франции).

country_name

String

Полное название страны, связанной с IBAN.

bank_code

String

Банковский идентификатор, извлечённый из IBAN согласно формату конкретной страны.

account_number

String

Номер счёта в IBAN без кода страны, контрольных цифр и банковского кода.

length

Integer

Фактическая длина переданного IBAN.

expected_length

Integer

Ожидаемая длина IBAN для конкретной страны по стандарту ISO 13616.

checksum_valid

Boolean

Прошла ли проверка контрольной суммы IBAN по алгоритму MOD-97.

format_valid

Boolean

Соответствует ли формат IBAN ожидаемой структуре для страны.

details

Object

Дополнительная подробная информация о структуре и форматировании IBAN.

details.structure

String

Визуальное представление структуры IBAN с плейсхолдерами B (Bank), S (Sort), C (Customer) и K (Key).

details.example

String

Правильно отформатированный пример IBAN с пробелами для читаемости.

details.bank_name

String

Название банка (сейчас отображается «Bank information not available»).

details.bank_bic

String

BIC-код банка (сейчас отображается «BIC not available»).

details.account_type

String

Тип счёта (обычно «Bank Account»).

details.currency

String

Код валюты страны (например, EUR для еврозоны, GBP для Великобритании).

Примеры

Валидный немецкий IBAN

Запрос:

GET https://bankvalidation.cleariflow.com/v1/iban/?api_key=YOUR_API_KEY&iban=DE89370400440532013000

Ответ:

{
  "iban": "DE89370400440532013000",
  "is_valid": true,
  "country_code": "DE",
  "country_name": "Germany",
  "bank_code": "37040044",
  "account_number": "0532013000",
  "length": 22,
  "expected_length": 22,
  "checksum_valid": true,
  "format_valid": true,
  "details": {
    "structure": "BBBB BBBB BBBB BBBB BB",
    "example": "DE89 3704 0044 0532 0130 00",
    "bank_name": "Bank information not available",
    "bank_bic": "BIC not available",
    "account_type": "Bank Account",
    "currency": "EUR"
  }
}

Валидный французский IBAN

Запрос:

GET https://bankvalidation.cleariflow.com/v1/iban/?api_key=YOUR_API_KEY&iban=FR1420041010050500013M02606

Ответ:

{
  "iban": "FR1420041010050500013M02606",
  "is_valid": true,
  "country_code": "FR",
  "country_name": "France",
  "bank_code": "2004101005",
  "account_number": "0500013M02606",
  "length": 27,
  "expected_length": 27,
  "checksum_valid": true,
  "format_valid": true,
  "details": {
    "structure": "BBBB BSSS SSCC CCCC CCCC CCC KK",
    "example": "FR14 2004 1010 0505 0001 3M02 606",
    "bank_name": "Bank information not available",
    "bank_bic": "BIC not available",
    "account_type": "Bank Account",
    "currency": "EUR"
  }
}

Невалидный IBAN

Запрос:

GET https://bankvalidation.cleariflow.com/v1/iban/?api_key=YOUR_API_KEY&iban=INVALID

Ответ:

{
  "iban": "",
  "is_valid": false,
  "country_code": "",
  "country_name": "",
  "bank_code": "",
  "account_number": "",
  "length": 7,
  "expected_length": 0,
  "checksum_valid": false,
  "format_valid": false,
  "details": {
    "structure": "",
    "example": ""
  }
}

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

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

Запрос:

GET https://bankvalidation.cleariflow.com/v1/iban/?api_key=YOUR_API_KEY

Ответ:

{
  "error": {
    "message": "Missing iban",
    "code": "missing_iban"
  }
}

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

Запрос:

GET https://bankvalidation.cleariflow.com/v1/iban/?iban=DE89370400440532013000

Ответ:

{
  "error": {
    "message": "API key is required",
    "code": "missing_api_key"
  }
}

Структура IBAN

IBAN состоит из нескольких компонентов:

Код страны (2 символа): ISO 3166-1 alpha-2 код страны
Контрольные цифры (2 символа): проверка по алгоритму MOD-97
Банковский идентификатор: банковский код, специфичный для страны
Номер счёта: идентификатор счёта клиента

Форматы по странам

В разных странах структура IBAN различается:

Германия (DE): 22 characters - BBBB BBBB BBBB BBBB BB
Франция (FR): 27 characters - BBBB BSSS SSCC CCCC CCCC CCC KK
Италия (IT): 27 characters - CAAA AABB BBSS CCCC CCCC CCX
Великобритания (GB): 22 characters - BBBB SSSS SSCC CCCC CC
Испания (ES): 24 characters - BBBB SSSS DDCC CCCC CCCC CC

Где:

B = банковский код
S = код сортировки
C = номер счёта клиента
K = ключевая/контрольная цифра
A = тип счёта
D = контрольная цифра

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

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

Проверка формата: соответствует ли IBAN ожидаемой структуре для страны
Проверка длины: соответствует ли длина IBAN стандарту страны
Проверка контрольной суммы: валидация по алгоритму MOD-97
Проверка кода страны: поддерживается ли код страны
Проверка символов: допустимые буквенно-цифровые символы

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

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

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

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

Проверка BICЭндпоинт `bic` проверяет банковские идентификационные коды, предоставляя детальную разбивку банковских кодов, информации о стране и типах учреждений для международных банковских операций.

Проверка IBAN

curl --request GET \
  --url https://bankvalidation.cleariflow.com/v1/iban/

import requests

url = "https://bankvalidation.cleariflow.com/v1/iban/"

response = requests.get(url)

print(response.text)

const options = {method: 'GET'};

fetch('https://bankvalidation.cleariflow.com/v1/iban/', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://bankvalidation.cleariflow.com/v1/iban/",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://bankvalidation.cleariflow.com/v1/iban/"

	req, _ := http.NewRequest("GET", url, nil)

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.get("https://bankvalidation.cleariflow.com/v1/iban/")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://bankvalidation.cleariflow.com/v1/iban/")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)

response = http.request(request)
puts response.read_body

{
  "iban": "DE89370400440532013000",
  "is_valid": true,
  "country_code": "DE",
  "country_name": "Germany",
  "bank_code": "37040044",
  "account_number": "0532013000",
  "length": 22,
  "expected_length": 22,
  "checksum_valid": true,
  "format_valid": true,
  "details": {
    "structure": "BBBB BBBB BBBB BBBB BB",
    "example": "DE89 3704 0044 0532 0130 00",
    "bank_name": "Bank information not available",
    "bank_bic": "BIC not available",
    "account_type": "Bank Account",
    "currency": "EUR"
  }
}