Перевірка номеру IBAN на помилки
Перевірка IBAN номерів на помилки
Перевірка IBAN надає безкоштовну демо версію нашої послуги Комплект IBAN.
Інтегруйте наш Комплект IBAN на ваш власний ERP,CMR,service або програмне забезпечення.
Для отримання додаткової інформації про інтеграцію наших послуг, будь ласка, відвідайте Центр Розробників. Перегляньте більше інформації про Плани і Ціни
Перевірка IBAN (Міжнародний номер банківського рахунку) через контрольні цифри використовується як ефективний спосіб зменшення невдалих операцій при обробці міжнародних та внутрішніх платежів.
Крім того, наша система може визначити ідентифікаційний код банку (BIC) для відповідного банку та відділення. Перевіряючи правильний код BIC у поєднанні з дійсним IBAN, ви можете забезпечити ефективну маршрутизацію платежу банку одержувача.
Перевірка IBAN, яку ви бачите на цій сторінці, використовує той самий функціонал, що й наш корпоративний сервіс. Він може перевіряти номер IBAN, перевіряючи всі елементи, такі як код банку, код відділення, номер рахунку та певні цифри перевірки для кожної країни.
Ви можете переглянути підтримувані країни і скористатися прикладами для перевірки служби.
Окрім того, будь ласка, відвідайте розділ нашої точності даних , щоб дізнатися більше про якість наших даних та методи інформаційної безпеки.
Якщо ви не знаєте Міжнародного номера банківського рахунку (IBAN), ви можете розрахувати IBAN з банківського коду та номера рахунку.
Більш детальну інформацію про процес перевірки та виконані кроки можна знайти нижче
Щоб повідомити про відсутню / неправильну інформацію: Натисніть кнопку з оранжевим знаком оклику у верхньому правому куті таблиці з результатами.
Контрольна сума IBAN
Це перша та найважливіша перевірка, яку ми виконуємо.Контрольна цифра IBAN складається з двох цифр у положеннях 3 і 4 у номері IBAN.
Він обчислюється за допомогою алгоритму MOD97 і забезпечує первинну перевірку цілісності стандарту IBAN.
Підтримується для всіх 116 країн.
Якщо цю перевірку не пройдено, ми не проводимо жодних подальших тестів, оскільки IBAN визначено недійсним.
Країни підтримки IBAN
Наша система автоматично визначить, чи відповідає номер Міжнародного банківського рахунку округу країні, яка не використовує формат IBAN.У цьому випадку він сповістить вас про те, що країна не підтримує IBAN.
Перевірка довжини номеру IBAN
Перевірка специфічної довжини IBAN для стандартів кожної країни є третім рівнем перевірки, яку ми виконуємо.Кожна з 116 країн у нашому внутрішньому реєстрі має свою власну довжину номеру.
Можливі відповіді:
Довжина IBAN є правильною для Великобританії
***Назва країни*** IBAN має бути довжиною у ** N ** символів
Якщо IBAN довше або коротше цієї довжини, її слід вважати неправильною.
Перевірте контрольну суму рахунку (у BBAN)
Кожен IBAN містить номер місцевого банківського рахунку, який також називається BBAN ( Basic Bank Account Number).Кожна країна використовує різні алгоритми і в деяких країнах алгоритми варіюються від банку до банку або навіть до окремих галузей.
Наприклад:
- Сполучене Королівство (UK) використовує 3 різні алгоритми: MOD10 , MOD11 та DBLAL з 39 різними значеннями. Це складає більше 100 різних варіацій
- Нідерланди (NL) використовують алгоритм MOD11 зі спеціальними значеннями для перевірки номерів рахунків. Франція (FR) використовує алгоритм MOD97 із власними значеннями
- Німеччина (DE) має складну структуру з 143 алгоритмами та нестандартними значеннями: MOD10, MOD11, MOD7 тощо.
- Італія (IT) використовує модифікований алгоритм MOD10 у перевірці номерів внутрішнього рахунку
- Швеція (SE) використовує 5 різних алгоритмів: MOD11, MOD10 алгоритми із власними значеннями
Як тільки ми визначимо та виконаємо відповідну перевірку, наша система поверне один з наступних результатів:
Контрольна сума номера рахунку дійсна — Номер рахунку можна вважати дійсним.
Контрольна сума номера рахунку неправильна — Номер рахунку недійсний. Ви можете здогадатися, що IBAN також недійсний.
Номер рахунку не підтримує перевірку контрольної суми
На даний момент в цілому 48 країн підтримують перевірку цифр BBAN і номер внутрішнього рахунку.
Формат і структура IBAN
Друга перевірка, яку ми виконуємо, — це перевірка структури IBAN в конкретній країні.Ми знаємо внутрішні правила кожної країни для конкретних позицій і символів у межах IBAN.
Ця перевірка є корисною, якщо країна не підтримує перевірку ідентифікаційного номера внутрішнього рахунку.
Можливі результати для цієї перевірки:
Формат і структура IBAN правильні!
Форматування
Наш механізм перевірки може визнати конкретний формат 116 країн, які використовують IBAN.
Перевірка формату враховує:
- позиція коду банку — Перевіряє, чи стоїть ідентифікатор банку на правильному місці
- позиція ідентифікатора відділення — Не всі країни мають код відділень. Ми проводимо цю перевірку у 58 країнах.
- позиція національної контрольної цифри — Ця перевірка виконується лише для країн, що підтримують внутрішню контрольну цифру. (48 countries)
Структура
Перевірка структури порівнює специфічні символи, що використовуються в різних частинах IBAN.
Перевірка структури враховує:
- код банку містить буквені, цифрові або буквено-цифрові значення
- код банку містить буквені, цифрові або буквено-цифрові значення
- код ідентифікатора відділення (якщо доступний) містить буквені, цифрові або буквено-цифрові значення
- національна контрольна цифра (якщо така є) містить буквені, цифрові або буквено-цифрові значення
IBAN — Политика конфиденциальности
На данной странице представлена Политика Конфиденциальности, которая применяется ко всем товарам и услугам, представленным на сайте www.iban.com.Подписка на услуги
Личная информация, предоставленная во время регистрации для использования товаров или услуг, используется для управления вашей подпиской, и позволяет повысить качество обслуживания, а также гарантировать четкое выполнение правил и норм использования сайта www.iban.com.Беслатный доступ и ознакомительная версия
Все данные (международный банковский номер счета, номер счета, код банка и др.), отправленные с использованием сайта (Проверка IBAN, Калькулятор IBAN, Поиска по коду банка и др.) может храниться в защищенном месте для использования в качестве статистических данных, а также для проведения анализа эффективности.Контактная информация
Контактная информация, полученная во время регистрации (ваше имя, должность, номер телефона, номер факса, а также электронный и почтовый адрес), будет использована только для направления информации о товарах и услугах, к которым вы проявили интерес, а также об изменении выбранного вами варианта подписки или функционала системы.Контактная информация может быть использована нашей компанией и нашими доверенными лицами для предоставления информации, которая может вызвать у вас интерес. Мы оставляем за собой право на передачу вашей информации третьим лицам для выполнения аналогичных действий. Если вы не хотите получать подобную информацию, вы можете изменить настройки в вашем личном кабинете.
Cookies
Cookies — небольшие текстовые файлы, которые сохраняются на вашем компьютере после посещения сайтов. Cookies активно используются по всему миру для повышения эффективности работы сайта, а также для получения статистической информации. Сайт www.iban.com использует Cookies для обеспечения правильного функционирования сайт. Кроме того, мы сотрудничаем с рекламодателями, которые используют Cookies для таргетированной рекламы во время посещения сайта.Практически любой браузер позволяет управлять файлами Cookies. Для того чтобы получить более подробную информацию о Cookies, пожалуйста, посетите www.allaboutcookies.org.
Более подробная информация о Cookies, которые используются на сайте www.iban.com, представлена ниже. На нашем сайте используются следующие категории Cookies, определенные правилами использования Cookies Международной Торговой Палаты:
Категория 1: Обязательные Cookies.
Данные Cookies являются необходимыми для получения услуг в рамках нашей платформы. Cookies 1 категории на сайте www.iban.com
Идентификатор сессии пользователя: файл, в котором хранится информация о текущей сессии пользователя. Кроме того, в данном файле хранится информация о предпочтениях пользователя.
Данные пользователя: информация о компании, подразделении и стране проживания пользователя в зашифрованном формате, которая используется для проведения анализа в компании Omniture. Посещая наш сайт, вы можете отказаться от использования следующих видов Cookies:
Страница отказа от аналитики Google
Страница отказа от AddThis
Категория 2: Таргетированная реклама.
Данные Cookies используются для показа рекламы, которая может заинтересовать вас. Кроме того, они позволяют ограничить количество показов рекламы, а также оценить общую эффективность рекламной кампании. Такие Cookies размещаются рекламными сетями с разрешения владельца сайта. Данные Cookies позволяют сохранить информацию о вашем визите, и передать ее в другие рекламные сети.
Таргетированная реклама: такие Cookies используются третьими лицами для размещения рекламы, которая может заинтересовать вас. На сайте www.iban.com используются Cookies следующих рекламных сетей:
Doubleclick (Google)
Вы можете отказать от использования данных Cookies, посетив сайт:
Страница отказа от рекламы Google
Отслеживание кампании: данные Cookies позволяют отслеживать эффективность рекламных кампаний, рассылок и новостных писем. Добровольное предоставление информации В рамках вашего участия в опросах, конкурсах и акциях, мы можем запросить у вас дополнительную информацию, которая позволит повысить качество наших услуг. Такая информация может быть передана третьим лицам в соответствии с правилами проведения той или иной акции.
Статистическая информация Обезличенная статистическая информация, которая позволяет оценить общую эффективность рекламных инструментов.
Доступ к данным В соответствии с Законом о защите личных данных Великобритании от 1988 года, граждане ЕС имеют право на получение информации о том, какие данные хранятся на серверах нашей компании. Для получения такой информации, вам необходимо направить запрос по следующему адресу: Veriban Limited of 9 Harcourt Close, Isleworth, Middlesex, TW7 6DD, UK, указав ваше полное имя, ваш адрес, а также информацию о товарах и услугах, которые вы используете на сайте www.iban.com. Компания оставляет за собой право на получение небольшого административного сбора за выполнение данной операции.
Звонки Мы оставляем право на запись и мониторинг всех телефонных вызовов на номера нашей компании.
Проверка расчетного счета и платежных реквизитов
Валидация и проверка контрольного числа расчетного счета/корреспондентского счета. Код банка (БИК),Филиал,Номер счета и Контрольный ключ.
| 408 | 02 | 810 | 0 | 6458 | 000000 |
| 1 | 2 | 3 | 4 | 5 | 6 |
Номер балансового счёта первого порядка
Например, 408- это «Прочие счета»
Номер балансового счёта второго порядка
Например, 40802 — это «Физические лица — индивидуальные предприниматели»
Код валюты по Общероссийскому классификатору валют (ОКВ)
Например, 810- это «Российский рубль RUB»
Контрольная цифра
Рассчитывается по специальному алгоритму
Код подразделения банка
Внутренний номер филиалов банка, не имеет отношения к БИК (банковскому идентификационному коду)
Внутренний номер лицевого счета клиента в банке
Уникальная запись в рамках подразделения банка
Валидация и проверка контрольного числа в расчетном счете
Давайте начнем с того, что разберемся, зачем вообще проверять правильность расчетного счета и БИК. Прежде всего, использование подобных систем позволяет избежать ошибок, которые могут быть допущены при вводе банковских реквизитов. К тому же, если у вас отсутствуют некоторые символы, или вы не можете быть уверены в том, что тот или иной символ является правильным, вы можете использовать валидацию расчетного счета для восстановления отсутствующих цифр в банковских реквизитах.
Стоит отметить, что проверка счета основана на принципе использования так называемого «защитного ключа», который представляет собой специальный символ, расположенный на 9 позиции 20-значного номера банковского счета. Изначально, данный ключ был создан для проверки правильности введенного вручную номера банковского счета. Обратите внимание, что данный ключ не позволяет со 100% уверенностью говорить о существовании введенного номера счета, указывая лишь на правильность его номера. Однако, такая проверка является первым звеном многоуровневой системы проверки правильности номера банковского счета.
Обратите внимание, что как для проверки расчетного, так и для проверки корреспондентского счета необходимо использовать БИК. В первом случае необходимо применять 7, 8 и 9 цифру БИК, а во втором – 5 и 6. Другими словами, каждый раз, когда вы запускаете проверку банковских реквизитов, номера счетов и БИК рассматриваются в комплексе, а не как отдельные элементы. Обратите внимание, что первые четыре цифры не используются в ходе такой проверки, и не влияют на правильность номера расчетного или корреспондентского счета. Для того чтобы начать проверку, вам необходимо указать БИК, длина которого составляет 9 символов, а также номера расчетного и корреспондентского счетов, каждый из которых включает в себя по 20 символов. Если вы не знаете одну из цифр БИК или номера счета, вы можете использовать символ «-», который позволяет восстановить утраченный или неизвестный символ.
Если вы не знаете 7, 8 или 9 цифру БИК, используйте проверку с применением номера расчетного счета. Если вы хотите найти 5 или 6 цифру БИК, выполните поиск по номеру корреспондентского счета.
Обратите внимание, что вы можете найти только одну неизвестную цифру в БИК или номерах расчетного и банковского счета. Таким образом, можно смело говорить о том, что использование системы проверки правильности банковских реквизитов позволяет не только убедиться в том, что отправленные вами денежные средства будут доставлены получателю, но и восстановить недостающие или утраченные элементы банковских реквизитов. Это может оказаться крайне удобным даже в том случае, если информация была повреждена или отображается нечетко. К тому же, имея номер расчетного счета и корреспондентского счета, вы можете восстановить две недостающие цифры в коде БИК. Обратите внимание, что каждый из указанных банковских реквизитов является обязательным для правильной обработки и проведения вашего платежа. Отсутствие любого из указанных реквизитов станет основанием для отказа в проведении вашей операции со стороны финансовой организации.
качество данных, полнота, источники и достоверность
Наши данные
Надежные источники данных
Точные данные о банках и финансовых организациях лежат в основе нашей платформы. Наша база данных включает в себя информацию из нескольких надежных источников.Нам удалось установить тесные партнерские отношения со следующими организациями:
- Центральные банки
- Банки
- Финансовые организации
- Финансовые регуляторы
- Платежные системы и ассоциации
- Компании, работающие в сфере приема платежей
- Частные компании
Справочные данные от лидеров отрасли
Информацию о международных и местных финансовых организациях
Точные данные высокого качества, полученные из надежных источников
Ежемесячные обновления основных справочников и баз данных
Полнота и точность
Мы постоянно проводим анализ полноты и точности данных, доступных в нашей системе. В настоящее время мы готовы предоставить информацию о 99.9% банков и финансовых организаций.
Использование автоматического обновления информации позволяет гарантировать максимальную точность информации о коде банка и отделениях.
Анализ запросов наших клиентов позволяет обнаружить слабые места и отсутствие той или иной информации. Использование такой системы позволяет устранить проблему раньше, чем клиент успеет сообщить о ней.
Объем данных
Наши программисты проводят постоянный анализ данных, и используют комбинацию информации из различных источников, создавая единую базу данных для проверки информации в рамках нашей системы.
Каждый раз, когда вы отправляете IBAN-код для проверки в нашей системе, мы определяем наименование банка, адрес и БИК код.
В гашей базе данных содержится более 330 000 записей о банках и банковских отделениях:
- 75 стран, которые используют IBAN
- 34 стран-участниц SEPA
- 25 стран, тестирующих использование IBAN
- Банк — Наименование банка или финансовой организации.
- БИК — БИК организации, создавшей данный IBAN.
- Адрес — Адрес банка.
- Отделение — Наименование отделения организации, создавшей данный IBAN.
- Город — Город организации, создавшей данный IBAN.
- Страна — Страна организации, создавшей данный IBAN. Например, «Германия».
- ISO страны — ISO 3166-1 код страны, например, DE, CH, GB, FR, NL, AT и др.
- Эл. почта — основной контактный адрес банка или отделения.
- Факс — основной номер факса банка или отделения.
- Телефон — основной номер телефона банка или отделения.
- Регион — регион банка или отделения.
- Индекс — индекс банка или отделения.
Вы можете получить информацию о поддерживаемых странах и форматах IBAN в информационном разделе нашего сайта.
Постоянные обновления и гарантия полноты данных
Актуализация данных является трудоемким и сложным процессом.Мы занимаемся развитием нашей системы, и используем несколько источников данных для создания всеобъемлющей системы, позволяющей получить самые актуальные данные в простом для восприятия формате.
Наши сотрудники активно работают над поддержанием базы данных в актуальном состоянии, что гарантирует высокое качество информации.
Для большей части стран, представленных в нашем каталоге, мы производим ежемесячные и еженедельные обновления.
В случае с такими динамичными странами, как Великобритания, мы производим обновления на еженедельной основе.
Доступность и удобство использования
Доступность данныхМы считаем, что данные должны быть доступны нашим клиентам везде и всегда. Данный принцип лежит в основе всех современных SaaS-решений, и, в частности, в основе нашей платформы. Для выполнения данного принципа мы используем только надежное оборудование, которое гарантирует доступность системы в 99.9% случаев.
Данные везде и всегда
Предоставляя SaaS-услуги, мы обеспечиваем возможность интеграции нашей платформы в любую из ваших корпоративных систем. Использование автоматизированной системы управления данными, а также возможность ручной проверки введенной информации, обеспечивают максимальную гибкость, с которой не сравнится ни одна из собственных систем вашей компании.
API для восстановления данных
Сведения для интеграции API
1. Для чего предназначен API-интерфейс восстановления IBAN?
Данный API-интерфейс позволяет восстановить до двух недостающих символов из IBAN-номера банка. Данная функция окажется полезной при нечитаемости номера IBAN, а также для проверки данных, введенных пользователем. Данная система учитывает формат кода в выбранной стране, и гарантирует минимальное количество доступных вариантов. Все возможнные комбинации букв и цифр проходят проверку с использованием уникального алгоритма.Примеры использования:
— Нечитаемые символы — при оцифровке IBAN-номеров с бумажных носителей код может оказаться нечитаемым из-за выцветания чернил или повреждения бумаги. Наша система позволяет заменить нечитаемый символ знаком «?». После этого система подбора кодов создает список возможных кодов для нечитаемого номера IBAN.
— Подсказка при вводе — если у вас есть неправильный номер IBAN, вы можете использовать данную систему, чтобы найти ошибку, устанавливая специальный символ «?» в разные позиции внутри кода.
2. Ключевые особенности
API-интерфейс для восстановления IBAN позволяет выполнять следующие задачи:
- Получение списка действительный IBAN для подбора правильного варианта.
- Получение внутреннего БИК с использованием полученного IBAN.
- Получение кода отделения банка с использованием полученного IBAN.
- Получение номера счета банка с использованием полученного IBAN.
3. Запросы API для восстановления
API-интерфейс позволяет автоматизировать процесс восстановления IBAN, используя простые запросы HTTP GET или POST.
Допустимые параметры представлены в данной таблице:
| Название поля | Длина | Тип | Описание |
|---|---|---|---|
| IBAN | 100 | Строка | Зашифрованный номер IBAN, который вы хотите проверить. Используйте знак «?» вместо неизвестного символа. Например: DE79850?0300310018056? |
| api_key | 128 | Строка | Ваш личный API-ключ. |
| format | 5 | Строка | Поддерживаемые форматы ответа XML и JSON. |
*Для получения API-ключа, пожалуйста, свяжитесь с нами по адресу [email protected], или оплатите подписку на странице размещения заказа
ПРИМЕРЫ – Восстановление IBAN
Ниже представлен пример использования нашего API для восстановления IBAN с использованием запроса GET:
https://api.iban.com/clients/api/recover-iban.php?api_key=key&format=xml&iban=IBAN
Данные:
- ваш API-ключ
- IBAN-код для проверки в системе. Например: CH8?0853410203475000?
- xml выбран в качестве формата ответа. Кроме того, вы можете указать json для получения ответа в этом формате.
После того, как запрос HTTP GET или POST отправлен с использованием правильного API-ключа, система предоставит ответ в указанном формате. Пример ответа системы вы сможете найти в следующем разделе: “Структура ответа API”
4. Структура ответа API
Схема XSD ответа API представлена ниже:
Подробная информация о каждом из полей ответа представлена в данной таблице:
| Поле | Длина | Тип | Описание |
|---|---|---|---|
| country | Макс. 2 | Строка | Двухзначный код страны в формате ISO. |
| iban_length | Макс. 2 | Целое число | Точная длина IBAN для выбранной страны. |
| format_template | Макс. 2 | Строка | Шаблон, отображающий длину IBAN кода со случайными значениями. C = смешанный (буквы и цифпы), A = только буквы, N = только цифры. |
| bank_code | Макс. 99 | Строка | Внутренний БИК-код выбранного банка для IBAN. |
| branch_code | Макс. 99 | Строка | Внутренний код отделения выбранного банка для IBAN. |
| account_number | Макс. 99 | Строка | Внутренний номер счета отделения выбранного банка для IBAN. |
Ниже представлен пример XML-ответа от API-интерфейса при проверке IBAN:
Ch31CCNNNNNNNCCCCCCCCCCCC853410203475000CH810853410203475000KCH860853410203475000RCH8908534102034750002
5. Коды состояния API
API для восстановления IBAN может отправить следующие коды ошибок:
| Код ошибки | Тип | Описание |
|---|---|---|
| 301 | Ошибка учетной записи | Неправильный API-ключ |
| 302 | Ошибка учетной записи | Истек срок действия подписка |
| 303 | Ошибка учетной записи | Нет доступных запросов |
| 304 | Ошибка учетной записи | У вас нет доступа к данному API |
| 401 | Ошибка ввода | Не заполнены обязательные поля. |
| 402 | Ошибка ввода | Слишком много спец. символов. Вы можете использовать не более 2 спец. символов. |
| 403 | Ошибка ввода | Слишком мало спец. символов. Вы должны использовать не менее 1 спец. символа. |
Расчет IBAN — Документация API
Данный API-интерфейс является частью услуги IBAN Suite
Руководство по интеграции API
1. Что представляет собой API для расчета IBAN?
Система расчета IBAN (перевод IBAN) позволяет трансформировать реквизиты банка для внутреннего рынка в международный формат IBAN.Наше решение позволяет интегрировать систему проверки прямо в ваше программное обеспечение, и использовать его для решения внутренних проблем и вопросов.
Кроме того, система позволяет выполнить проверку банков и финансовых учреждений, предоставляя подробную информацию для наших клиентов.
2. Основные функции
Ниже представлена информация об основных функция системы расчета IBAN:- Подтверждение местного БИК и номера счета (* см. список стран, в которых доступна данная услуга)
- Получние информации о банке на основе местного БИКа или кода отделения.
- Автоматический перевод информации в формат IBAN (БИК и номер счета)
- Система поддерживает несколько форматов предоставления данных ( JSON / XML )
3. Поддерживаемые страны
Система расчета IBAN работает в странах, указанных ниже. Кроме того, вы должны указать следующие данные для расчета IBAN.| Код страны | Наименование страны | Код банка | Отделение | Счет | Проверочное значение ** |
|---|---|---|---|---|---|
| AT | Австрия | Да | Да | ||
| BE | Бельгия | Да | Да | Да | |
| CH | Швейцария | Да | Да | ||
| DE | Германия | Да | Да | ||
| EE | Эстония | Да | |||
| ES | Испания | Да | Да | Да | Да |
| FI | Финляндия | Да | Да | ||
| FR | Франция | Да | Да | Да | Да |
| GB | Великобритания | Да | Да | Да | |
| HU | Венгрия | Да | Да | ||
| IE | Ирландия | Да | Да | Да | |
| IT | Италия | Да | Да | Да | Да |
| MC | Монако | Да | Да | Да | Да |
| MR | Мавритания | Да | Да | Да | |
| MT | Мальта | Да | Да | ||
| Нет | Норвегия | Да | Да | ||
| PT | Португалия | Да | Да | Да | Да |
| SM | Сан-Марино | Да | Да | Да | |
| CZ | Чехия | Да | Да | Да | |
| AL | Албания | Да | Да | ||
| SK | Словакия | Да | Да | Да | |
| SI | Словения | Да | Да | Да | |
| PL | Польша | Да | Да | Да | |
| PK | Пакистан | Да | Да | ||
| SE | Швеция | Да | Да | Да | |
| NL | Голландия | Да | Да |
Проверочные символы позволяют создать дополнительный уровень проверки правильности введенных данных.
4. Данные API
API-интерфейс принимает запросы HTTP GET и POST.Доступные параметры представлены в таблице ниже:
| Поле | Тип | Описание |
|---|---|---|
| api_key | Строка | Ваш личный API-ключ. Вы можете получить его в клиентском разделе. |
| format | Строка | Формат ответа API (xml или json ) |
| country | Строка | 2-значный код страны ( UK/US/DE/FR ) |
| bankcode | Строка | Уникальный номер банка. Отличается для каждой страны. (опциональное поле). Для некоторых стран достаточно указать только номер счета. |
| branch | Строка | Уникальный номер отделения (опционально) |
| account | Строка | Индивидуальный номер счета |
| cd | Целое число | Проверочные символы, которые используются в некоторых странах. |
| prefix | Целое число | В настоящее время используется только в Чехии (опционально) |
API-интерфейс поддерживает несколько форматов ответа, что гарантирует простую интеграци. В настоящее время мы поддерживаем XML и JSON.
Значение поля Country включает в себя двухзначный код страны: UK для Великобритании, DE для Германии, FR для Франции…
Поле Bank Code имеет разную длину для каждой страны.
Поле Branch Code является дополнительным, и используется только в некоторых странах (см. примеры)
Поле Account number является единственным параметром, который нужно указать в ряде стран для расчета IBAN.
Поле Check Digits требуется только для стран, в которых используется такая система проверки правильности введенных данных (см. примеры)
Поле Prefix в настоящее время используется только для расчета IBAN для банков Чехии.
5. Примеры API
В таблице ниже представлены примеры использования запроса GET для работы с API-интерфейсом.| Страна | Пример запроса (GET REQUEST) |
|---|---|
| AT | ?country=AT&format=json&bankcode=12000&account=52700357958 |
| BE | ?country=BE&format=json&bankcode=250&account=0135106&cd=70 |
| CH | ?country=CH&format=json&bankcode=0240&account=240C08011570 |
| DE | ?country=DE&format=json&bankcode=BLZ37010050&account=399509 |
| EE | ?country=EE&format=json&account=55000005511439 |
| ES | ?country=ES&format=json&bankcode=0081&branch=1731&cd=91&account=0006040912 |
| FI | ?country=FI&format=json&account=52900261901092 |
| FR | ?country=FR&format=json&bankcode=30056&branch=00264&account=02640016443 |
| GB | ?country=GB&format=json&bankcode=090127&account=93496333 |
| HU | ?country=HU&format=json&account=107000240416330551100005 |
| IE | ?country=IE&format=json&bankcode=905838&account=71924374 |
| IT | ?country=IT&format=json&country=IT&bankcode=02008&branch=30545&account=000103685854 |
| MC | ?country=MC&format=json&country=MC&bankcode=30002&branch=03260&account=0000079112A |
| MR | ?country=MR&format=json&bankcode=00012&branch=00001&account=00000078326 |
| MT | ?country=MT&format=json&bankcode=07113&account=199008240010 |
| Нет | ?country=NO&format=json&account=96803502045 |
| PT | ?country=PT&format=json&bankcode=0038&branch=0000&cd=81&account=39551148771 |
| PK | ?country=PK&format=json&bankcode=HABBPKKA&account=39551148771 |
| SE | ?country=SE&format=json&bankcode=9150&account=0092395696 |
| SM | ?country=SM&format=json&country=SM&bankcode=03034&branch=09800&account=000060164676 |
| CZ | ?country=CZ&format=json&prefix=51&account=1707230277&bankcode=0100 |
| AL | ?country=AL&format=json&bankcode=20511117&account=374362CLPRCFEURC |
| SK | ?country=SK&format=json&prefix=&account=4110053902&bankcode=3100 |
| SI | ?country=SI&format=json&bankcode=33000&account=0000102423 |
| PL | ?country=PL&format=xml&bankcode=11402004&account=0000360275244226 |
| SE | ?country=SE&format=json&bankcode=9300&account=5913222524 |
| NL | ?country=NL&format=json&account=0006642318 |
6. Структура ответа API XML
Ниже представлено подробное описание каждого из полей ответа API-интерфейса:| Поле | Тип | Описание |
|---|---|---|
| address | Строка | Адрес отделения или центрального офиса |
| bank | Строка | Наименование банка или финансовой организации |
| bic | Строка | BIC (БИК) банка |
| branch | Строка | Наименование отделения, соответствующее коду |
| city | Строка | Наименование города, в котором расположено отделение. |
| country | Строка | Двухзначное обозначение страны: US, UK, AU, FR и так далее. |
| Строка | Контактный электронный адрес банка или отделения | |
| fax | Строка | Номер факса банка или отделения |
| phone | Строка | Номер телефона банка или отделения |
| state | Строка | Страна банка или отделения |
| website | Строка | Сайт банка или отделения |
| zip | Строка | Индекс банка или отделения |
Ниже представлен пример XML-ответа для Великобритании. Необходимо указать следующие данные:
Ссылка запроса:
?api_key=9834hAHx78ba4g8habsdk&country=GB&format=json&bankcode=110377&account=10218962
<result>
<iban>GB20ULSB98006054100029</iban>
<account>54100029</account>
<sort_code>980060</sort_code>
<bank>ULSTER BANK LTD</bank>
<branch>BELFAST CITY OFFICE 1</branch>
<bic>ULSBGB2BXXX</bic>
<address>PO BOX 232 11-16 DONEGALL SQUARE EAST </address>
<city>BT1 5UB</city>
<country>GB<country/>
<phone>028 90244112</phone>
</result>
Тот же самый ответ в JSON будет выглядеть следующим образом:
«iban»:»GB20ULSB98006054100029″,»account»:»54100029″,»sort_code»:»980060″,»bank»:»ULSTER BANK LTD»,»branch»:»BELFAST CITY OFFICE 1″,»bic»:»ULSBGB2BXXX»,»address»:»PO BOX 232 11-16 DONEGALL SQUARE EAST «,»city»:»BT1 5UB»,»country»:»GB»,»phone»:»028 90244112″
7. Ошибки API
При возникновении ошибки в расчете IBAN, система возвращает XML или JSON ответ с текстом ошибки.Ответ содержит в себе только код ошибки, и не содержит других полей XML.
Ниже представлен перечень возможных ошибок:
<error>Account Number checksum is invalid.</error>
<error>Account Number (checksum) is not correct.</error>
<error>Account Number has to be 11 characters long</error>
<error>Account Number has to be 14 characters long</error>
<error>Account Number has to be 24 characters long</error>
<error>Account Number is not valid</error>
<error>Account Number of Sort Code is not valid</error>
<error>Account Number prefix too long.</error>
<error>Account Number too long.</error>
<error>Bank/Branch Code / KIB (checksum) is not correct.</error>
<error>Bank Code/ Branch Code/ Account Number too long.</error>
<error>Bank Code/ Branch Code (checksum) is not correct.</error>
<error>Bank Code not valid</error>
<error>Bank Code too long.</error>
<error>Bank Not Found</error>
<error>Bank Not Recognized</error>
<error>BBAN / NIB (checksum) is not correct.</error>
<error>BLZ/Bank Code not valid</error>
<error>Branch/Agencia not found</error>
<error>Branch Code too long.</error>
<error>Branch not found</error>
<error>Check Digit too long.</error>
<error>Clearingnummer/Account Number is not valid. Check digit incorrect.</error>
<error>Clearingnummer / BankCode can not be identified. IBAN can not be calculated.</error>
<error>Clearingnummer or Account Number too long.</error>
<error>Codice ABI della Banca/Bank Code not valid</error>
<error>Codice CAB della Filiale/Branch Code not valid</error>
<error>Country code is not valid</error>
<error>Country or Bank not supported</error>
<error>IBAN is not valid</error>
<error>Kontonummer/Account Number is not valid</error>
<error>Missing fields</error>
<error>Non FR IBAN</error>
<error>Non FR IBAN country</error>
<error>Required field is missing. Please enter Bank Code and Account Number</error>
<error>Required fields not submitted.</error>
<error>RIB is not valid</error>
<error>SortCode / BankCode can not be identified. IBAN can not be calculated.</error>
<error>Sort code cannot be found</error>