Generuj i weryfikuj argentyńskie kody bankowe CBU (Clave Bancaria Uniforme). Darmowe narzędzie wykorzystujące oficjalne algorytmy BCRA dla programistów, testerów i aplikacji finansowych.
Wygeneruj losowe, ale poprawne CBU do testowania aplikacji i integracji.
Kliknij przycisk powyżej, aby wygenerować poprawne CBU
CBU (Clave Bancaria Uniforme) to 22-cyfrowy kod używany w Argentynie do identyfikacji rachunków bankowych w elektronicznych transferach i płatnościach.
Każde CBU zawiera informacje o banku, oddziale i numerze konta wraz z cyframi kontrolnymi, które zapewniają jego ważność.
Praca z argentyńskim systemem bankowym oznacza kontakt z CBU (Clave Bancaria Uniforme) - 22-cyfrowym kodem, który jednoznacznie identyfikuje każdy rachunek bankowy w kraju. Jeśli kiedykolwiek musiałeś przetestować integrację płatności, zweryfikować dane bankowe przed przelewem lub zrozumieć powód niepowodzenia transakcji, wiesz, jak kluczowe jest posługiwanie się prawidłowo sformatowanymi CBU.
To narzędzie pomaga generować strukturalnie poprawne CBU do środowisk testowych oraz weryfikować istniejące kody względem oficjalnego formatu określonego przez argentyński Bank Centralny (BCRA). Podczas budowania aplikacji finansowych lub przetwarzania płatności, wczesne wychwycenie błędów formatowania oszczędza godziny debugowania i zapobiega nieudanym transakcjom.
CBU (Clave Bancaria Uniforme) to argentyńska odpowiedź na międzynarodowe identyfikatory bankowe, takie jak IBAN czy numery routingowe w USA. Można to potraktować jako kompleksowy pakiet, który łączy informacje o banku, oddziale i koncie w jednym 22-cyfrowym kodzie. Bank Centralny Argentyny (BCRA) wprowadził ten system w listopadzie 2000 roku, aby standaryzować elektroniczne transfery w całej krajowej sieci finansowej.
Każdy prawidłowy CBU składa się dokładnie z 22 cyfr podzielonych na dwa główne bloki:
Pierwszy blok (8 cyfr): Identyfikuje instytucję finansową i oddział
Drugi blok (14 cyfr): Identyfikuje konkretne konto
Cyfry weryfikacyjne używają algorytmu ważonego modulo-10, który wychwytuje powszechne błędy — takie jak przestawione cyfry lub błędy jednocyfrowe — zanim jakiekolwiek pieniądze zostaną przetransferowane. To zabezpieczenie okazało się niezwykle skuteczne: większość błędów wprowadzania CBU zostaje złapana na etapie walidacji, zamiast powodować nieudane transfery.
Generator tworzy losowe, ale strukturalnie poprawne CBU, które przechodzą wszystkie kontrole formatu. Oto co dzieje się za kulisami:
Kiedy będzie to przydatne:
Walidator przeprowadza te same sprawdzenia, które stosują argentyńskie systemy bankowe, aby zweryfikować integralność CBU. Co jest sprawdzane:
Gdy walidacja się nie powiedzie, zobaczysz, który konkretny test nie przeszedł. Jest to szczególnie pomocne podczas debugowania, dlaczego API bankowe odrzuciło CBU — często jest to coś prostego, jak dodatkowa spacja lub przestawiona cyfra.
BCRA używa algorytmu sumy kontrolnej z ważoną metodą modulo-10 do obliczania cyfr weryfikacyjnych. Jeśli implementujesz walidację CBU w swojej aplikacji, oto dokładna logika:
Dla pierwszego bloku (pierwsze 8 cyfr), cyfra weryfikacyjna jest obliczana w następujący sposób:
Dla drugiego bloku (ostatnie 14 cyfr), cyfra weryfikacyjna jest obliczana w następujący sposób:
Oto jak zaimplementować walidację CBU w Twojej aplikacji. Te przykłady są zgodne z oficjalną specyfikacją BCRA i będą działać z produkcyjnymi danymi bankowymi:
1// JavaScript: Oblicz cyfrę kontrolną CBU
2function calculateCheckDigit(number, weights) {
3 if (number.length !== weights.length) {
4 throw new Error('Długość numeru musi być zgodna z długością wag');
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// Sprawdź pierwszy blok 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}
281# Python: Sprawdź poprawność pełnego CBU
2import re
3
4def validate_cbu(cbu):
5 # Sprawdź podstawowy format
6 if not cbu or not re.match(r'^\d{22}$', cbu):
7 return {
8 'isValid': False,
9 'errors': ['CBU musi składać się z 22 cyfr']
10 }
11
12 # Podziel na bloki
13 first_block = cbu[:8]
14 second_block = cbu[8:]
15
16 # Sprawdź poprawność każdego bloku
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('Pierwszy blok (kod banku/oddziału) jest nieprawidłowy')
23 if not second_block_valid:
24 errors.append('Drugi blok (numer konta) jest nieprawidłowy')
25
26 return {
27 'isValid': first_block_valid and second_block_valid,
28 'errors': errors
29 }
301// Java: Wygeneruj losowe prawidłowe CBU
2import java.util.Random;
3
4public class CBUGenerator {
5 private static final Random random = new Random();
6
7 public static String generateCBU() {
8 // Wygeneruj pierwsze 7 cyfr (kod banku i oddziału)
9 StringBuilder firstBlockBase = new StringBuilder();
10 for (int i = 0; i < 7; i++) {
11 firstBlockBase.append(random.nextInt(10));
12 }
13
14 // Oblicz cyfrę kontrolną dla pierwszego bloku
15 int[] firstBlockWeights = {7, 1, 3, 9, 7, 1, 3};
16 int firstBlockCheckDigit = calculateCheckDigit(
17 firstBlockBase.toString(),
18 firstBlockWeights
19 );
20
21 // Wygeneruj pierwsze 13 cyfr drugiego bloku
22 StringBuilder secondBlockBase = new StringBuilder();
23 for (int i = 0; i < 13; i++) {
24 secondBlockBase.append(random.nextInt(10));
25 }
26
27 // Oblicz cyfrę kontrolną dla drugiego bloku
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 // Połącz wszystkie części
35 return firstBlockBase.toString() + firstBlockCheckDigit +
36 secondBlockBase.toString() + secondBlockCheckDigit;
37 }
38
39 // Implementacja metody calculateCheckDigit...
40}
411// PHP: Sformatuj CBU do wyświetlenia
2function formatCBU($cbu) {
3 if (!$cbu || strlen($cbu) !== 22) {
4 return $cbu;
5 }
6
7 // Formatuj jako: XXXXXXXX XXXXXXXXXXXXXX
8 return substr($cbu, 0, 8) . ' ' . substr($cbu, 8);
9}
10
11// Przykład użycia
12$cbu = '0123456789012345678901';
13echo formatCBU($cbu); // Wyświetla: 01234567 89012345678901
141' Excel VBA: Sprawdź poprawność CBU
2Function ValidateCBU(cbu As String) As Boolean
3 ' Sprawdź długość
4 If Len(cbu) <> 22 Then
5 ValidateCBU = False
6 Exit Function
7 End If
8
9 ' Sprawdź, czy wszystkie znaki są cyframi
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 ' Wyodrębnij bloki
19 Dim firstBlock As String
20 Dim secondBlock As String
21 firstBlock = Left(cbu, 8)
22 secondBlock = Right(cbu, 14)
23
24 ' Sprawdź poprawność obu bloków
25 ValidateCBU = ValidateFirstBlock(firstBlock) And ValidateSecondBlock(secondBlock)
26End Function
27Podczas budowy aplikacji fintech lub platform e-commerce obsługujących argentyńskie płatności, potrzebujesz ważnych CBU do środowiska testowego. Typowy scenariusz: Twoje środowisko przejściowe wymaga 50 kont testowych z ważnymi CBU do testowania obciążenia. Ręczne obliczanie cyfr kontrolnych dla każdego zajęłoby godziny. Generator radzi sobie z tym w sekundach, dostarczając prawidłowo sformatowane dane testowe, które zachowują się jak CBU produkcyjne bez ryzyka przypadkowego użycia prawdziwych numerów kont.
Wskazówka: Przechowuj zestaw wygenerowanych CBU w swoich zasobach testowych. Zapewnia to spójność danych testowych w całym zespole i ułatwia debugowanie w przypadku niepowodzenia testów.
Oto co zazwyczaj się dzieje: klient podaje swoje CBU dla przelewu, ale przypadkowo dodał spacje lub zamienił miejscami dwie cyfry. Jeśli przetworzyłbyś przelew bez walidacji, bank go odrzuca — ale dopiero po opóźnieniu, a Ty już zarejestrowałeś zamiar transakcji w swoim systemie. Teraz mierzysz się z problemami uzgodnienia.
Walidacja formatu CBU przed złożeniem natychmiast wychwytuje te błędy. Walidator nie powie Ci, czy konto istnieje lub należy do właściwej osoby (wymaga to dostępu do bankowego API), ale potwierdzi, że struktura jest poprawna zgodnie ze standardami BCRA.
Dla programistów nowych w argentyńskim systemie finansowym to narzędzie zapewnia praktyczną naukę. Możesz dokładnie zobaczyć, jak działają cyfry kontrolne, zrozumieć, dlaczego niektóre numery są nieprawidłowe, i eksperymentować z przypadkami granicznymi przed napisaniem kodu produkcyjnego.
Częsty błąd: Zakładanie, że walidacja CBU jest taka sama jak walidacja IBAN. Chociaż obie używają cyfr kontrolnych, algorytmy są całkowicie różne. Testowanie za pomocą tego narzędzia pomaga zrozumieć specyficzne wymagania argentyńskich kodów bankowych.
Projektując formularze wprowadzania, które akceptują CBU, musisz przetestować, jak system radzi sobie z różnymi stanami błędów. Co się stanie, gdy użytkownik wklei CBU z spacjami? Jaki komunikat o błędzie pojawi się, gdy cyfra kontrolna jest nieprawidłowa? To narzędzie pomaga testować takie scenariusze i projektować lepsze informacje zwrotne dla użytkownika.
W zależności od Twoich wymagań, możesz również potrzebować tych uzupełniających narzędzi:
Ważne ograniczenie: To narzędzie weryfikuje tylko format i cyfry kontrolne. Nie może potwierdzić, czy CBU odpowiada aktywnemu kontu bankowemu lub zweryfikować tożsamości posiadacza konta. Do takich sprawdzeń będziesz potrzebować integracji z argentyńskimi interfejsami API bankowymi lub procesorami płatności.
Przed listopadem 2000 roku przesyłanie pieniędzy między argentyńskimi bankami było zaskakująco skomplikowane. Każda instytucja finansowa używała własnego systemu numeracji kont — niektóre z 10 cyframi, inne z 15, bez znormalizowanego sposobu identyfikacji banku lub oddziału, w którym prowadzone jest konto. Przelewy międzybankowe wymagały ręcznej weryfikacji i często trwały kilka dni.
BCRA wprowadził CBU, aby rozwiązać ten problem fragmentacji. Nakazując jednolity 22-cyfrowy format we wszystkich instytucjach finansowych, Argentyna dostosowała się do międzynarodowych standardów, takich jak europejski system IBAN. Osadzone cyfry kontrolne były szczególnie sprytne: automatycznie wychwytują większość błędów wprowadzania danych, zmniejszając liczbę nieudanych przelewów i związanych z tym kosztów dochodzenia i anulowania transakcji.
Co ciekawe: Format CBU praktycznie się nie zmienił przez ponad 20 lat. Mimo że technologia bankowa ewoluowała dramatically — aplikacje mobilne, natychmiastowe przelewy, portfele cyfrowe — podstawowa struktura CBU pozostaje taka sama. Ta stabilność świadczy o tym, jak dobrze pierwotny projekt przewidział przyszłe potrzeby.
Dzisiaj Argentyńczycy używają CBU praktycznie we wszystkich elektronicznych transakcjach finansowych: wpłatach wynagrodzeń, płatnościach rachunków, rozliczeniach podatkowych, świadczeniach rządowych i handlu elektronicznym. Format okazał się tak skuteczny, że gdy pojawiły się portfele cyfrowe (jak Mercado Pago), regulatorzy przyjęli tę samą strukturę dla CVU (Clave Virtual Uniforme), zamiast wymyślać coś nowego.
CBU identyfikuje tradycyjne konta bankowe, podczas gdy CVU (Clave Virtual Uniforme) identyfikuje konta cyfrowych portfeli od dostawców fintech, takich jak Mercado Pago, Ualá czy Brubank. Format jest identyczny — 22 cyfry z tym samym algorytmem walidacji — co ma sens, ponieważ są interoperacyjne. Możesz przesyłać pieniądze z CBU do CVU i odwrotnie, tak jak w przypadku każnego innego przelewu bankowego. Pierwsze trzy cyfry ujawniają, czy patrzysz na tradycyjny bank, czy na dostawcę cyfrowego portfela.
Tak. Pierwsze trzy cyfry to identyfikator banku przypisany przez BCRA. Na przykład kody zaczynające się od „011" należą do Banco Nación, podczas gdy „017" wskazuje na BBVA Argentina. BCRA publikuje oficjalny rejestr tych kodów, do którego aplikacje bankowe zazwyczaj się odwołują, aby automatycznie wyświetlić nazwę banku po wprowadzeniu CBU.
Nie do końca. Twój numer konta jest zawarty w CBU, ale CBU pakuje go z dodatkowymi informacjami routingowymi. Pomyśl o tym jak o różnicy między adresem ulicy a współrzędnymi GPS — oba identyfikują lokalizację, ale jeden zawiera więcej kontekstu. CBU łączy kod banku, kod oddziału, numer konta i dwie cyfry weryfikacyjne w jednym ciągu możliwym do przeniesienia.
CBU jest przeznaczone do udostępniania — o to właśnie chodzi. Odbiorcy potrzebują go, aby wpłacić pieniądze na Twoje konto. W przeciwieństwie do haseł lub PIN-ów, CBU pozwala tylko na przychodzące przelewy, nie na wypłaty. Niemniej jednak traktuj je jak każde inne informacje finansowe: udostępniaj je osobom lub firmom, którym ufasz, i bądź ostrożny przy publikowaniu ich publicznie w internecie. Niektórzy wolą wybiórczo udostępniać swoje CBU zamiast publikować je otwarcie.
Twoje CBU pozostaje z Tobą tak długo, jak konto pozostaje otwarte. Zmienia się tylko wtedy, gdy zamykasz to konto i otwierasz nowe, lub w rzadkich przypadkach, gdy banki łączą się lub restrukturyzują swoje systemy numeracji. Nawet wtedy banki zazwyczaj zachowują stare CBU przez okres przejściowy, aby uniknąć zakłócania płatności cyklicznych.
Sprawdź aplikację mobilną banku — zazwyczaj znajduje się w sekcji szczegółów konta. Większość argentyńskich banków wyświetla je również wyraźnie w bankowości internetowej, drukuje na wyciągach miesięcznych, a niektóre nawet umieszczają je na odwrocie kart debetowych. Jeśli nie możesz go zlokalizować, każdy przedstawiciel banku może go natychmiast podać; nie jest to informacja wrażliwa jak PIN.
Tak. Otwarcie konta bankowego w Argentynie jako cudzoziemiec daje Ci CBU tak samo jak każdemu innemu posiadaczowi konta. Wymagania różnią się w zależności od instytucji — niektóre banki wymagają tylko paszportu, podczas gdy inne proszą o potwierdzenie miejsca zamieszkania lub CDI (numer identyfikacji podatkowej). Cyfrowe portfele (CVU) są często łatwiejsze dla cudzoziemców w dostępie niż tradycyjne konta bankowe.
Nowoczesne systemy bankowe przeprowadzają walidację formatu przed złożeniem przelewu. Jeśli cyfry kontrolne nie pasują lub długość jest nieprawidłowa, otrzymasz natychmiastowy błąd — przelew nigdy nie opuści Twojego konta. Dlatego tak cenna jest walidacja front-endowa; łapie literówki, zanim spowodują problemy.
Trudniejsza sytuacja ma miejsce, gdy CBU przejdzie walidację formatu, ale nie pasuje do aktywnego konta. Przelew zostaje wysłany do sieci międzybankowej, a następnie wraca po godzinach lub dniach. Już zarejestrowałeś go jako „wysłany" w swoim rozliczeniu i teraz musisz uzgodnić zwrot. Dlatego niektóre aplikacje sprawdzają również CBU względem baz danych banków przed zezwoleniem na przelewy, choć wymaga to płatnego dostępu do API.
Absolutnie. Każde konto generuje własne CBU. Jeśli masz konto bieżące i oszczędnościowe w tym samym banku, będziesz miał dwa odrębne CBU. Różne konta w różnych bankach? Więcej CBU. Każde z nich jednoznacznie identyfikuje konkretne konto w konkretnym oddziale konkretnej instytucji.
Nie, CBU jest specyficzne dla Argentyny. Każdy kraj ma swój własny system: Europa używa IBAN, USA używają numerów routingu plus numerów kont, Australia używa kodów BSB i tak dalej. Przy wysyłaniu pieniędzy za granicę zazwyczaj będziesz potrzebować kodu SWIFT odbiorcy plus jego lokalnego identyfikatora konta — który w przypadku Argentyny byłby CBU.
Aby uzyskać autorytatywne informacje o standardach bankowych Argentyny:
Bank Centralny Argentyny (BCRA) - Przepisy systemu finansowego - Oficjalna dokumentacja BCRA dotycząca standardów systemu płatności i regulacji bankowych
Ustawa nr 25,345 - „Zapobieganie uchylaniu się od opodatkowania i modernizacja płatności" (listopad 2000) - Ustawodawstwo, które ustanowiło ramy elektronicznych systemów płatności w Argentynie
Komunikacja BCRA serii „A" - Techniczne okólniki definiujące wymagania wdrożenia CBU dla instytucji finansowych
Interbanking S.A. - Organizacja obsługująca argentyński międzybankowy elektroniczny system płatności i prowadząca tablice routingu CBU
Źródła te dostarczają specyfikacji technicznych wykorzystanych do wdrożenia tego modułu sprawdzającego i są regularnie aktualizowane przez argentyńskie władze finansowe.
Bez względu na to, czy budujesz integrację płatności, testujesz aplikację fintech, czy uczysz się o argentyńskim systemie bankowym, zrozumienie walidacji CBU jest niezbędne. To narzędzie implementuje dokładnie takie same algorytmy sum kontrolnych, jakich używają argentyńskie banki, więc możesz wychwycić błędy formatowania przed wywołaniem awarii transakcji.
Pamiętaj: walidacja formatu to dopiero pierwszy krok. Poprawnie sformatowane CBU nie gwarantuje, że konto istnieje lub że masz odpowiedniego odbiorcę. W systemach produkcyjnych obsługujących prawdziwe pieniądze połącz walidację formatu z dodatkową weryfikacją za pośrednictwem bankowych interfejsów API lub procesorów płatności.
Narzędzie nie wymaga rejestracji ani instalacji — wystarczy je otworzyć i rozpocząć walidację lub generowanie CBU zgodnie z oficjalnymi standardami BCRA.
Odkryj więcej narzędzi, które mogą być przydatne dla Twojego przepływu pracy