Реализовать валидацию IBAN для международных переводов

В работеВысокий5 SP

Редактировать

МССоздано Мария Сидорова· 8 апр 2026, 10:23

Обновлено 2 часа назад

Заказчик:Внутренние инициативыВнутренний

Sprint:Sprint 24.04

Релиз:v2.4.0

Epic:Платежные стандарты ЕС

Компонент:Payments API

Срок:14 апреля 2026

SP:5

Осталось:1д 4ч

Описание

Бизнес-контекст

При pilot rollout платежного модуля в Германии и Нидерландах выявлена проблема: текущая логика валидации не учитывает страновые стандарты IBAN, что приводит к отклонению ~12% валидных платежей.

Техническое требование

Необходимо реализовать полную валидацию IBAN согласно стандарту ISO 13616:

1Проверка длины по коду страны

2Расчёт контрольной суммы MOD-97

3Валидация структуры национального кода банка

Поведение API

При валидном IBAN — стандартная обработка платежа

При невалидном IBAN — блокировка вызова внешнего провайдера

Возврат HTTP 400 с детализированной ошибкой

Логирование попытки в audit trail

Страны первой волны

DEГермания), FR (Франция), NL (Нидерланды), BE (Бельгия

Ссылки

[Спецификация IBAN](https://www.swift.com/standards/data-standards/iban)

[Внутренняя документация API](/docs/payments-api)

Критерии приёмки

2/6

Валидация формата IBAN реализована для DE, FR, NL, BE

Контрольная сумма проверяется по алгоритму MOD-97

Вызов API провайдера блокируется при невалидном IBAN

При ошибке возвращается HTTP 400 с кодом INVALID_IBAN

Событие логируется в audit trail

Unit-тесты написаны и проходят (coverage ≥ 90%)

Вложения3

iban-validation-spec.pdf

245 KB · Мария С. · 8 апр

api-contract-v2.json

12 KB · Дмитрий П. · 9 апр

screenshot-error-case.png

156 KB · Елена В. · 10 апр

1/4 подзадач1 блокирует1 блокер1 связанных

Подзадачи1/4

CPAY-1842-1	Написать unit-tests для валидатора IBAN	В работе	Высокий	АК	4ч
CPAY-1842-2	Реализовать проверку контрольной суммы MOD-97	Готово	Высокий	АК	3ч
CPAY-1842-3	Добавить валидацию для FR и BE	К выполнению	Средний	АК	2ч
CPAY-1842-4	Интеграция с audit trail	К выполнению	Средний		2ч