Siirry sisältöön

CBU-generaattori ja -validaattori Argentiinalle | BCRA:n pankkikoodit

Luo ja validoi argentiinalaiset CBU (Clave Bancaria Uniforme) pankkikoodit. Ilmainen työkalu, joka käyttää virallisia BCRA-algoritmeja kehittäjille, testaajille ja rahoitussovelluksille.

Argentiinalaisen CBU:n Luoja & Vahvistaja

Luo satunnainen mutta kelvollinen CBU testausta ja integrointeja varten.

Paina yllä olevaa painiketta luodaksesi kelvollisen CBU:n

Tietoa CBU:sta

CBU (Clave Bancaria Uniforme) on 22-numeroinen koodi, jota käytetään Argentiinassa pankkitilien tunnistamiseen sähköisiä siirtoja ja maksuja varten.

Jokainen CBU sisältää tietoja pankista, konttorista ja tilinumerosta sekä tarkistusnumerot, jotka varmistavat sen kelpoisuuden.

CBU:n Rakenne

Ensimmäinen Lohko (8 numeroa): Pankki- ja Konttorikoodi
XXXXXXXX
Toinen Lohko (14 numeroa): Tilinumero
XXXXXXXXXXXXXX
Latauslaskuri...
📚

Dokumentaatio

Mikä on argentiinalainen CBU ja miksi se kannattaa validoida?

Argentiinan pankkijärjestelmässä toimiminen tarkoittaa CBU:n (Clave Bancaria Uniforme) kanssa työskentelyä - 22-numeroisella koodilla, joka yksilöi jokaisen maan pankkitilin. Jos olet koskaan tarvinnut testata maksun integraatiota, varmistaa pankkitiedot ennen siirtoa tai ymmärtää, miksi tapahtuma epäonnistui, tiedät, kuinka kriittistä on työskennellä oikein muotoiltujen CBU:iden kanssa.

Tämä työkalu auttaa sinua luomaan rakenteellisesti kelvollisia CBU:ita testausympäristöihin ja validoimaan olemassa olevat koodit Argentiinan keskuspankin (BCRA) määrittämää virallista muotoa vasten. Kun rakennat finanssisovelluksia tai käsittelet maksuja, muotovirheiden havaitseminen ajoissa säästää tunteja virheenkorjaukselta ja estää epäonnistuneet tapahtumat.

CBU-muodon ymmärtäminen

CBU (Clave Bancaria Uniforme) on Argentiinan vastine kansainvälisille pankkitunnuksille kuten IBAN tai yhdysvaltalaiset reititysnumerot. Ajattele sitä kattavana pakettina, joka yhdistää pankin, konttorin ja tilin tiedot yhteen 22-numeroiseen koodiin. Argentiinan keskuspankki (BCRA) otti tämän järjestelmän käyttöön marraskuussa 2000 standardisoidakseen sähköiset siirrot maan rahoitusverkostossa.

CBU:n rakenne ja muoto

Jokainen kelvollinen CBU koostuu täsmälleen 22 numerosta, jotka on jaettu kahteen pääryhmään:

  1. Ensimmäinen ryhmä (8 numeroa): Tunnistaa rahoituslaitoksen ja konttorin

    • Ensimmäiset 3 numeroa: BCRA:n määrittämä pankkikoodi
    • Seuraavat 4 numeroa: Pankin konttorin koodi
    • Viimeinen numero: Ensimmäisen ryhmän tarkistenumero
  2. Toinen ryhmä (14 numeroa): Tunnistaa tietyn tilin

    • Ensimmäiset 13 numeroa: Tilinumero (voi sisältää tilin tyypin ja muita tunnisteita)
    • Viimeinen numero: Toisen ryhmän tarkistenumero

Tarkistenumerot käyttävät painotettua modulo-10-algoritmia, joka havaitsee yleiset kirjoitusvirheet - kuten numeromerkkien vaihtumisen tai yhden numeron virheet - ennen rahan siirtoa. Tämä suojamekanismi on osoittautunut hämmästyttävän tehokkaaksi: useimmat CBU:n syöttövirheet havaitaan jo validointivaiheessa sen sijaan, että ne johtaisivat epäonnistuneisiin siirtoihin.

Kuinka Luoda Testaus-CBU

Generaattori luo satunnaisia, mutta rakenteellisesti valideja CBU-tunnuksia, jotka läpäisevät kaikki muotovaatimukset. Tässä mitä tapahtuu kulissien takana:

  1. Satunnaiset numerot täyttävät pankkikoodin, konttoritunnuksen ja tilinumeron osiot
  2. Työkalu laskee molemmat tarkistenumerot virallisella BCRA-algoritmilla
  3. Saat oikein muotoillun 22-numeroisen CBU:n testausta varten

Milloin tästä on hyötyä:

  • Maksuyhdyskäytävien testaaminen: Tarvitsetko kymmeniä valideja CBU-tunnuksia testipatteristoon? Luo ne heti ilman manuaalista laskentaa.
  • QA- ja staging-ympäristöt: Täytä testikannat realistisilla pankkitiedoilla, jotka eivät vahingossa vastaa oikeita tilejä.
  • Muodon oppiminen: Näe, miten eri CBU-tunnukset on rakennettu ja ymmärrä tarkistuslogiikka.
  • Dokumentaatio ja demot: Luo autenttisilta näyttävää esimerkkidataa paljastamatta todellisia pankkitietoja.

Vaihe Vaiheelta: CBU:n Luominen

  1. Siirry työkalun "Generaattori"-välilehdelle
  2. Klikkaa "Luo CBU" -painiketta
  3. Validi, satunnainen 22-numeroinen CBU ilmestyy näyttöalueelle
  4. Käytä "Kopioi"-painiketta kopioidaksesi CBU:n leikepöydälle sovelluksiasi varten

Miten validoidaan argentiinalainen CBU

Validaattori suorittaa samat tarkistukset, joita Argentiinan pankkijärjestelmät käyttävät CBU:n eheyden varmistamiseen. Mitä tarkistetaan:

  1. Pituuden tarkistus: Varmistaa täsmälleen 22 numeroa (yleinen virhe on kopioida välilyöntien tai väliviivojen kanssa)
  2. Vain numeeriset merkit: Varmistaa, ettei mukaan ole päässyt kirjaimia tai erikoismerkkejä
  3. Ensimmäisen lohkon tarkistussumma: Vahvistaa 8. numeron ensimmäisiä 7 numeroa vasten
  4. Toisen lohkon tarkistussumma: Vahvistaa 22. numeron numeroita 9-21 vasten

Kun validointi epäonnistuu, näet, mikä tarkistus ei läpäissyt. Tämä on erityisen hyödyllistä, kun selvitetään, miksi pankkien rajapinta on hylännyt CBU:n - usein kyse on jostain yksinkertaisesta, kuten ylimääräisestä välilyönnistä tai vaihtaneista numeroista.

Vaihe vaiheelta: CBU:n validointi

  1. Siirry työkalun "Validaattori"-välilehdelle
  2. Syötä validoitava 22-numeroinen CBU
  3. Klikkaa "Validoi CBU" -painiketta
  4. Tarkastele validointitulosta:
    • Vihreä ilmaisin kelvollisille CBU:ille
    • Punainen ilmaisin spesifisillä virheviesteillä virheellisille CBU:ille

CBU-todennusalgoritmin selitys

BCRA käyttää painotettua modulo-10-tarkistussumma-algoritmia todennusmerkkien laskemiseen. Jos toteutat CBU-validoinnin sovelluksessasi, tässä on tarkka logiikka:

Ensimmäisen lohkon todentaminen

Ensimmäisen lohkon (ensimmäiset 8 numeroa) todennusmerkki lasketaan seuraavasti:

  1. Ota CBU:n ensimmäiset 7 numeroa
  2. Kerro jokainen numero vastaavalla painokertoimella: [7, 1, 3, 9, 7, 1, 3]
  3. Laske tulojen summa
  4. Laske: 10 - (summa % 10)
  5. Jos tulos on 10, todennusmerkki on 0; muuten se on laskettu arvo

Toisen lohkon todentaminen

Toisen lohkon (viimeiset 14 numeroa) todennusmerkki lasketaan seuraavasti:

  1. Ota toisen lohkon ensimmäiset 13 numeroa
  2. Kerro jokainen numero vastaavalla painokertoimella: [3, 9, 7, 1, 3, 9, 7, 1, 3, 9, 7, 1, 3]
  3. Laske tulojen summa
  4. Laske: 10 - (summa % 10)
  5. Jos tulos on 10, todennusmerkki on 0; muuten se on laskettu arvo

CBU-validointikoodiesimerkit

Näin voit toteuttaa CBU-validoinnin sovelluksessasi. Nämä esimerkit noudattavat virallista BCRA-määritystä ja toimivat tuotantopankkitietojen kanssa:

1// JavaScript: Laske CBU:n tarkistenumero
2function calculateCheckDigit(number, weights) {
3  if (number.length !== weights.length) {
4    throw new Error('Numeron pituuden on vastattava painoarvojen pituutta');
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// Validoi CBU:n ensimmäinen lohko
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

CBU-validoinnin todelliset käyttötapaukset

Maksuintegraatioiden testaaminen

Kun rakennat fintech-sovelluksia tai sähköisen kaupankäynnin alustoja, jotka käsittelevät argentiinalaisia maksuja, tarvitset valideja CBU-tunnuksia testiympäristöösi. Tyypillinen skenaario: staging-ympäristösi vaatii 50 testiTiliä, joilla on validit CBU-tunnukset kuormitustesteihin. Tarkistusmerkkien manuaalinen laskeminen jokaiselle veisi tunteja. Generaattori hoitaa tämän sekunneissa, tarjoten oikein muotoiltuja testidatoja, jotka käyttäytyvät kuin tuotanto-CBU:t ilman riskiä käyttää vahingossa oikeita tilinumerolta.

Vinkki: Pidä joukko generoituja CBU-tunnuksia testiaineistossasi. Tämä varmistaa yhdenmukaisen testidatan koko tiimillesi ja helpottaa virheiden korjausta testien epäonnistuessa.

Transaktiovirheiden estäminen

Näin tyypillisesti käy: asiakas antaa CBU-tunnuksensa rahansiirtoon, mutta on vahingossa lisännyt välilyöntejä tai vaihtanut kaksi numeroa keskenään. Jos käsittelet siirron ilman validointia, pankki hylkää sen - mutta vasta viiveen jälkeen, ja olet jo kirjannut transaktioaikomuksen järjestelmääsi. Nyt joudut käsittelemään täsmäytysongelmia.

CBU-muodon validointi ennen lähettämistä paljastaa nämä virheet heti. Validaattori ei kerro, onko tili olemassa tai kuuluuko se oikealle henkilölle (siihen tarvitaan pankin API-käyttöoikeus), mutta se vahvistaa, että rakenne on BCRA-standardien mukainen.

Pankkiintegraatiovaatimusten ymmärtäminen

Argentiinalaiseen rahoitusjärjestelmään uusille kehittäjille tämä työkalu tarjoaa käytännönläheistä oppimista. Voit nähdä täsmälleen, miten tarkistusmerkit toimivat, ymmärtää, miksi tietyt numerot ovat virheellisiä, ja kokeilla rajatapauksia ennen tuotantokoodin kirjoittamista.

Yleinen virhe: Olettaa, että CBU-validointi on sama kuin IBAN-validointi. Vaikka molemmat käyttävät tarkistusmerkkejä, algoritmit eroavat täysin. Testaaminen tällä työkalulla auttaa ymmärtämään argentiinalaisten pankkikoodien erityisvaatimukset.

Lomakevalidointi pankkien käyttöliittymissä

Suunnitellessasi lomakkeita, jotka hyväksyvät CBU-tunnuksia, sinun täytyy testata, miten järjestelmä käsittelee erilaiset virhetilat. Mitä tapahtuu, kun käyttäjä liittää CBU-tunnuksen, jossa on välilyöntejä? Millainen virheviesti näytetään, kun tarkistusmerkki on väärä? Tämä työkalu auttaa sinua testaamaan näitä skenaarioita ja suunnittelemaan parempaa käyttäjäpalautetta.

Liittyvät pankkitarkistustyökalut

Vaatimuksistasi riippuen saatat tarvita myös näitä täydentäviä työkaluja:

  • CUIT/CUIL-validaattori: Tarkistaa argentiinalaiset verotunnukset—välttämätön, kun tarvitset sekä pankki- että verotunnistuksen
  • CVU-validaattori: Samankaltainen kuin CBU, mutta digitaalisille lompakoille (Mercado Pago, Ualá jne.) käyttäen samaa 22-numeroista muotoa
  • IBAN-validaattori: Rajat ylittäville maksuille, jotka koskevat eurooppalaisia tai muita kansainvälisiä tilejä
  • Pankkien API-palvelut: Tuotantojärjestelmille, jotka tarvitsevat tilin omistajuuden ja saldon tarkistuksen, ei pelkästään muodon validointia

Tärkeä rajoitus: Tämä työkalu tarkistaa vain muodon ja tarkistenumerot. Se ei voi vahvistaa, vastaako CBU aktiivista pankkitiliä tai varmistaa tilin haltijan henkilöllisyyttä. Näitä tarkistuksia varten tarvitset integraation Argentiinan pankkien API:in tai maksunvälittäjiin.

Kuinka Argentiinan pankkijärjestelmä otti käyttöön CBU:n

Ennen marraskuuta 2000 rahojen lähettäminen argentiinalaisissa pankeissa oli yllättävän monimutkaista. Kukin rahoituslaitos käytti omaa tilitunnusjärjestelmäänsä - jotkut 10 numerolla, toiset 15 numerolla, eikä standardoitua tapaa tunnistaa, mikä pankki tai konttori tili omisti. Pankkien väliset siirrot vaativat manuaalista tarkistusta ja veivät usein päiviä käsiteltäessä.

BCRA esitteli CBU:n ratkaistakseen tämän pirstaloitumisen. Määräämällä yhtenäisen 22-numeroisen muodon kaikille rahoituslaitoksille, Argentiina yhdenmukaisesti kansainvälisten standardien, kuten Euroopan IBAN-järjestelmän, kanssa. Upotetut tarkistusnumerot olivat erityisen neroja: ne havaitsevat automaattisesti useimmat tietojen syöttövirheet, vähentäen epäonnistuneita siirtoja ja niihin liittyviä tutkimus- ja peruutuskustannuksia.

Mielenkiintoista: CBU-muoto on pysynyt lähes muuttumattomana yli 20 vuotta. Vaikka pankkiteknologia on kehittynyt dramaattisesti - mobiilisovellukset, välittömät siirrot, digitaaliset lompakot - CBU:n perusrakenne on säilynyt samana. Tämä vakaus kertoo, kuinka hyvin alkuperäinen suunnittelu ennakoi tulevat tarpeet.

Nykyään argentiinalaiset käyttävät CBU:ta käytännössä kaikissa sähköisissä rahoitustapahtumissa: palkanmaksuissa, laskujen maksuissa, veroilmoituksissa, valtion etuuksissa ja verkkokaupassa. Muoto on osoittautunut niin tehokkaaksi, että digitaalisten lompakoiden ilmaantuessa (kuten Mercado Pago) sääntelyviranomaiset omaksuivat saman rakenteen CVU:lle (Clave Virtual Uniforme) sen sijaan, että olisivat keksineet jotain uutta.

Usein Kysytyt Kysymykset

Mikä on ero CBU:n ja CVU:n välillä?

CBU:t yksilöivät perinteiset pankkitilit, kun taas CVU:t (Clave Virtual Uniforme) yksilöivät fintech-palveluntarjoajien kuten Mercado Pago, Ualá tai Brubank digitaalisten lompakoiden tilit. Muoto on identtinen—22 numeroa samalla validointialgoritmilla—mikä on järkevää, koska ne ovat yhteentoimivia. Voit siirtää rahaa CBU:sta CVU:hun ja päinvastoin aivan kuten missä tahansa pankkisiirrossa. Ensimmäiset kolme numeroa paljastavat, onko kyseessä perinteinen pankki vai digitaalisen lompakon tarjoaja.

Voinko selvittää pankin nimen CBU:sta?

Kyllä. Ensimmäiset kolme numeroa ovat pankin tunniste, jonka BCRA on määrännyt. Esimerkiksi koodit, jotka alkavat "011":llä, kuuluvat Banco Naciónille, kun taas "017" viittaa BBVA Argentinaan. BCRA julkaisee virallisen rekisterin näistä koodeista, jota pankkisovellukset tyypillisesti käyttävät näyttääkseen pankin nimen automaattisesti, kun syötät CBU:n.

Onko CBU sama kuin tilinumero?

Ei aivan. Tilinumerosi on upotettu CBU:hun, mutta CBU sisältää sen lisäksi muita reititystietoja. Ajattele sitä kuin eroa katuosoitteen ja GPS-koordinaattien välillä—molemmat yksilöivät sijainnin, mutta toinen sisältää enemmän kontekstia. CBU yhdistää pankkikoodisi, konttorisi koodin, tilinumerosi ja kaksi tarkistusnumeroa yhdeksi siirrettäväksi merkkijonoksi.

Kuinka turvallista on jakaa CBU:ni?

CBU on suunniteltu jaettavaksi—se on koko jutun idea. Vastaanottajat tarvitsevat sen voidakseen tallettaa rahaa tilillesi. Toisin kuin salasanat tai PIN-koodit, CBU sallii vain saapuvat siirrot, ei nostoja. Tästä huolimatta käsittele sitä kuten mitä tahansa taloudellista tietoa: jaa se vain henkilöille tai yrityksille, joihin luotat, ja ole varovainen julkaisemisessa verkossa. Jotkut mieluummin jakavat CBU:nsa valikoivasti kuin julkaisevat sen avoimesti.

Voiko CBU vanhentua tai muuttua?

CBU pysyy muuttumattomana niin kauan kuin tili on auki. Se muuttuu vain, jos suljet kyseisen tilin ja avaat uuden, tai harvinaisissa tapauksissa pankkien fuusioituessa tai uudelleenjärjestäessä numerointijärjestelmiään. Tälläkin hetkellä pankit tyypillisesti säilyttävät vanhan CBU:n siirtymäkauden ajan välttääkseen toistuvia maksuja koskevat häiriöt.

Miten löydän oman CBU:ni?

Tarkista pankkisi mobiilisovellus—se löytyy yleensä tilin tiedoista. Useimmat argentiinalaiset pankit näyttävät sen myös verkkopalvelussa, tulostetuissa tiliotteissa, ja jotkut jopa painattavat sen debit-kortin kääntöpuolelle. Jos et löydä sitä, mikä tahansa pankin edustaja voi antaa sen välittömästi; sitä ei pidetä salaisena tietona kuten PIN-koodia.

Voivatko ulkomaalaiset saada CBU:n Argentiinassa?

Kyllä. Pankkitilin avaaminen Argentiinassa ulkomaalaisena antaa sinulle CBU:n kuten muillekin tilinhaltijoille. Vaatimukset vaihtelevat laitoksittain—jotkut pankit vaativat vain passin, kun taas toiset pyytävät todisteen asumisesta tai CDI:stä (verotunniste). Digitaaliset lompakot (CVU) ovat usein helpommin ulkomaalaisten saatavilla kuin perinteiset pankkitilit.

Mitä tapahtuu, jos teen siirron virheelliseen CBU:hun?

Nykyaikaiset pankkijärjestelmät suorittavat muotovalidoinnin ennen siirron lähettämistä. Jos tarkistusnumerot eivät täsmää tai pituus on väärä, saat välittömästi virheilmoituksen—siirto ei koskaan poistu tililtäsi. Tämä on syy, miksi etukäteisvalidointi on niin arvokasta; se havaitsee kirjoitusvirheet ennen kuin ne aiheuttavat ongelmia.

Hankalampi tilanne on, kun CBU läpäisee muotovalidoinnin, mutta ei vastaa aktiivista tiliä. Siirto lähetetään pankkien väliseen verkkoon, ja se palautuu takaisin tunneissa tai päivissä. Olet jo kirjannut sen "lähetetyksi" kirjanpidossasi, ja nyt sinun täytyy täsmäyttää palautus. Tämän vuoksi jotkin sovellukset myös tarkastavat CBU:t pankkitietokannoista ennen siirtojen sallimista, vaikka se vaatiikin maksullista API-käyttöä.

Voiko minulla olla useita CBU:ita?

Ehdottomasti. Jokainen tili tuottaa oman CBU:nsa. Jos sinulla on sekki- ja säästötili samassa pankissa, sinulla on kaksi eri CBU:ta. Eri tilit eri pankeissa? Lisää CBU:ita. Jokainen niistä yksilöi tietyn tilin tietyssä konttorissa tietyssä laitoksessa.

Käytetäänkö CBU-järjestelmää Argentiinan ulkopuolella?

Ei, CBU:t ovat Argentiinalle ominaisia. Jokaisella maalla on oma järjestelmänsä: Euroopassa käytetään IBAN:ia, Yhdysvalloissa reittausnumeroita plus tilinumeroita, Australiassa BSB-koodeja ja niin edelleen. Kun lähetät rahaa kansainvälisesti, tarvitset yleensä vastaanottajan SWIFT-koodin sekä paikallisen tilin tunnisteen—joka Argentiinassa tapauksessa olisi CBU.

Viitteet ja viralliset dokumentit

Luotettavaa tietoa Argentiinan pankkistandardeista:

  1. Argentiinan Keskuspankki (BCRA) - Rahoitusjärjestelmän säännökset - Virallinen BCRA-dokumentaatio maksujärjestelmän standardeista ja pankkimääräyksistä

  2. Laki nro 25,345 - "Veronkierron estäminen ja maksujen nykyaikaistaminen" (marraskuu 2000) - Lainsäädäntö, joka perusti Argentiinan sähköisten maksujärjestelmien kehyksen

  3. BCRA:n tiedonanto "A"-sarja - Tekniset kiertokirjeet, jotka määrittelevät CBU:n käyttöönoton vaatimukset rahoituslaitoksille

  4. Interbanking S.A. - Organisaatio, joka ylläpitää Argentiinan pankkien välistä sähköistä maksujärjestelmää ja ylläpitää CBU:n reititystaulukoita

Nämä lähteet tarjoavat tekniset määrittelyt, joita käytetään tämän validaattorin toteuttamiseen, ja niitä päivitetään säännöllisesti Argentiinan rahoitusviranomaisten toimesta.

Valmiina validoimaan tai generoimaan CBU-tunnuksia?

Olit sitten rakentamassa maksuintegraatiota, testaamassa fintech-sovellusta tai oppimassa Argentiinan pankkijärjestelmästä, CBU-validoinnin ymmärtäminen on olennaista. Tämä työkalu käyttää täsmälleen samoja tarkistussumma-algoritmeja, joita argentiinalaiset pankit käyttävät, joten voit havaita muotovirheet ennen kuin ne aiheuttavat maksutapahtumien epäonnistumisia.

Muista: muodon validointi on vain ensimmäinen askel. Oikein muotoiltu CBU ei takaa, että tili on olemassa tai että sinulla on oikea vastaanottaja. Tuotantojärjestelmissä, jotka käsittelevät oikeaa rahaa, yhdistä muodon validointi lisävarmenteluun pankkien API-rajapintojen tai maksunvälittäjien kautta.

Työkalu ei vaadi rekisteröintiä tai asennusta - avaa se vain ja ala validoimaan tai generoimaan CBU-tunnuksia virallisten BCRA-standardien mukaisesti.