Генератор і Валідатор CBU для Аргентини | Банківські Коди BCRA

Що таке аргентинський CBU і навіщо його перевіряти?

Робота з банківською системою Аргентини означає мати справу з CBU (Clave Bancaria Uniforme) — 22-значним кодом, який унікально ідентифікує кожний банківський рахунок у країні. Якщо вам коли-небудь доводилося тестувати інтеграцію платежів, перевіряти банківські реквізити перед переказом або розуміти причину невдалої транзакції, ви знаєте, наскільки важливо працювати з правильно відформатованими CBU.

Цей інструмент допомагає генерувати структурно коректні CBU для тестових середовищ і перевіряти наявні коди відповідно до офіційного формату, визначеного Центральним банком Аргентини (BCRA). Коли ви створюєте фінансові додатки або обробляєте платежі, виявлення помилок формату на ранніх етапах заощаджує години налагодження та запобігає невдалим транзакціям.

Розуміння формату CBU

CBU (Clave Bancaria Uniforme) - це аргентинський аналог міжнародних банківських ідентифікаторів, таких як IBAN або маршрутні номери США. Уявіть його як комплексний пакет, що об'єднує інформацію про банк, філію та рахунок в єдиний 22-значний код. Центральний банк Аргентини (BCRA) запровадив цю систему в листопаді 2000 року для стандартизації електронних переказів у фінансовій мережі країни.

Структура та формат CBU

Кожен дійсний CBU складається рівно з 22 цифр, розділених на два основні блоки:

Перший блок (8 цифр): Ідентифікує фінансову установу та філію
- Перші 3 цифри: Банківський код, присвоєний BCRA
- Наступні 4 цифри: Код філії в банку
- Остання цифра: Контрольна цифра для першого блоку
Другий блок (14 цифр): Ідентифікує конкретний рахунок
- Перші 13 цифр: Номер рахунку (може включати тип рахунку та інші ідентифікатори)
- Остання цифра: Контрольна цифра для другого блоку

Контрольні цифри використовують зважений алгоритм за модулем 10, який виявляє поширені помилки — наприклад, переставлені цифри або помилки в одній цифрі — ще до переміщення будь-яких коштів. Цей захисний механізм виявився надзвичайно ефективним: більшість помилок при введенні CBU перехоплюються на етапі перевірки, а не призводять до невдалих переказів.

Як згенерувати тестовий CBU

Генератор створює випадкові, але структурно коректні CBU, які проходять усі перевірки формату. Ось що відбувається за лаштунками:

Випадкові цифри заповнюють розділи банківського коду, коду філії та номера рахунку
Інструмент обчислює обидва перевірочні цифри за офіційним алгоритмом BCRA
Ви отримуєте правильно сформований 22-значний CBU, готовий для тестування

Коли це буде корисним:

Тестування інтеграцій платежів: Потрібні десятки дійсних CBU для вашого тестового набору? Генеруйте їх миттєво без ручного обчислення.
Середовища QA та проміжного тестування: Заповнюйте тестові бази даних реалістичними банківськими даними, які випадково не збігатимуться з реальними рахунками.
Вивчення формату: Дивіться, як структуровані різні CBU, та розумійте логіку перевірки.
Документація та демонстрації: Створюйте зразкові дані, які виглядають автентично, не розкриваючи реальної банківської інформації.

Крок за кроком: Генерування CBU

Перейдіть на вкладку "Генератор" інструменту
Натисніть кнопку "Згенерувати CBU"
У полі виведення з'явиться дійсний випадковий 22-значний CBU
Використайте кнопку "Копіювати", щоб скопіювати CBU до буфера обміну для використання у ваших додатках

Як перевірити аргентинський CBU

Валідатор виконує ті самі перевірки, які використовують банківські системи Аргентини для перевірки цілісності CBU. Що перевіряється:

Перевірка довжини: Підтверджує точно 22 цифри (поширена помилка - копіювання з пробілами або дефісами)
Вміст лише цифр: Забезпечує відсутність літер або спеціальних символів
Контрольна сума першого блоку: Перевіряє 8-му цифру відносно перших 7 цифр
Контрольна сума другого блоку: Перевіряє 22-гу цифру відносно цифр 9-21

Якщо перевірка не проходить, ви побачите, яка конкретна перевірка не пройшла. Це особливо корисно при налагодженні причин відхилення CBU банківським API — часто це щось просте, як зайвий пробіл або переставлена цифра.

Крок за кроком: Перевірка CBU

Перейдіть на вкладку "Валідатор" інструменту
Введіть 22-значний CBU, який ви хочете перевірити
Натисніть кнопку "Перевірити CBU"
Перегляньте результат перевірки:
- Зелений індикатор для дійсних CBU
- Червоний індикатор з конкретними повідомленнями про помилки для недійсних CBU

Пояснення алгоритму перевірки CBU

BCRA використовує алгоритм контрольної суми за модулем 10 для обчислення перевірочних цифр. Якщо ви впроваджуєте перевірку CBU у своїй програмі, ось точна логіка:

Перевірка першого блоку

Для першого блоку (перші 8 цифр) перевірочна цифра обчислюється наступним чином:

Взяти перші 7 цифр CBU
Помножити кожну цифру на її відповідну вагу: [7, 1, 3, 9, 7, 1, 3]
Підсумувати отримані добутки
Обчислити: 10 - (сума % 10)
Якщо результат дорівнює 10, перевірочна цифра дорівнює 0; інакше це обчислене значення

Перевірка другого блоку

Для другого блоку (останні 14 цифр) перевірочна цифра обчислюється наступним чином:

Взяти перші 13 цифр другого блоку
Помножити кожну цифру на її відповідну вагу: [3, 9, 7, 1, 3, 9, 7, 1, 3, 9, 7, 1, 3]
Підсумувати отримані добутки
Обчислити: 10 - (сума % 10)
Якщо результат дорівнює 10, перевірочна цифра дорівнює 0; інакше це обчислене значення

Приклади перевірки коду CBU

Ось як реалізувати перевірку CBU у вашому додатку. Ці приклади відповідають офіційній специфікації BCRA і працюватимуть з виробничими банківськими даними:

1// JavaScript: Обчислення контрольної цифри CBU
2function calculateCheckDigit(number, weights) {
3  if (number.length !== weights.length) {
4    throw new Error('Довжина числа має збігатися з довжиною ваг');
5  }
6  
7  let sum = 0;
8  for (let i = 0; i < number.length; i++) {
9    sum += parseInt(number[i]) * weights[i];
10  }
11  
12  const remainder = sum % 10;
13  return remainder === 0 ? 0 : 10 - remainder;
14}
15
16// Перевірка першого блоку CBU
17function validateFirstBlock(block) {
18  if (block.length !== 8 || !/^\d{8}$/.test(block)) {
19    return false;
20  }
21  
22  const number = block.substring(0, 7);
23  const checkDigit = parseInt(block[7]);
24  const weights = [7, 1, 3, 9, 7, 1, 3];
25  
26  return checkDigit === calculateCheckDigit(number, weights);
27}
28

1# Python: Перевірка повного CBU
2import re
3
4def validate_cbu(cbu):
5    # Перевірка базового формату
6    if not cbu or not re.match(r'^\d{22}$', cbu):
7        return {
8            'isValid': False,
9            'errors': ['CBU має містити 22 цифри']
10        }
11    
12    # Розділення на блоки
13    first_block = cbu[:8]
14    second_block = cbu[8:]
15    
16    # Перевірка кожного блоку
17    first_block_valid = validate_first_block(first_block)
18    second_block_valid = validate_second_block(second_block)
19    
20    errors = []
21    if not first_block_valid:
22        errors.append('Перший блок (код банку/відділення) недійсний')
23    if not second_block_valid:
24        errors.append('Другий блок (номер рахунку) недійсний')
25    
26    return {
27        'isValid': first_block_valid and second_block_valid,
28        'errors': errors
29    }
30

1// Java: Генерація випадкового дійсного CBU
2import java.util.Random;
3
4public class CBUGenerator {
5    private static final Random random = new Random();
6    
7    public static String generateCBU() {
8        // Генерація перших 7 цифр (код банку та відділення)
9        StringBuilder firstBlockBase = new StringBuilder();
10        for (int i = 0; i < 7; i++) {
11            firstBlockBase.append(random.nextInt(10));
12        }
13        
14        // Обчислення контрольної цифри для першого блоку
15        int[] firstBlockWeights = {7, 1, 3, 9, 7, 1, 3};
16        int firstBlockCheckDigit = calculateCheckDigit(
17            firstBlockBase.toString(), 
18            firstBlockWeights
19        );
20        
21        // Генерація перших 13 цифр другого блоку
22        StringBuilder secondBlockBase = new StringBuilder();
23        for (int i = 0; i < 13; i++) {
24            secondBlockBase.append(random.nextInt(10));
25        }
26        
27        // Обчислення контрольної цифри для другого блоку
28        int[] secondBlockWeights = {3, 9, 7, 1, 3, 9, 7, 1, 3, 9, 7, 1, 3};
29        int secondBlockCheckDigit = calculateCheckDigit(
30            secondBlockBase.toString(), 
31            secondBlockWeights
32        );
33        
34        // Об'єднання всіх частин
35        return firstBlockBase.toString() + firstBlockCheckDigit + 
36               secondBlockBase.toString() + secondBlockCheckDigit;
37    }
38    
39    // Реалізація методу calculateCheckDigit...
40}
41

1// PHP: Форматування CBU для відображення
2function formatCBU($cbu) {
3    if (!$cbu || strlen($cbu) !== 22) {
4        return $cbu;
5    }
6    
7    // Форматування як: XXXXXXXX XXXXXXXXXXXXXX
8    return substr($cbu, 0, 8) . ' ' . substr($cbu, 8);
9}
10
11// Приклад використання
12$cbu = '0123456789012345678901';
13echo formatCBU($cbu); // Виводить: 01234567 89012345678901
14

1' Excel VBA: Перевірка CBU
2Function ValidateCBU(cbu As String) As Boolean
3    ' Перевірка довжини
4    If Len(cbu) <> 22 Then
5        ValidateCBU = False
6        Exit Function
7    End If
8    
9    ' Перевірка, чи всі символи є цифрами
10    Dim i As Integer
11    For i = 1 To Len(cbu)
12        If Not IsNumeric(Mid(cbu, i, 1)) Then
13            ValidateCBU = False
14            Exit Function
15        End If
16    Next i
17    
18    ' Витягнення блоків
19    Dim firstBlock As String
20    Dim secondBlock As String
21    firstBlock = Left(cbu, 8)
22    secondBlock = Right(cbu, 14)
23    
24    ' Перевірка обох блоків
25    ValidateCBU = ValidateFirstBlock(firstBlock) And ValidateSecondBlock(secondBlock)
26End Function
27

Реальні сценарії використання перевірки CBU

Тестування платіжних інтеграцій

При створенні фінтех-додатків або платформ електронної комерції, які обробляють аргентинські платежі, вам потрібні дійсні CBU для тестового середовища. Типовий сценарій: ваше проміжне середовище вимагає 50 тестових облікових записів з дійсними CBU для навантажувального тестування. Ручне обчислення контрольних цифр для кожного зайняло б години. Генератор виконує це за секунди, надаючи правильно відформатовані тестові дані, які поводяться як CBU у виробничому середовищі, без ризику випадкового використання реальних номерів рахунків.

Професійна порада: Зберігайте набір згенерованих CBU у ваших тестових fixture. Це забезпечує послідовність тестових даних у вашій команді та полегшує налагодження, коли тести не проходять.

Запобігання помилкам транзакцій

Ось що зазвичай відбувається: клієнт надає свій CBU для грошового переказу, але випадково включив пробіли або переплутав дві цифри. Якщо ви обробите переказ без перевірки, банк відхилить його — але тільки після затримки, і ви вже зафіксували намір транзакції у своїй системі. Тепер ви маєте справу з проблемами звірки.

Перевірка формату CBU перед поданням одразу виявляє ці помилки. Валідатор не скаже вам, чи існує рахунок або чи належить він правильній особі (для цього потрібен доступ до банківського API), але підтвердить, що структура правильна відповідно до стандартів BCRA.

Розуміння вимог до банківської інтеграції

Для розробників, які нещодавно познайомилися з фінансовою системою Аргентини, цей інструмент забезпечує практичне навчання. Ви можете побачити, як саме працюють контрольні цифри, зрозуміти, чому деякі номери є недійсними, та експериментувати з крайніми випадками перед написанням виробничого коду.

Поширена помилка: Припущення, що перевірка CBU така сама, як перевірка IBAN. Хоча обидві використовують контрольні цифри, алгоритми повністю відрізняються. Тестування за допомогою цього інструменту допоможе зрозуміти специфічні вимоги до банківських кодів Аргентини.

Перевірка форм у банківських інтерфейсах

При розробці форм введення, які приймають CBU, вам потрібно перевірити, як система обробляє різні стани помилок. Що станеться, коли користувач вставить CBU з пробілами? Яке повідомлення про помилку з'явиться, коли контрольна цифра невірна? Цей інструмент допоможе вам перевірити ці сценарії та розробити кращий зворотний зв'язок для користувача.

Пов'язані інструменти перевірки банківських даних

Залежно від ваших вимог, вам також можуть знадобитися ці додаткові інструменти:

Валідатор CUIT/CUIL: Перевіряє argentine ідентифікаційні номери для сплати податків — незамінний, коли потрібна перевірка банківських та податкових ідентифікаторів
Валідатор CVU: Подібний до CBU, але для цифрових гаманців (Mercado Pago, Ualá тощо), що використовують той самий 22-значний формат
Валідатор IBAN: Для транскордонних платежів, що включають європейські або інші міжнародні рахунки
Банківські API-сервіси: Для виробничих систем, яким потрібно перевірити право власності на рахунок та залишок коштів, а не лише формат

Важливе обмеження: Цей інструмент перевіряє лише формат та контрольні цифри. Він не може підтвердити, чи відповідає CBU активному банківському рахунку або перевірити особу власника рахунку. Для таких перевірок потрібна інтеграція з банківськими API або платіжними процесорами Аргентини.

Як банківська система Аргентини прийняла CBU

До листопада 2000 року переказ грошей між argentine банками був несподівано складним. Кожна фінансова установа використовувала власну систему нумерації рахунків — деякі з 10 цифрами, інші з 15, і не було стандартизованого способу визначити, який банк або філія утримує рахунок. Міжбанківські перекази вимагали ручної перевірки і часто займали дні для обробки.

BCRA представив CBU для вирішення цієї фрагментації. Запровадивши єдиний 22-значний формат для всіх фінансових установ, Аргентина узгодилася з міжнародними стандартами, такими як європейська система IBAN. Вбудовані контрольні цифри були особливо розумними: вони автоматично виявляють більшість помилок введення даних, зменшуючи кількість невдалих переказів та пов'язаних з ними витрат на розслідування та скасування транзакцій.

Цікаво: Формат CBU практично не змінився за понад 20 років. Незважаючи на те, що банківські технології еволюціонували драматично — мобільні додатки, миттєві перекази, цифрові гаманці — базова структура CBU залишається незмінною. Ця стабільність свідчить про те, наскільки добре було передбачено первісний дизайн.

Сьогодні аргентинці використовують CBU практично для кожної електронної фінансової транзакції: зарахування зарплати, оплати рахунків, подання податків, державних пільг та електронної комерції. Формат виявився настільки ефективним, що коли з'явилися цифрові гаманці (як Mercado Pago), регулятори прийняли ту саму структуру для CVU (Clave Virtual Uniforme), а не вигадували щось нове.

Часті запитання

Яка різниця між CBU та CVU?

CBU ідентифікує традиційні банківські рахунки, а CVU (Clave Virtual Uniforme) ідентифікує рахунки цифрових гаманців від фінтех-провайдерів, як от Mercado Pago, Ualá або Brubank. Формат ідентичний — 22 цифри з однаковим алгоритмом перевірки — що має сенс, оскільки вони сумісні. Ви можете переказувати гроші з CBU на CVU і навпаки, як і будь-який інший банківський переказ. Перші три цифри показують, чи йдеться про традиційний банк або провайдера цифрового гаманця.

Чи можна дізнатися назву банку за CBU?

Так. Перші три цифри є ідентифікатором банку, призначеним BCRA. Наприклад, коди, що починаються з "011", належать Banco Nación, а "017" вказує на BBVA Argentina. BCRA публікує офіційний реєстр цих кодів, який банківські додатки зазвичай використовують для автоматичного відображення назви банку при введенні CBU.

Чи є CBU тим самим, що й номер рахунку?

Не зовсім. Номер вашого рахунку захований всередині CBU, але CBU пакує його з додатковою інформацією про маршрутизацію. Думайте про це як про різницю між адресою вулиці та GPS-координатами — обидва ідентифікують місце розташування, але один включає більше контексту. CBU об'єднує код банку, код філії, номер рахунку та два перевірочні цифри в один переказуваний рядок.

Наскільки безпечно ділитися моїм CBU?

CBU призначений для обміну — в цьому й полягає його суть. Одержувачі потребують його для зарахування коштів на ваш рахунок. На відміну від паролів або PIN-кодів, CBU дозволяє лише вхідні перекази, не дозволяючи знімати кошти. Тим не менш, ставтеся до нього як до будь-якої фінансової інформації: діліться ним з людьми або компаніями, яким довіряєте, і будьте обережні при публікації в інтернеті. Деякі люди віддають перевагу вибірковому наданню CBU замість його відкритої публікації.

Чи може CBU expire або змінитися?

Ваш CBU залишається з вами, доки рахунок залишається відкритим. Він змінюється лише тоді, коли ви закриваєте цей рахунок і відкриваєте новий, або в рідкісних випадках, коли банки об'єднуються або реструктуризують свою систему нумерації. Навіть тоді банки зазвичай зберігають старий CBU протягом перехідного періоду, щоб уникнути порушення регулярних платежів.

Як знайти власний CBU?

Перевірте мобільний додаток вашого банку — зазвичай він знаходиться в розділі деталей рахунку. Більшість аргентинських банків також відображають його чітко в онлайн-банкінгу, друкують у щомісячних звітах, і деякі навіть включають його на зворотному боці дебетової картки. Якщо ви не можете його знайти, будь-який банківський представник може надати його негайно; це не вважається конфіденційною інформацією, як PIN-код.

Чи можуть іноземці мати CBU в Аргентині?

Так. Відкриття банківського рахунку в Аргентині для іноземця надає вам CBU, як і будь-якому іншому власнику рахунку. Вимоги різняться залежно від установи — деякі банки вимагають лише паспорт, інші просять докази проживання або CDI (податковий ідентифікаційний номер). Цифрові гаманці (CVU) часто легше отримати іноземцям, ніж традиційні банківські рахунки.

Що станеться, якщо я зроблю переказ на недійсний CBU?

Сучасні банківські системи виконують перевірку формату перед надсиланням переказу. Якщо контрольні цифри не збігаються або довжина неправильна, ви отримаєте негайну помилку — переказ не покине ваш рахунок. Саме тому попередня перевірка на фронтенді є такою цінною; вона перехоплює друкарські помилки до того, як вони спричинять проблеми.

Складніша ситуація виникає, коли CBU проходить перевірку формату, але не збігається з активним рахунком. Переказ надсилається в міжбанківську мережу, а потім повертається через години або дні. Ви вже зафіксували його як "надісланий" у своєму обліку, і тепер вам потрібно узгодити повернення. Саме тому деякі додатки також перевіряють CBU за банківськими базами даних перед дозволом переказів, хоча це вимагає платного API-доступу.

Чи можу я мати кілька CBU?

Абсолютно. Кожен рахунок генерує власний CBU. Якщо у вас є поточний і ощадний рахунки в тому самому банку, у вас буде два різні CBU. Різні рахунки в різних банках? Ще більше CBU. Кожен унікально ідентифікує конкретний рахунок у конкретній філії конкретної установи.

Чи використовується система CBU за межами Аргентини?

Ні, CBU є специфічним для Аргентини. У кожній країні своя система: Європа використовує IBAN, США — банківські реквізити плюс номери рахунків, Австралія — коди BSB тощо. При міжнародних грошових переказах зазвичай потрібен SWIFT-код одержувача плюс локальний ідентифікатор рахунку — яким у випадку Аргентини буде CBU.

Посилання та офіційна документація

Для авторитетної інформації про банківські стандарти Аргентини:

Центральний банк Аргентини (BCRA) - Фінансові системні регламенти - Офіційна документація BCRA про стандарти платіжних систем та банківські регламенти
Закон № 25,345 - "Запобігання ухиленню від сплати податків та модернізація платежів" (листопад 2000) - Законодавство, яке встановило структуру електронних платіжних систем Аргентини
Комунікація BCRA "A" серії - Технічні циркуляри, що визначають вимоги до впровадження CBU для фінансових установ
Interbanking S.A. - Організація, яка керує міжбанківською електронною платіжною мережею Аргентини та підтримує таблиці маршрутизації CBU

Ці джерела надають технічні специфікації, використані для реалізації цього валідатора, і регулярно оновлюються argentine фінансовими органами.

Готові перевіряти або генерувати CBU?

Незалежно від того, чи створюєте ви інтеграцію платежів, тестуєте фінтех-додаток або вивчаєте банківську систему Аргентини, розуміння перевірки CBU є важливим. Цей інструмент реалізує точно такі самі алгоритми контрольних сум, які використовують аргентинські банки, тому ви можете виявляти помилки формату до того, як вони спричинять збої транзакцій.

Пам'ятайте: перевірка формату - це лише перший крок. Правильно сформований CBU не гарантує, що рахунок існує або що у вас правильний одержувач. Для виробничих систем, які мають справу з реальними грошима, поєднуйте перевірку формату з додатковою перевіркою через банківські API або платіжні процесори.

Інструмент не вимагає реєстрації або встановлення - просто відкрийте його та почніть перевіряти або генерувати CBU відповідно до офіційних стандартів BCRA.