Валидатор и парсер IBAN

Национальный номер счёта с обёрткой

IBAN — это не новый вид номера счёта. Это существующий внутренний номер счёта, называемый BBAN, к которому спереди прикреплены четыре символа: двухбуквенный код страны ISO 3166 и две контрольные цифры. Всё, что после этих четырёх символов, — это то, что уже использует национальная банковская система, поэтому длина так сильно варьируется. Норвежский IBAN — 15 символов, мальтийский — 31, и оба совершенно корректны.

Эта изменчивость — первый настоящий шаг проверки, и тот, который люди чаще всего пропускают. Каждая страна регистрирует в SWIFT точную общую длину, и длина фиксирована, а не является максимумом. Немецкий IBAN всегда состоит из 22 символов. Если вы получите 21-символьную строку, начинающуюся с DE, она неверна независимо от того, что говорит контрольная сумма, потому что перестановка, укорачивающая строку, не может быть поймана контрольной суммой, которая никогда не видит недостающий символ. Проверка длины по стране заранее также даёт гораздо более полезное сообщение об ошибке, чем общее падение контрольной суммы.

Контрольная сумма MOD 97-10

Контрольная сумма взята из ISO 7064 и элегантно проста. Перенесите первые четыре символа в конец, замените каждую букву числом, где A — 10, а Z — 35, затем прочитайте всё это как одно огромное целое. Если это целое при делении на 97 даёт в остатке ровно 1, IBAN проходит проверку.

Загвоздка в том, что полученное число много больше любого нативного целочисленного типа языка, часто 80 цифр и более. Вместо того чтобы обращаться к библиотеке больших чисел, реализации сокращают его по частям: проходят строку слева направо и после каждой цифры оставляют только текущее значение по модулю 97. Поскольку модулярная арифметика распределяется над цифро-за-цифрой конструкцией, финальный остаток идентичен тому, что дало бы всё число целиком, а стоит это одного прохода без выделения памяти. Именно это и делает этот инструмент.

MOD 97-10 выбран, потому что он необычайно силён для двухсимвольной проверки. Он ловит любую замену одного символа, любую транспозицию двух соседних символов и подавляющее большинство более длинных перестановок. Режимы ошибок, которые он не видит, настолько редки, что остаточный риск определяется тем, что счёт просто не существует.

Чего не говорит действительный IBAN

Структурная корректность — это не существование. IBAN с верной контрольной суммой может указывать на закрытый счёт, счёт, который никогда не открывали, или банк, который с тех пор слился и перестал существовать. Единственный способ узнать, что деньги дойдут, — попытаться выполнить перевод или воспользоваться проверочной службой банка. Относитесь к проверке как к способу поймать опечатки при вводе, а не как к подтверждению того, что получатель реален.

Форматирование также требует внимания. Реестр определяет электронную форму как одну непрерывную строку без пробелов, и именно её нужно отправлять в платёжный файл или хранить в базе данных. Группированная форма по четыре символа существует только для печати на бумаге, где она помогает людям точно копировать длинные строки. Нормализуйте при вводе, храните плоско и добавляйте пробелы обратно только для отображения.