Справочник банков, получение информации о банке по БИК, API БИК

Актуализировано 01.11.2024

При указании БИК банка многие современные программы автоматически подставляют недостающие данные: коррсчет, наименование банка, город. Берут они их из единого справочника банков (кредитных организаций). Но для этого ежедневно скачивают мегабайты, ради заполнения одной-двух организаций.

Этот сервис позволяет Вам автоматически заполнять данные по банку.



Здесь будет результат запроса
Осталось 20 бесплатных запросов до 10:34:24 11.11.24

Формат API-запросов

https://htmlweb.ru/api/service/bic/043469751?api_key=API_KEY_из_профиля - получить информацию о банке в html формате, удобно для вывода в DIV-блок

https://htmlweb.ru/json/service/bic/043469751?api_key=API_KEY_из_профиля - получить информацию о банке в json формате, удобно для заполнения INPUT-полей
Для Вашего удобства поддерживается формат JSONP. Вы можете добавить параметр &jsonp=ИМЯ_ФУНКЦИИ:
<script type="application/javascript"
src="https://htmlweb.ru/json/service/bic/043469751?jsonp=parseResponse"></script>
будет возвращен следующий код:

parseResponse({"status":200,"name":"АО КБ \"МОДУЛЬБАНК\"","city":"г.Кострома","address":"Октябрьская пл, 1","bic":"043469751","ks":"30101810800000000751","tel":"(4942)394900,394910","upd":"17.10.2019","post":156005,"urls":"","date0":"09.07.2009","limit":19});

https://htmlweb.ru/xml/service/bic/043469751 - получить информацию о банке в xml формате, удобно для обращения из PHP

По умолчанию все данные возвращаются в кодировке utf-8, Для получения в любой другой кодировке передайте её в дополнительном, необязательном параметре charset: &charset=windows-1251 или любой из ISO-8859-1, ISO-8859-15, UTF-8, cp866, cp1251, cp1252, and KOI8-R

Параметры можно передавать как GET, так и POST - запросом.

Запрос можно отправлять как по протоколу http: так и по https:

Если Вам необходимо по БИК узнать только название банка Вы можете воспользоваться бесплатным сервисом от Центробанка РФ: https://www.cbr.ru/scripts/XML_bic.asp?bic=044525201
Результат:

<BicCode name="BIC CODES">
    <Record ID="1" DU="09.06.1994">
        <ShortName>АВАНГАРД</ShortName>
        <Bic>044525201</Bic>
    </Record>
</BicCode>
Учтите, что для банков, у которых отозвана лицензия ответ будет таким же!

Поля передаваемые в ответе на API-запрос:

ПолеЗначение
nameНаименование банка
cityГород банка
addressАдрес
bicБИК банка
ksКорреспондентский счет банка
telТелефоны банка
regnumРег.номер банка
urlsСайты банка
date0Дата создания банка
statusСтатус 0-Ок, 1-отозвана, 2-аннулирована, 3-в процессе регистрации
ogrnОГРН по единному классификатору юр.лиц, 13 цифр
limitОсталось запросов в сутки

Сервис бесплатный, но имеет ограничение на количество запросов в сутки с одного IP-адреса или одного API-ключа. Если Вы планируете большое количество запросов - воспользуйтесь Off-line справочником банков или платным тарифом. Ограничения на бесплатные запросы и тарификация описана здесь.

Общие параметры для всех API сервисов
Другие сервисы, доступные по API
Стоимость API запроса и тарифы

Пример заполнения данных банка по БИК

После ввода поля БИК автоматически заполнятся остальные поля







Исходный код примера

Данный пример работает во всех современных браузерах на чистом HTML + Javascript и не использует никаких библиотек.

<form action="" onsubmit="return false;">
    <label>БИК: <input type="text" size="9" required pattern="[0-9]{9}" name="bic" onblur="onBank(this);">
        <span id='error' class='red'></span>
    </label><br>
    <label>Банк: <input type="text" size="64" name="name"></label><br>
    <label>Город: <input type="text" size="64" name="city"></label><br>
    <label>Адрес: <input type="text" size="64" name="adress"></label><br>
    <label>К/c: <input type="text" size="20" pattern="[0-9]{20}" name="ks"></label>
</form>
<script>
    function onBank(t) {
        if (t.value.length == 9) {
            // очищаем форму и ошибки
            document.getElementById('error').innerHTML = '';
            t.form.name.value='';
            t.form.city.value='';
            t.form.address.value='';
            t.form.ks.value='';
            // отправляем запрос на сервер и обрабатываем результат
            // сайт с которого будете вызывать укажите в https://htmlweb.ru/user/#allowDomain
            fetch('https://htmlweb.ru/json/service/bic/' + t.value+'?api_key=0')
                .then(
                    function(data){ // обрабатываем ответ от сервера
                        if (data.status !== 200) {
                            return Promise.reject(new Error(data.statusText));
                        }
                        return data.json(); // раскодируем json в объект
                    })
                .then(
                    function(data){
                        console.log('data:',data);
                        var o;
                        for(var key in data) {
                            // заполняю поля формы по name или по id
                            if (key in t.form) t.form[key].value = data[key];
                            else {
                                o = document.getElementById(key);
                                if (o)o.innerHTML = data[key]
                            }
                        }
                    })
                .catch(
                    function(error) {
                        console.error(error)
                    });
        } else{
            document.getElementById('error').innerHTML = 'Неверный БИК';
        }
    }
</script>

Вы можете обращаться как по протоколу http:// так и по протоколу https://

Наиболее популярное использование системы - это заполнение полей платежного поручения или заполнение данных карточки организации. Сервис облегчает работу, исключает ошибки и экономит время.

Где взять справочник банков?

Самый актуальный справочник банков в формате xml можно найти по этой ссылке на сайте ЦБР: http://www.cbr.ru/banking_sector/credit/FullCoList/

Скачать актуальную версию справочника банков РФ

Если Вы не хотите заморачиваться с перекодированием и слиянием из разных источников, Вы можете за 199 рублей скачать справочник банков содержащий 3734 записей:
загрузить справочник банков в формате MySQL
загрузить справочник банков в формате JSON.

Скидка на все обновления в течение года - 80%, если реже - 50%

Или загружать его, используя API-запрос:
https://htmlweb.ru/api/service/bank_download?sql[=ИМЯ_ТАБЛИЦЫ][&charset=windows-1251]
По умолчанию таблица будет называться bank.sql, кодировка utf-8

Структура таблицы:
CREATE TABLE IF NOT EXISTS bank (
    name VARCHAR(512) NOT NULL COMMENT 'Полное наименование',
    post CHAR(6) NOT NULL COMMENT 'Почтовый индекс',
    city VARCHAR(256) NOT NULL COMMENT 'Город',
    address VARCHAR(128) NOT NULL COMMENT 'Адрес',
    bic CHAR(9) NOT NULL UNIQUE COMMENT 'БИК',
    ks  CHAR(20) NOT NULL COMMENT 'к/с',
    tel VARCHAR(128) NOT NULL COMMENT 'Телефоны',
    urls TEXT NOT NULL COMMENT 'Сайты',
    date0 DATE COMMENT 'Создан',
    regnum VARCHAR(64) NOT NULL COMMENT 'Рег.номер',
    ogrn CHAR(13) NOT NULL DEFAULT '' COMMENT 'ОГРН',
	status INT(1) NOT NULL DEFAULT '0' COMMENT 'Статус 0-Ок, 1-отозвана, 2-аннулирована, 3-в процессе регистрации',
    upd DATE COMMENT 'актуальность'
);

Или получить справочник банков через API в формате json, исключив пустые поля: https://htmlweb.ru/json/service/bank_download?no_empty

Банковский идентификационный код

Банковский идентификационный код (сокращенное название БИК) – это уникальный код присваиваемый банку Банком России и служит для проведения платежей на территории Российской Федерации. БИК состоит из 9 цифр: AA BB CC DDD
AA - Код страны (в данном случае код Российской Федерации – 04)
BB - Территориальный код субъекта Российской Федерации по ОКАТО, 45 - Город Москва
CC - Условный номер подразделения расчетной сети Банка России, уникальный в рамках территориального учреждения Банка России, в составе которого действует данное подразделение расчетной сети Банка России, или условный номер структурного подразделения Банка России — принимает цифровые значения от 00 до 99
DDD - Условный номер кредитной организации (всегда соответствуют трем последним цифрам в корреспондентском счёте банка и могут принимать значение от 050 до 999)

Вам может быть интересно:


.