Перевірка IBAN

GET

iban

Перевірка IBAN

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

<?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))

}

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"
  }
}

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

String

обов'язково

Ваш унікальний API-ключ. Зверніть увагу: у кожного користувача є унікальні API-ключі для кожного з API Cleariflow, тому ключ Bank Validation API не працюватиме для Exchange Rates API, наприклад.

String

обов'язково

Міжнародний банківський рахунок (IBAN) для перевірки. Пробіли дозволені та автоматично видаляються. IBAN має відповідати формату ISO 13616.

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

Відповідь API повертається у універсальному та легкому форматі JSON.

String

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

Boolean

Загальний результат перевірки дійсності IBAN згідно з усіма правилами.

String

Дволітерний ISO-код країни (наприклад, DE — Німеччина, FR — Франція).

String

Повна назва країни, пов’язаної з IBAN.

String

Код ідентифікації банку з IBAN відповідно до формату країни.

String

Частина номера рахунку IBAN без коду країни, контрольних цифр і коду банку.

Integer

Фактична довжина наданого IBAN.

Integer

Очікувана довжина IBAN для країни згідно з ISO 13616.

Boolean

Чи пройшла перевірка контрольної суми IBAN за MOD-97.

Boolean

Чи відповідає формат IBAN очікуваній структурі для країни.

Object

Додаткова інформація про структуру та форматування IBAN.

String

Візуальне представлення структури IBAN: B (Bank), S (Sort), C (Customer), K (Key).

String

Приклад IBAN з пробілами для зручності читання.

String

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

String

The BIC code for the bank (currently shows “BIC not available”).

String

Тип рахунку (зазвичай «Bank Account»).

String

Код валюти країни (наприклад, EUR для єврозони, GBP для UK).

Приклади

Дійсний німецький 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 символи - BBBB BBBB BBBB BBBB BB
Франція (FR): 27 символів - BBBB BSSS SSCC CCCC CCCC CCC KK
Італія (IT): 27 символів - CAAA AABB BBSS CCCC CCCC CCX
Велика Британія (GB): 22 символи - BBBB SSSS SSCC CCCC CC
Іспанія (ES): 24 символи - BBBB SSSS DDCC CCCC CCCC CC

Де:

B = код банку
S = sort code
C = номер рахунку клієнта
K = ключ/контрольна цифра
A = тип рахунку
D = контрольна цифра

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

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

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

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

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

Європа: Німеччина, Франція, Італія, Іспанія, Нідерланди, Бельгія, Австрія, Швейцарія, UK, Польща
Азія: ОАЕ, Бахрейн, Ізраїль, Jordan, Казахстан, Кувейт
Америка: Бразилія, Costa Rica, Домініканська Республіка, Гватемала
Африка: Мавританія, Маврикій, Туніс

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

Перевірка IBAN

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

<?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))

}

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

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

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

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

Приклади

Дійсний німецький IBAN

Дійсний французький IBAN

Недійсний IBAN

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

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

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

Структура IBAN

Формати за країнами

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

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

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

​Базовий URL

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

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

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

​Приклади

​Дійсний німецький IBAN

​Дійсний французький IBAN

​Недійсний IBAN

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

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

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

​Структура IBAN

​Формати за країнами

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

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

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

Базовий URL

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

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

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

Приклади

Дійсний німецький IBAN

Дійсний французький IBAN

Недійсний IBAN

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

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

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

Структура IBAN

Формати за країнами

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

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