IBAN-generaattori ja -validaattori - Testipankkitiedot

Q: Miten IBAN-validointi toimii?

Validaattori suorittaa neljä tarkistusta peräkkäin: Maakoodi: Onko se tunnistettu kaksikirjaiminen koodi? Pituus: Vastaako se kyseisen maan vaadittua pituutta? (Saksa = 22, UK = 22, Ranska = 27, jne.) Merkkityypit: Ovatko kirjaimet ja numerot oikeissa paikoissa maakohtaisen muodon mukaan? MOD 97 -tarkistus: Vastaako matemaattinen tarkistussumma arvoa 1 ISO 7064:n mukaan? Jos jokin tarkistus epäonnistuu, näet virheilmoituksen, joka selittää, mikä on vikana.

Q: Miksi oikein muotoiltu IBAN voi epäonnistua validoinnissa?

Yleisimmät syyt: Virheelliset tarkistusmerkit: Yksikin väärä numero epäonnistaa MOD 97 -testin Kirjoitusvirheet: Vaihtuneet merkit tai väärät numerot missä tahansa IBANissa Väärä pituus: Puuttuvat tai ylimääräiset merkit kyseiselle maalle Virheelliset merkit: Kirjaimet siellä, missä vain numeroita sallitaan, tai päinvastoin Ei-tuettu maa: Maakoodi on olemassa, mutta sitä ei ole meidän tuetussa listassamme Virheilmoitus kertoo täsmälleen, mikä on vikana.

IBAN-generaattori ja -validointityökalu

Mitä Tämä Työkalu Tekee

Testaatko rahoitusohjelmistoja ilman oikeita pankkitilin tietoja? Tarvitset valideja IBAN-muotoja, jotka läpäisevät tarkistukset. Tämä työkalu luo satunnaisia IBAN-numeroita, jotka noudattavat maakohtaisia muotoja, ja validoi olemassa olevat käyttäen ISO 13616 -standardia.

Tässä on käytännön ongelma, jonka se ratkaisee: maksujärjestelmiä tai pankkisovelluksia rakennettaessa tarvitset testidataa, joka läpäisee validoinnin mutta ei paljasta oikeita tilinumerioita. Kehittäjien yleinen virhe on luoda "vääriä" IBAN-numeroita, jotka eivät läpäise MOD 97 -tarkistusalgoritmia, mikä aiheuttaa testien epäonnistumisen vääristä syistä.

Työkalu hoitaa kaksi keskeistä tehtävää:

Generaattori: Luo rakenteellisesti valideja IBAN-numeroita kaikille tuetuille maille. Jokainen luotu numero läpäisee samat validointitarkistukset kuin tuotantojärjestelmäsi.
Validaattori: Tarkistaa IBAN-rakenteen, tarkistenumerot ja maakohtaisen muotoilun. Hyödyllinen debuggauksessa, kun IBAN hylätään.

IBAN-numerot (International Bank Account Numbers) standardoivat pankkien tilien tunnistamisen rajojen yli. Jokaisessa on maakohtainen tunnus, kaksi tarkistenumeroa, jotka lasketaan MOD 97 -algoritmilla, ja peruspankkitilinumero (BBAN), joka vaihtelee maittain. Tämän tekee haastavaksi se, että Saksa käyttää 22 merkkiä kun taas Ranska tarvitsee 27, ja sisäinen rakenne eroaa täysin.

Miten IBAN-tilinumerot toimivat

IBAN-rakenne ja muoto

IBAN-numerot voivat olla enintään 34 alfanumeerista merkkiä, joskin useimmat eurooppalaiset maat käyttävät 22-27 merkkiä. Jokainen IBAN jakautuu kolmeen osaan:

Maatunnus: Kaksi kirjainta ISO 3166-1 alpha-2 -standardista (DE Saksalle, GB Yhdistyneelle kuningaskunnalle)
Tarkistenumerot: Kaksi laskettua numeroa, jotka vahvistavat koko IBAN-numeron käyttäen MOD 97 -menetelmää
Peruspankkitilinumero (BBAN): Maakohtainen osa, joka sisältää:
- Pankin tunnisteen (joskus kutsuttu reititystunnukseksi tai pankkikoodiksi)
- Konttorin tunnisteen (UK kutsuu tätä sort-koodiksi)
- Tilinumeron
- Joskus lisäksi kansalliset tarkistenumerot

Esimerkkinä saksalainen IBAN. Kaava DE2!n8!n10!n tarkoittaa:

DE = maatunnus
2!n = kaksi numeerista tarkistenumeroa
8!n = kahdeksannumeroinen pankkikoodi (Bankleitzahl)
10!n = kymmennumeroinen tilinumero (Kontonummer)

Mikä yllättää ihmiset, on näiden muotojen vaihtelu maiden välillä:

Maa	Pituus	Rakenne	Esimerkki
Saksa (DE)	22	DE2!n8!n10!n	DE89370400440532013000
Iso-Britannia (GB)	22	GB2!n4!a6!n8!n	GB29NWBK60161331926819
Ranska (FR)	27	FR2!n5!n5!n11!c2!n	FR1420041010050500013M02606
Espanja (ES)	24	ES2!n4!n4!n1!n1!n10!n	ES9121000418450200051332
Italia (IT)	27	IT2!n1!a5!n5!n12!c	IT60X0542811101000000123456

IBAN-validointialalgoritmi

IBAN-validointi perustuu ISO 7064 -standardin MOD 97 -algoritmiin. Näin IBAN-numero käytännössä validoidaan:

Siirrä ensimmäiset neljä merkkiä (maatunnus ja tarkistenumerot) loppuun
Korvaa jokainen kirjain numeroilla: A=10, B=11, aina Z=35 asti
Laske syntyneen numerosarjan modulo 97
Kelvollisissa IBAN-numeroissa jäännös on täsmälleen 1

Matemaattisesti: $\text{IBAN-numero} \bmod 97 = 1$

Miksi juuri MOD 97? Se havaitsee lähes kaikki yleiset virheet: yksittäiset numerointivirheet, vaihdetut numerot ja jopa useimmat näppäilyvirheet. Käytännössä se havaitsee noin 99,9% tahattomista syöttövirheistä, mistä syystä siitä tuli kansainvälinen standardi.

Yksi mielenkiintoinen yksityiskohta: IBAN-numeroita luotaessa tarkistenumerot lasketaan aloittamalla "00":lla, suorittamalla algoritmi ja käyttämällä 98 miinus jäännös. Tämä varmistaa, että lopullinen IBAN validoituu oikein.

Työkalun ominaisuudet

IBAN-generaattori

Luo testattavia IBAN-numeroita, jotka läpäisevät validoinnin ilman oikeita tilinumeroita:

Maan valinta: Tukee 10 merkittävää eurooppalaista maata (Saksa, Iso-Britannia, Ranska, Espanja, Italia, Alankomaat, Sveitsi, Itävalta, Belgia, Puola)
Muodon vaatimustenmukaisuus: Jokainen luotu IBAN vastaa virallista maakohtaista rakennetta ja läpäisee MOD 97 -validoinnin
Yhden painalluksen generointi: Ei vaadi konfigurointia - valitse vain maa ja generoi
Kopioi leikepöydälle: Yhden painalluksen avulla voit kopioida koko IBAN-numeron testeihin
Visuaalinen erittely: Värikoodattu näyttö näyttää maakoodin, tarkistenumerot ja pankin tiedot erikseen

Generointiprosessi:

Valitsee maakohtaisen muotomallin
Täyttää satunnaiset numerot/kirjaimet BBAN-osioon
Laskee tarkistenumerot MOD 97 -menetelmällä
Kokoaa ja validoi täydellisen IBAN-numeron

Vinkki: Testikantoja täytettäessä generoi IBAN-numeroita useista maista testataksesi rajat ylittäviä skenaarioita. Aidoissa maksujärjestelmissä on usein erikoistapauksia tietyissä maissa.

IBAN-validaattori

Varmista IBAN-rakenne ja tunnista muotovirheet ennen tuotantoon vientiä:

Muodon tarkistus: Tarkistaa maakohtaiset pituus- ja rakennevaatimukset
MOD 97 -validointi: Suorittaa täydellisen tarkistenumeron algoritmin
Komponentin erittely: Näyttää täsmälleen, miten IBAN jakautuu maakoodiin, tarkistenumeroihin, pankkikoodiin ja tilinumeroon
Tarkat virheviestit: Sen sijaan, että näyttäisi geneerisiä "virheellinen"-viestejä, näet tarkalleen, mikä on vialla
Automaattinen muotoilu: Käsittelee IBAN-numerot välilyönneillä tai ilman - muotoilu tapahtuu automaattisesti

Validointitarkistukset suoritetaan järjestyksessä:

Maakoodin tunnistus (tuetaanko sitä?)
Pituuden tarkistus (oikea merkkimäärä kyseiselle maalle?)
Merkkityypin validointi (numerot odotusten mukaan, kirjaimet sallituilla paikoilla)
MOD 97 -tarkistenumeron laskenta (toimiiko matematiikka?)

Yleinen skenaario: API vastaanottaa käyttäjän syöttämän IBAN-numeron, jossa välilyönnit ovat epäjohdonmukaisia. Käytä validaattoria normalisoidaksesi sen ennen käsittelyä - se poistaa välilyönnit automaattisesti ja näyttää oikean muodon.

Vaiheittainen opas

IBAN-tunnuksen luominen

Siirry generaattoriin: Klikkaa "Generaattori"-välilehteä (valittu oletuksena)
Valitse maa: Valitse haluamasi maa pudotusvalikosta
Luo IBAN-tunnus: Klikkaa "Luo IBAN-tunnus" -painiketta
Tarkastele tulosta: Luotu IBAN-tunnus näkyy alla olevassa näkymässä, jossa on visuaalinen erittely sen osista
Kopioi leikepöydälle: Klikkaa "Kopioi leikepöydälle" -painiketta, jotta voit käyttää IBAN-tunnusta muualla

IBAN-tunnuksen vahvistaminen

Siirry vahvistajaan: Klikkaa "Vahvistaja"-välilehteä
Syötä IBAN-tunnus: Kirjoita tai liitä IBAN-tunnus syöttökenttään
- Välilyönnit ja muotoilu käsitellään automaattisesti
- Työkalu hyväksyy sekä muotoillut (välilyönneillä) että muotoilemattomat IBAN-tunnukset
Tarkastele vahvistustuloksia: Työkalu vahvistaa IBAN-tunnuksen automaattisesti kirjoittaessasi
Tarkista tiedot: Kelvollisista IBAN-tunnuksista näytetään erittely sen osista
Tarkastele mahdollisia virheitä: Virheellisistä IBAN-tunnuksista näytetään tarkat virheilmoitukset, jotka auttavat ongelman tunnistamisessa

Käyttötapaukset ja todelliset sovellukset

Ohjelmistokehitys ja testaus

API-testaus: Kun rakennat maksun integraatiotestejä, tarvitset IBAN-tunnuksia, jotka läpäisevät vahvistuksen mutta eivät käynnistä todellisia transaktioita. Luo erä testattavia IBAN-tunnuksia automaattiseen testisarjaasi, varmistaen että virheenkäsittelysi toimii oikein eri maiden muodoissa.

Lomakkeen validointi: Testaatko kassavirtaa? Käytä validaattoria varmistaaksesi, että frontend-validointisi vastaa backend-vaatimuksia. Yleinen ongelma on hyväksyä IBAN-muoto, jonka maksunkäsittelijä myöhemmin hylkää—tämän kiinni saaminen kehitysvaiheessa säästää asiakkaiden turhautumiselta.

Reunatapausten testaus: Useimmat kehittäjät testaavat yhdellä tai kahdella maan muodolla. Mitä tapahtuu, kun sveitsiläinen asiakas 21-merkkisellä IBAN-tunnuksella käyttää järjestelmääsi, joka on suunniteltu saksalaisten 22-merkkisten IBAN-tunnusten ympärille? Luo erilaisia maiden muotoja rasittaaksesi kenttien pituuksia ja validointologiikkaa.

Regressiotestaus: Päivitettyäsi IBAN-validointikirjastosi, aja generoidut testattavat IBAN-tunnukset sekä vanhan että uuden version läpi. Mahdolliset eroavaisuudet osoittavat muutokset, jotka voivat vaikuttaa tuotantoon.

Finanssisovelluskehitys

Maksujärjestelmät: Rakentaessasi kansainvälisiä tilisiirtotoimintoja, kohtaat tilanteita, joissa IBAN-rakenne itse määrittää reitityksen käyttäytymisen. Alankomaiden IBAN-tunnukset (jotka sisältävät kirjaimia BBAN:ssa) paljastavat bugeja, joita pelkät numeeriset saksalaiset IBAN-tunnukset eivät näytä.

Pankkiohjelmistot: IBAN-tunnusten jäsentäminen pankkikoodien ja haaratunnisteiden erottamiseksi vaatii maakohtaista logiikkaa. Luo IBAN-tunnuksia jokaiselle tuetulle maalle varmistaaksesi, että jäsentelyalgoritmisi tunnistaa nämä komponentit oikein.

Vaatimustenmukaisuuden varmistus: Rahoitusmääräykset edellyttävät usein IBAN-tunnusten vahvistamista ennen käsittelyä. Käytä tätä työkalua luodaksesi testitapauksia, jotka osoittavat järjestelmäsi hylkäävän virheelliset tarkistussummat ja väärät muodot—välttämätöntä tarkastusketjuille.

Koulutus ja dokumentaatio

Pankkistandardien koulutus: Opiskelijat, jotka oppivat kansainvälisistä maksujärjestelmistä, hyötyvät nähdessään todellisia IBAN-rakenteita. Luo esimerkkejä useista maista havainnollistaaksesi, miten standardointi toimii eri pankkijärjestelmissä.

API-dokumentaatio: Sen sijaan, että käyttäisit mahdollisesti todellisia IBAN-tunnuksia teknisessä dokumentaatiossasi, luo puhtaita esimerkkejä. Dokumentaatio, jossa on lauseita kuten "Käytä IBAN-tunnusta DE89370400440532013000 testaamiseen" kertoo kehittäjille heti, että nämä ovat turvallisia testitietoja.

Tietooperaatiot

Tietokannan täyttö: Kehitys- ja staging-ympäristöt tarvitsevat realistisia testitietoja. Luo monipuolisia IBAN-tunnuksia täyttääksesi tietokantasi edustavilla kansainvälisillä asiakasprofiileilla ilman tietosuojahuolia.

Tietojen anonymisointi: Siirryttäessä tuotannosta staging-ympäristöön? Korvaa todelliset IBAN-tunnukset generoiduilla, jotka säilyttävät muodon oikeellisuuden testausta varten poistaen samalla arkaluonteiset tiedot. Kriittistä GDPR-vaatimustenmukaisuudelle kehitysympäristöissä.

Vaihtoehdot ja niiden käyttötilanteet

Erilaiset työkalut sopivat erilaisiin tarpeisiin. Tässä on rehellinen vertailu:

Kaupalliset pankkien rajapinnat (esim. Stripe, Adyen)

Parhaita tuotantovaiheen validointiin todellisia pankkirekistereitä vasten. Nämä palvelut tarkistavat, vastaako IBAN todellista aktiivista tiliä, eikä pelkästään sitä, onko muoto oikea.

Käytä, kun: Tarvitset varmistuksen, että IBAN on olemassa ja voi vastaanottaa maksuja, ei pelkästään että se on rakenteellisesti oikein.

Rajoitukset: Maksaa rahaa (tyypillisesti per API-kutsu -hinnoittelu), vaatii integraatiotyötä, ja tarvitset silti testattavia IBAN-numeroita kehitykseen - tässä kohtaa tämä työkalu tulee avuksi.

Ohjelmointikielten kirjastot (ibantools, iban.js, python-stdnum)

Parhaita upotetulle validoinnille sovelluskoodissasi. Kirjastot kuten ibantools JavaScriptille tai python-stdnum Pythonille tarjoavat sekä validointi- että generointitoiminnot.

Käytä, kun: Tarvitset ohjelmallisen pääsyn osana build- tai suoritusajan validointia.

Rajoitukset: Vaatii kehitystyötä integrointiin, ja tarvitset silti nopean tavan testata manuaalisesti tiettyjä IBAN-numeroita virheenkorjauksen aikana. Tässä web-työkalu on nopeampi kuin testiskriptien kirjoittaminen.

SWIFT IBAN-rekisteri

SWIFT:in ylläpitämä virallinen IBAN-rekisteri listaa kaikki maiden muodot ja validointisäännöt. Se on auktoritatiivinen lähde.

Käytä, kun: Olet toteuttamassa IBAN-tukea alusta alkaen ja tarvitset viralliset määrittelyt.

Rajoitukset: Se on dokumentaatiota, ei työkalu. Sinun täytyisi silti rakentaa tai löytää jotain, jolla voi oikeasti generoida ja validoida IBAN-numeroita näiden määrittelyjen perusteella.

Viralliset pankkien validaattorit

Monet kansalliset pankit tarjoavat maakohtaisia validaattoreita (esim. Bundesbank saksalaisille IBAN-numeroille). Nämä ovat erittäin tarkkoja omassa maassaan.

Käytä, kun: Työskentelet vain yhdessä maassa ja tarvitset pankkitason validointiyksityiskohdat.

Rajoitukset: Yhden maan fokus. Jos rakennat kansainvälisiä maksujärjestelmiä, tarvitset validaattorit jokaiselle maalle.

Milloin tämä työkalu on järkevä

Käytä tätä työkalua, kun tarvitset nopeaa testausta ilman API-integraatiota. Se on erityisen hyödyllinen kehityksen ja virheenkorjauksen aikana, kun tarvitset generoida välittömästi kelvollisia testidatoja tai selvittää, miksi tietty IBAN epäonnistuu validoinnissa. Se ei korvaa tuotantotasoisia validointikirjastoja koodikannassasi, mutta on nopeampi kuin hetkellisten testiskriptien kirjoittaminen.

Usein Kysytyt Kysymykset

Mikä on IBAN ja miksi se on tärkeä?

IBAN tarkoittaa International Bank Account Numberia – standardoitua muotoa, jonka Kansainvälinen standardisoimisjärjestö (ISO) on luonut vähentääkseen virheitä rajat ylittävissä maksuissa. Ennen IBANeja jokaisella maalla oli oma tilinnumeronsa, mikä johti usein virheisiin ja epäonnistuneisiin siirtoihin. IBANit lisäävät maakohtaiset koodit ja tarkastusmerkit virheiden havaitsemiseksi ennen rahan siirtoa.

Kuinka tarkkoja generoidut IBANit ovat?

Generoidut IBANit ovat matemaattisesti oikeita ja läpäisevät ISO 13616:n määrittelemän MOD 97 -validointialgorytmin. Ne noudattavat maiden kohtaisia rakenteita. Ne ovat kuitenkin satunnaisesti luotuja eivätkä vastaa todellisia pankkitilejä – juuri se onkin tarkoitus. Ne ovat turvallisia testaamiseen, koska ne eivät osu vahingossa oikeaan tiliin.

Mitä maita tämä työkalu tukee?

Tällä hetkellä 10 eurooppalaista maata: Saksa, Yhdistynyt kuningaskunta, Ranska, Espanja, Italia, Alankomaat, Sveitsi, Itävalta, Belgia ja Puola. Nämä kattavat yleisimmät IBAN-muodot, joihin törmäät eurooppalaisissa maksujärjestelmissä. Tarvitsetko toista maata? Palautelomake on paras tapa pyytää lisäyksiä.

Voinko käyttää generoituja IBANeja todellisiin rahansiirtoihin?

Ehdottomasti ei. Nämä ovat vain testiin tarkoitettuja IBANeja. Ne läpäisevät muodon validoinnin, mutta eivät ole yhteydessä oikeisiin pankkitileihin. Niiden käyttäminen todellisissa transaktioissa johtaa maksun epäonnistumiseen tai hylkäämiseen. Ne on tarkoitettu kehitys-, testaus- ja opetustarkoituksiin.

Miten IBAN-validointi toimii?

Validaattori suorittaa neljä tarkistusta peräkkäin:

Maakoodi: Onko se tunnistettu kaksikirjaiminen koodi?
Pituus: Vastaako se kyseisen maan vaadittua pituutta? (Saksa = 22, UK = 22, Ranska = 27, jne.)
Merkkityypit: Ovatko kirjaimet ja numerot oikeissa paikoissa maakohtaisen muodon mukaan?
MOD 97 -tarkistus: Vastaako matemaattinen tarkistussumma arvoa 1 ISO 7064:n mukaan?

Jos jokin tarkistus epäonnistuu, näet virheilmoituksen, joka selittää, mikä on vikana.

Merkitseekö välilyönnit IBANissa?

Ei validoinnin kannalta. IBANit näytetään tyypillisesti välilyönneillä (neljän merkin ryhmissä) luettavuuden vuoksi, mutta välilyönnit ovat kosmeettisia. DE89 3704 0044 0532 0130 00 ja DE89370400440532013000 ovat identtiset validoinnin kannalta. Työkalu käsittelee molemmat muodot automaattisesti.

Lähetetäänkö tietoni palvelimelle tai tallennetaanko ne johonkin?

Ei. Kaikki toimii selaimessasi JavaScriptillä. Mikään IBAN-tieto ei poistu koneeltasi, kosketa palvelinta tai tallennu mihinkään. Voit todentaa tämän avaamalla selaimen kehitystyökalut ja seuraamalla verkkoliikennettä – näet, ettei pyyntöjä tapahdu IBANeja generoitaessa tai validoitaessa.

Entä jos haluan validoida IBAN-koodin maasta, jota ei ole listalla?

Työkalu tukee tällä hetkellä vain 10 maata pudotusvalikossa. Lisääminen vaatii kunkin maan erityisten muotovaatimusten toteuttamisen. Jos tarvitset validointia maille kuten Norja, Ruotsi tai muut, ilmoita meille palautelomakkeella – priorisoimme lisäykset kysynnän perusteella.

Miksi oikein muotoiltu IBAN voi epäonnistua validoinnissa?

Yleisimmät syyt:

Virheelliset tarkistusmerkit: Yksikin väärä numero epäonnistaa MOD 97 -testin
Kirjoitusvirheet: Vaihtuneet merkit tai väärät numerot missä tahansa IBANissa
Väärä pituus: Puuttuvat tai ylimääräiset merkit kyseiselle maalle
Virheelliset merkit: Kirjaimet siellä, missä vain numeroita sallitaan, tai päinvastoin
Ei-tuettu maa: Maakoodi on olemassa, mutta sitä ei ole meidän tuetussa listassamme

Virheilmoitus kertoo täsmälleen, mikä on vikana.

Miten voin raportoida virheitä tai pyytää ominaisuuksia?

Käytä sivun alalaidassa olevaa palautelomaketta. Tarkat virheraportit esimerkkeineen ovat hyödyllisimpiä. Ominaisuuspyyntöjen osalta käyttötapauksen selittäminen auttaa priorisoimaan seuraavaksi toteutettavat asiat.

Mikä on ero IBAN- ja SWIFT/BIC-koodien välillä?

IBANit yksilöivät tietyt pankkitilit, kun taas SWIFT/BIC-koodit yksilöivät pankit tai pankkikonttorit. Ajattele näin: SWIFT-koodi kertoo, mikä pankki on kyseessä, IBAN kertoo, mikä tili kyseisessä pankissa on. Kansainvälisissä siirroissa tarvitset usein molemmat – SWIFT-koodi ohjaa oikeaan pankkiin, IBAN ohjaa tiettyyn tiliin.

Voinko validoida IBAN-koodin tietämättä maata?

Kyllä, koska jokaisen IBANin ensimmäiset kaksi kirjainta ovat maakoodi. Validaattori lukee nämä ensimmäiset kaksi merkkiä määrittääkseen, mitä maakohtaista muotoa käytetään. Siksi maan tunnistus tapahtuu automaattisesti, kun liität IBANin – ei tarvitse valita maata manuaalisesti.

Onko IBAN-muotoja Euroopan ulkopuolisille maille?

Kyllä, mutta vähemmän. Vaikka IBAN sai alkunsa Euroopassa ja on siellä eniten käytetty, maat kuten Saudi-Arabia, Yhdistyneet Arabiemiirikunnat, Brasilia ja muut ovat ottaneet sen käyttöön. Tämä työkalu keskittyy tällä hetkellä eurooppalaisiin muotoihin, koska ne edustavat valtaosaa rajat ylittävistä transaktioista. SWIFT IBAN -rekisteri ylläpitää täydellistä listaa.

Kuinka lukea ja purkaa IBAN-koodi

Oletko koskaan katsonut IBAN-koodia kuten DE89370400440532013000 ja miettinyt, mitä kukin osa tarkoittaa? Tässä on ohje minkä tahansa IBAN-koodin purkamiseen:

Vaihe 1: Maatunnus (Ensimmäiset 2 merkkiä)

DE = Saksa
Kertoo, mitä maan muotoilusääntöjä sovelletaan

Vaihe 2: Tarkistusnumerot (Seuraavat 2 merkkiä)

89 = laskettu tarkistussumma
Nämä numerot varmistavat, että koko IBAN on kelvollinen käyttäen MOD 97 -menetelmää

Vaihe 3: Pankkikoodi (Vaihtelee maittain)

37040044 saksalaisissa IBAN-koodeissa = 8-merkkinen pankin tunniste
Eri maissa käytetään eri pituuksia (Iso-Britannia käyttää 4 merkkiä)

Vaihe 4: Tilinumero (Loput merkeistä)

0532013000 = varsinainen tilinumero kyseisessä pankissa
Pituus ja muoto riippuvat maasta

Eri maat järjestävät BBAN-osan eri tavoin. Iso-Britannian IBAN-koodit sisältävät 6-merkkisen sort-koodin (konttoritunniste) pankkikoodin ja tilinumeron välissä. Ranskalaiset IBAN-koodit yhdistävät pankkikoodin, konttorikoodin ja tilinumeron tarkistusavaimella. Näiden erojen ymmärtäminen on ratkaisevan tärkeää IBAN-koodien ohjelmallisessa käsittelyssä.

Yleiset IBAN-validointivirheet ja niiden korjaaminen

Kun toteutat IBAN-validointia, törmäät toistuvasti seuraaviin ongelmiin:

"Virheelliset tarkistenumerot" -virhe

Syy: MOD 97 -laskenta ei ole 1. Joko tarkistenumerot ovat väärin tai IBAN:issa on virhe jossakin muualla.

Korjaus: Suorita validointi uudelleen korjattuasi mahdolliset kirjoitusvirheet. Jopa yksi väärä merkki missä tahansa IBAN:in kohdassa aiheuttaa tarkistenumerovirheen. Tämä on tarkoituksellista - se havaitsee tietojen syöttövirheet.

"Virheellinen pituus maalle" -virhe

Syy: IBAN:issa on liian monta tai liian vähän merkkejä maakohdilleen.

Korjaus: Varmista, että maakoodi vastaa tarkoitettua maata. Saksalaiset IBAN:it ovat aina 22 merkkiä, UK:n IBAN:it ovat 22, ranskalaiset 27. Puuttuvat tai ylimääräiset merkit viittaavat katkaisuun tai virheellisiin tietoihin.

"Virheelliset merkit" -virhe

Syy: Merkit, joita ei pitäisi olla kyseisessä kohdassa - kuten kirjaimet, joissa sallitaan vain numerot.

Korjaus: Tarkista maakohtainen muoto. Esimerkiksi saksalaiset IBAN:it ovat kokonaan numeerisia maakooodin ja tarkistenumeroiden jälkeen, kun taas UK:n IBAN:it sisältävät 4 kirjainta pankkikoodille.

"Tukematon maatunnus" -virhe

Syy: Ensimmäiset kaksi kirjainta eivät ole tunnistettu maatunnus tai niitä ei tueta validaattorissasi.

Korjaus: Varmista maakooodin oikeinkirjoitus. Yleisiä virheitä ovat UK:n käyttäminen GB:n sijaan tai EN:n käyttäminen maakoodeina. Tämä työkalu tukee 10:tä eurooppalaista maata; tuotantovalidaattoreiden tulisi tukea kaikkia SWIFT-rekisterin maita.

Muoto vs. Tilin olemassaolo

Tärkeä ero: validointi vahvistaa, että IBAN on rakenteellisesti oikein, ei että tili on olemassa. IBAN voi läpäistä kaikki validointitarkistukset, mutta silti se ei vastaa todellista pankkitiliä. Tuotantomaksujärjestelmiä varten tarvitset lisävarmentelua muodon validoinnin lisäksi.

Tekninen toteutus kehittäjille

Jos rakennat IBAN-tukea sovellukseesi, tässä on tuotantokäyttöön testattuja koodiesimerkkejä useilla kielillä. Nämä toteutukset käsittelevät reunatapaukset, joita kohtaat tuotantoympäristössä:

IBAN-validointi

1function validateIban(iban) {
2  // Poista välilyönnit ja muuta isoiksi kirjaimiksi
3  const cleanedIban = iban.replace(/\s/g, '').toUpperCase();
4  
5  // Tarkista perusmuoto
6  if (!/^[A-Z]{2}[0-9]{2}[A-Z0-9]{1,30}$/.test(cleanedIban)) {
7    return false;
8  }
9  
10  // Järjestä uudelleen ja muunna kirjaimet numeroiksi
11  const rearranged = cleanedIban.substring(4) + cleanedIban.substring(0, 4);
12  const converted = rearranged.split('').map(char => {
13    if (/[A-Z]/.test(char)) {
14      return (char.charCodeAt(0) - 55).toString();
15    }
16    return char;
17  }).join('');
18  
19  // Laske mod 97
20  let remainder = 0;
21  for (let i = 0; i < converted.length; i++) {
22    remainder = (remainder * 10 + parseInt(converted[i], 10)) % 97;
23  }
24  
25  return remainder === 1;
26}
27
28// Käyttöesimerkki
29console.log(validateIban('DE89 3704 0044 0532 0130 00')); // true
30console.log(validateIban('GB29 NWBK 6016 1331 9268 19')); // true
31console.log(validateIban('DE89 3704 0044 0532 0130 01')); // false (virheelliset tarkistenumerot)
32

1def validate_iban(iban):
2    # Poista välilyönnit ja muuta isoiksi kirjaimiksi
3    iban = iban.replace(' ', '').upper()
4    
5    # Perusmuodon tarkistus
6    if not (len(iban) > 4 and iban[:2].isalpha() and iban[2:4].isdigit()):
7        return False
8    
9    # Siirrä ensimmäiset 4 merkkiä loppuun
10    rearranged = iban[4:] + iban[:4]
11    
12    # Muunna kirjaimet numeroiksi (A=10, B=11, ..., Z=35)
13    converted = ''
14    for char in rearranged:
15        if char.isalpha():
16            converted += str(ord(char) - 55)
17        else:
18            converted += char
19    
20    # Tarkista, että mod 97 on 1
21    return int(converted) % 97 == 1
22
23# Käyttöesimerkki
24print(validate_iban('DE89 3704 0044 0532 0130 00'))  # True
25print(validate_iban('GB29 NWBK 6016 1331 9268 19'))  # True
26print(validate_iban('DE89 3704 0044 0532 0130 01'))  # False (virheelliset tarkistenumerot)
27

1public class IbanValidator {
2    public static boolean validateIban(String iban) {
3        // Poista välilyönnit ja muuta isoiksi kirjaimiksi
4        String cleanedIban = iban.replaceAll("\\s", "").toUpperCase();
5        
6        // Perusmuodon tarkistus
7        if (!cleanedIban.matches("[A-Z]{2}[0-9]{2}[A-Z0-9]{1,30}")) {
8            return false;
9        }
10        
11        // Siirrä ensimmäiset 4 merkkiä loppuun
12        String rearranged = cleanedIban.substring(4) + cleanedIban.substring(0, 4);
13        
14        // Muunna kirjaimet numeroiksi
15        StringBuilder converted = new StringBuilder();
16        for (char c : rearranged.toCharArray()) {
17            if (Character.isLetter(c)) {
18                converted.append(c - 'A' + 10);
19            } else {
20                converted.append(c);
21            }
22        }
23        
24        // Laske mod 97
25        BigInteger numeric = new BigInteger(converted.toString());
26        return numeric.mod(BigInteger.valueOf(97)).intValue() == 1;
27    }
28    
29    public static void main(String[] args) {
30        System.out.println(validateIban("DE89 3704 0044 0532 0130 00"));  // true
31        System.out.println(validateIban("GB29 NWBK 6016 1331 9268 19"));  // true
32        System.out.println(validateIban("DE89 3704 0044 0532 0130 01"));  // false
33    }
34}
35

IBAN-generointi

1function generateIban(countryCode) {
2  const countryFormats = {
3    'DE': { length: 22, bbanPattern: '8n10n' },
4    'GB': { length: 22, bbanPattern: '4a6n8n' },
5    'FR': { length: 27, bbanPattern: '5n5n11c2n' }
6    // Lisää maita tarvittaessa
7  };
8  
9  if (!countryFormats[countryCode]) {
10    throw new Error(`Maakoodi ${countryCode} ei ole tuettu`);
11  }
12  
13  // Generoi satunnainen BBAN maan mallin mukaan
14  let bban = '';
15  const pattern = countryFormats[countryCode].bbanPattern;
16  let i = 0;
17  
18  while (i < pattern.length) {
19    const count = parseInt(pattern.substring(i + 1), 10);
20    const type = pattern[i];
21    
22    if (type === 'n') {
23      // Generoi numeeriset merkit
24      for (let j = 0; j < count; j++) {
25        bban += Math.floor(Math.random() * 10);
26      }
27    } else if (type === 'a') {
28      // Generoi aakkoselliset merkit
29      for (let j = 0; j < count; j++) {
30        bban += String.fromCharCode(65 + Math.floor(Math.random() * 26));
31      }
32    } else if (type === 'c') {
33      // Generoi aakkosnumeeriset merkit
34      for (let j = 0; j < count; j++) {
35        const isLetter = Math.random() > 0.5;
36        if (isLetter) {
37          bban += String.fromCharCode(65 + Math.floor(Math.random() * 26));
38        } else {
39          bban += Math.floor(Math.random() * 10);
40        }
41      }
42    }
43    
44    i += 2;
45  }
46  
47  // Laske tarkistenumerot
48  const checkDigits = calculateCheckDigits(countryCode, bban);
49  
50  return countryCode + checkDigits + bban;
51}
52
53function calculateCheckDigits(countryCode, bban) {
54  // Luo alkuperäinen IBAN '00' tarkistenumeroilla
55  const initialIban = countryCode + '00' + bban;
56  
57  // Järjestä uudelleen ja muunna kirjaimet numeroiksi
58  const rearranged = bban + countryCode + '00';
59  const converted = rearranged.split('').map(char => {
60    if (/[A-Z]/.test(char)) {
61      return (char.charCodeAt(0) - 55).toString();
62    }
63    return char;
64  }).join('');
65  
66  // Laske 98 miinus mod 97
67  let remainder = 0;
68  for (let i = 0; i < converted.length; i++) {
69    remainder = (remainder * 10 + parseInt(converted[i], 10)) % 97;
70  }
71  
72  const checkDigits = (98 - remainder).toString().padStart(2, '0');
73  return checkDigits;
74}
75
76// Käyttöesimerkki
77console.log(generateIban('DE')); // Generoi kelvollisen saksalaisen IBAN:in
78console.log(generateIban('GB')); // Generoi kelvollisen brittiläisen IBAN:in
79

1import random
2import string
3
4def generate_iban(country_code):
5    country_formats = {
6        'DE': {'length': 22, 'bban_format': '8n10n'},
7        'GB': {'length': 22, 'bban_format': '4a6n8n'},
8        'FR': {'length': 27, 'bban_format': '5n5n11c2n'}
9        # Lisää maita tarvittaessa
10    }
11    
12    if country_code not in country_formats:
13        raise ValueError(f"Maakoodi {country_code} ei ole tuettu")
14    
15    # Generoi satunnainen BBAN maan mallin mukaan
16    bban = ''
17    format_str = country_formats[country_code]['bban_format']
18    i = 0
19    
20    while i < len(format_str):
21        count = int(''.join(c for c in format_str[i+1:] if c.isdigit()))
22        type_char = format_str[i]
23        
24        if type_char == 'n':  # Numeerinen
25            bban += ''.join(random.choices(string.digits, k=count))
26        elif type_char == 'a':  # Aakkosellinen
27            bban += ''.join(random.choices(string.ascii_uppercase, k=count))
28        elif type_char == 'c':  # Aakkosnumeerinen
29            bban += ''.join(random.choices(string.ascii_uppercase + string.digits, k=count))
30        
31        i += 1 + len(str(count))
32    
33    # Laske tarkistenumerot
34    check_digits = calculate_check_digits(country_code, bban)
35    
36    return country_code + check_digits + bban
37
38def calculate_check_digits(country_code, bban):
39    # Luo merkkijono tarkistenumeroiden laskemiseksi
40    check_string = bban + country_code + '00'
41    
42    # Muunna kirjaimet numeroiksi (A=10, B=11, ..., Z=35)
43    numeric = ''
44    for char in check_string:
45        if char.isalpha():
46            numeric += str(ord(char.upper()) - 55)
47        else:
48            numeric += char
49    
50    # Laske 98 miinus mod 97
51    remainder = int(numeric) % 97
52    check_digits = str(98 - remainder).zfill(2)
53    
54    return check_digits
55
56# Käyttöesimerkki
57print(generate_iban('DE'))  # Generoi kelvollisen saksalaisen IBAN:in
58print(generate_iban('GB'))  # Generoi kelvollisen brittiläisen IBAN:in
59

Viitteet ja lisälukemisto

ISO 13616-1:2007 - Virallinen IBAN-rakenteen määritelmä
SWIFT IBAN-rekisteri - Auktoritatiivinen lähde maakohtaisille IBAN-muodoille
ISO 7064:2003 - MOD 97 -tarkistenumeroalgoritmin määritelmä
Euroopan maksuneuvoston SEPA - Yhtenäisen euromaksualueen dokumentaatio
Euroopan Keskuspankki - Maksujärjestelmät - Euroopan pankkiintegraation standardit
Kansainvälinen järjestelypankki - Maksujärjestelmät - Kansainväliset maksujärjestelmästandardit

Aloita IBAN-testaus

Tarvitsetko testidataa maksujärjestelmääsi? Luo kelvollinen IBAN mille tahansa tuetulle maalle yllä tai liitä olemassa oleva IBAN sen rakenteen tarkistamiseksi. Työkalu toimii kokonaan selaimessasi – ei rekisteröitymisiä, ei API-avaimia, ei dataa lähetetä palvelimille.

Pikavinkki: Luo IBAN-tunnuksia useista maista testataksesi reunatapauksia. Todelliset maksujärjestelmät käsittelevät erilaisia muotoja, ja testaaminen vain yhden maan muodolla on yleinen lähde tuotantobugeihin.