↑ Как подключить подсказки

Подсказки: банки

Ищет кредитные организации:

  • по БИК,
  • SWIFT,
  • ИНН,
  • ИНН + КПП,
  • названию,
  • адресу до улицы.

Как подключить

  1. Зарегистрируйтесь и получите API-ключ
  2. Вставьте код из примера на свой сайт.
  3. Profit!
<input id="bank" name="bank" type="text" />
<script src="https://cdnjs.cloudflare.com/ajax/libs/jquery/3.3.1/jquery.min.js"></script>
<link href="https://cdn.jsdelivr.net/npm/suggestions-jquery@20.3.0/dist/css/suggestions.min.css" rel="stylesheet" />
<script src="https://cdn.jsdelivr.net/npm/suggestions-jquery@20.3.0/dist/js/jquery.suggestions.min.js"></script>

<script>
    $("#bank").suggestions({
        token: "${API_KEY}",
        type: "BANK",
        /* Вызывается, когда пользователь выбирает одну из подсказок */
        onSelect: function(suggestion) {
            console.log(suggestion);
        }
    });
</script>

Параметр token — это API-ключ.

Демонстрация

Выберите вариант из списка, чтобы увидеть полный текст ответа в JSON:

Также работает через API

Что в ответе

Аргумент suggestion функции onSelect выглядит так:

НазваниеОписание
valueНаименование банка
unrestricted_value= value
data.bicБанковский идентификационный код (БИК) ЦБ РФ
data.swiftБанковский идентификационный код в системе SWIFT
data.innИНН
data.kppКПП
data.registration_numberРегистрационный номер в ЦБ РФ
data.correspondent_accountКорреспондентский счет в ЦБ РФ
data.name Наименование
└ payment — платежное наименование
└ full — не заполняется
└ short — краткое наименование
data.payment_cityГород для платежного поручения (поля справочника Tnp + Nnp).
data.opf Тип кредитной организации
└ type — код типа:
  BANK        — банк
  BANK_BRANCH — филиал банка
  NKO         — небанковская кредитная организация (НКО)
  NKO_BRANCH  — филиал НКО
  RKC         — расчетно-кассовый центр
  OTHER       — другой
└ full — не заполняется
└ short — не заполняется
data.address Адрес регистрации
└ value — адрес одной строкой
стандартизован, поэтому может отличаться от записанного в справочнике БИК.
└ unrestricted_value — адрес одной строкой (полный, с индексом)
стандартизован, поэтому может отличаться от записанного в справочнике БИК.
└ data — гранулярный адрес
└ data.source — адрес одной строкой как в справочнике БИК
└ data.qc — код проверки адреса
  0        — адрес распознан уверенно
  1 или 3  — требуется ручная проверка
data.state Состояние
└ actuality_date — дата актуальности сведений
└ registration_date — дата регистрации
└ liquidation_date — дата ликвидации
└ status — статус организации
  ACTIVE      — действующая
  LIQUIDATING — ликвидируется
  LIQUIDATED  — ликвидирована
data.okpoНе заполняется
data.phoneНе заполняется
data.rkcНе заполняется

Источники данных:

Ограничения

На бесплатном тарифе плагин подсказок показывает логотип «Дадаты» в углу выпадающего списка. На платных тарифах и в «коробке» логотипа нет.

Количество запросов в день — в соответствии с тарифным планом.

Длина запроса — не более 300 символов.

Количество условий (параметр locations) — не более 10.

Частые вопросы

Как разложить информацию о банке по полям? Наименование, БИК, SWIFT, адрес?

Пример: разложить банк по полям

Почему не находится банк? Я точно знаю, он должен быть

Скорее всего, он ликвидирован. «Дадата» не подсказывает большинство ликвидированных банков, потому что их нет в справочнике Банка России.

Как часто обновляется справочник банков?

Каждый день. Мы берем его с сайта Банка России.


Подсказки не работают: ошибка 403 Forbidden (Feature SUGGESTIONS disabled for token)

Возможные причины:

  • Не подтверждён адрес эл. почты. Проверьте почтовый ящик и папку «спам» — там должно быть письмо от «Дадаты».
  • В запросе указан неправильный API-ключ. Проверьте в личном кабинете
  • Исчерпан лимит запросов на день. Проверьте в личном кабинете
  • Вы делаете запросы с сервера, при этом настроена привязка к домену. Отключите привязку к домену, либо делайте запросы из браузера.
Что будет, если превысить 10 000 бесплатных запросов в день?

Подсказки перестанут подсказывать ツ До начала нового дня, затем снова заработают.

10 000 запросов считаются суммарно по всем видам подсказок: адреса, ФИО, организации, банки, емейлы...

Как защитить API-ключ от злоумышленников?

Если вы используете jQuery-плагин Подсказок, то API-ключ виден в исходном коде страниц вашего сайта. Чтобы злоумышленник не мог воспользоваться вашим ключом, можно привязать его к конкретному домену.

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

Привязка API-ключа к домену настраивается в личном кабинете.

Стоимость

Бесплатно до 10 тысяч запросов в день. Больше — в составе годовой подписки.

ajax-spinner

Зарегистрируйтесь, чтобы подключить подсказки

до 10 тыс. запросов в день — бесплатно

чтобы обращаться к вам в письмах

Регистрируясь, вы принимаете публичную оферту

Уже зарегистрированы? Войти