CINXE.COM

<!DOCTYPE html>  <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="fi" lang="fi"> <head> <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />  <title>IBAN-laskenta-API:n dokumentaatio</title> <meta name="description" content="IBAN-laskuri muuntaa kansainväliset pankkikoodit ja tilinumerot kansainvälisiksi tilinumeroiksi (IBAN)" /> <meta name="keywords" content="iban, laskenta, api, dokumentaatio, ohjelmointirajapinta" /> <meta name="theme-color" content="#153570"> <meta name="apple-mobile-web-app-status-bar-style" content="#153570"> <meta name="MobileOptimized" content="width" /> <meta name="HandheldFriendly" content="true" /> <meta name="viewport" content="width=device-width, initial-scale=1"> <link href="https://www.iban.fi/calculation-api" rel="canonical"> <link rel="stylesheet" type="text/css" href="/stylesheets/bootstrap.css" > <link rel="stylesheet" type="text/css" href="/stylesheets/style.css"> <link rel="stylesheet" type="text/css" href="/stylesheets/shortcodes.css"> <link rel="stylesheet" type="text/css" href="/stylesheets/newcustom.css"> <link rel="stylesheet" type="text/css" href="/stylesheets/responsive.css"> <link rel="stylesheet" type="text/css" href="/stylesheets/animate.css"> <link rel="stylesheet" type="text/css" href="/stylesheets/font-awesome.css"> <link rel="stylesheet" type="text/css" href="/stylesheets/jquery.fancybox.css"> <style> @media print { .fa-print,.fa-exclamation-circle{display:none}.flat-general.sidebar-right .flat-wrapper .general{border-right:none}.topheader{display:none}header{display:none}.general-sidebar{display:none}.flat-general .general{width:100%}#form{display:none}.serviceinfohelp{display:none}.pricing a{display:none}.reportproblem{display:none}#form1{display:none}.flat-title-button h3,.help{display:none}.footer-widgets,.content-bottom-widgets,.footer-content .copyright a{display:none;clear:both}} </style> </head> <body> <div class="boxed"> <div class="topheader"> <div class="container"> <div class="row"> <div class="col-md-6"> <div class="top-navigator pull-left"> <ul> <li ><a href="https://www.iban.com/contact" title="Contact Us" class="no-border"><i class="fa fa-envelope"></i> Ota yhteyttä</a></li> </ul> </div> </div> <div class="col-md-6"> <div class="top-navigator pull-right"> <ul> <li class="hidden-xs"><a href="#" class="language"><img src="/images/icon/blank.png" class="flag flag-fi" width="16" height="11" alt="fi"> FI</a> <ul> <li><a href="https://www.iban.com/" title="English" data-lang-id="en"><img src="/images/icon/blank.png" class="flag flag-gb" width="16" height="11" alt="en"> English</a></li> <li><a href="https://de.iban.com/" title="Deutsch" data-lang-id="de_DE"><img src="/images/icon/blank.png" class="flag flag-de" width="16" height="11" alt="de"> Deutsch</a></li> <li><a href="https://fr.iban.com/" title="Français" data-lang-id="fr_FR"><img src="/images/icon/blank.png" class="flag flag-fr" width="16" height="11" alt="fr"> Français</a></li> <li><a href="https://it.iban.com/" title="Italiano" data-lang-id="it_IT"><img src="/images/icon/blank.png" class="flag flag-it" width="16" height="11" alt="it"> Italiano</a></li> <li><a href="https://nl.iban.com/" title="Dutch" data-lang-id="nl_NL"><img src="/images/icon/blank.png" class="flag flag-nl" width="16" height="11" alt="nl"> Dutch</a></li> <li><a href="https://es.iban.com/" title="Español" data-lang-id="es_ES"><img src="/images/icon/blank.png" class="flag flag-es" width="16" height="11" alt="es"> Español</a></li> <li><a href="https://pt.iban.com/" title="Português" data-lang-id="pt_PT"><img src="/images/icon/blank.png" class="flag flag-pt" width="16" height="11" alt="pt"> Português</a></li> <li><a href="https://www.iban.pl/" title="Polski" data-lang-id="pl"><img src="/images/icon/blank.png" class="flag flag-pl" width="16" height="11" alt="pl"> Polski</a></li> <li><a href="https://www.iban.se/" title="Svenska" data-lang-id="sv"><img src="/images/icon/blank.png" class="flag flag-se" width="16" height="11" alt="sv"> Svenska</a></li>  <li><a href="https://www.iban.dk/" title="Dansk" data-lang-id="da"><img src="/images/icon/blank.png" class="flag flag-dk" width="16" height="11" alt="da"> Dansk</a></li> <li><a href="https://www.iban.co.no/" title="Norsk" data-lang-id="no"><img src="/images/icon/blank.png" class="flag flag-no" width="16" height="11" alt="no"> Norsk</a></li> <li><a href="https://www.iban.hu/" title="Magyar" data-lang-id="hu"><img src="/images/icon/blank.png" class="flag flag-hu" width="16" height="11" alt="hu"> Magyar</a></li> <li><a href="https://www.iban.gr/" title="Eλληνική" data-lang-id="el"><img src="/images/icon/blank.png" class="flag flag-gr" width="16" height="11" alt="el"> Eλληνική</a></li> <li><a href="https://www.iban.cz/" title="Čeština" data-lang-id="cs"><img src="/images/icon/blank.png" class="flag flag-cz" width="16" height="11" alt="cs"> Čeština</a></li> <li><a href="https://www.iban.si/" title="Slovenščina" data-lang-id="sv"><img src="/images/icon/blank.png" class="flag flag-si" width="16" height="11" alt="sl"> Slovenščina</a></li> <li><a href="https://www.iban.hr/" title="Hrvatski" data-lang-id="hr_HR"><img src="/images/icon/blank.png" class="flag flag-hr" width="16" height="11" alt="hr"> Hrvatski</a></li> <li><a href="https://www.iban.sk/" title="Slovenský" data-lang-id="sk"><img src="/images/icon/blank.png" class="flag flag-sk" width="16" height="11" alt="sk"> Slovenský</a></li> <li><a href="https://www.iban.lv/" title="Latviešu" data-lang-id="lv"><img src="/images/icon/blank.png" class="flag flag-lv" width="16" height="11" alt="lv"> Latviešu</a></li> <li><a href="https://www.iban.lt/" title="Lietuvių" data-lang-id="lt"><img src="/images/icon/blank.png" class="flag flag-lt" width="16" height="11" alt="lt"> Lietuvių</a></li> <li><a href="https://www.iban.ee/" title="Eesti" data-lang-id="et"><img src="/images/icon/blank.png" class="flag flag-ee" width="16" height="11" alt="et"> Eesti</a></li> <li><a href="https://www.iban.rs/" title="Srpski" data-lang-id="sr"><img src="/images/icon/blank.png" class="flag flag-rs" width="16" height="11" alt="sr"> Srpski</a></li> <li><a href="https://www.ibankodu.com.tr/" title="Türkçe" data-lang-id="tr"><img src="/images/icon/blank.png" class="flag flag-tr" width="16" height="11" alt="tr"> Türkçe</a></li> <li><a href="https://www.iban.ru/" title="Русский" data-lang-id="ru_RU"><img src="/images/icon/blank.png" class="flag flag-ru" width="16" height="11" alt="ru"> Русский</a></li> <li><a href="https://www.iban.bg/" title=" Български" data-lang-id="bg"><img src="/images/icon/blank.png" class="flag flag-bg" width="16" height="11" alt="bg"> Български</a></li> <li><a href="https://www.iban.com.ua/" title="Українська" data-lang-id="uk"><img src="/images/icon/blank.png" class="flag flag-ua" width="16" height="11" alt="uk"> Українська</a></li> <li><a href="https://www.iban.ma/" title="العربية" data-lang-id="ar"><img src="/images/icon/blank.png" class="flag flag-ma" width="16" height="11" alt="ar"> العربية</a></li> <li><a href="https://www.iban.co.il/" title="עברית" data-lang-id="he"><img src="/images/icon/blank.png" class="flag flag-il" width="16" height="11" alt="he"> עברית</a></li> <li><a href="https://www.iban.jp/" title="日本語" data-lang-id="ja"><img src="/images/icon/blank.png" class="flag flag-jp" width="16" height="11" alt="ja"> 日本語</a></li> <li><a href="https://www.iban.kr/" title="한국어" data-lang-id="ko"><img src="/images/icon/blank.png" class="flag flag-kr" width="16" height="11" alt="ko"> 한국어</a></li> <li><a href="https://www.iban.hk/" title="繁體中文" data-lang-id="zh-TW"><img src="/images/icon/blank.png" class="flag flag-hk" width="16" height="11" alt="zh-TW"> 繁體中文</a></li> </ul> </li> <li ></li> <li><a href="https://clients.iban.com/login/" title="Member Login" class="login"><i class="fa fa-lock no-border" aria-hidden="true"></i>Kirjaudu sisään</a></li> <li><a href="https://clients.iban.com/register/" title="Request a trial account" class="requesttrial hidden-xs">Tilaa demo</a></li> </ul> </div> </div> </div> </div> </div> <header id="header" class="header clearfix"> <div class="header-wrap clearfix"> <div class="container"> <div class="row"> <div class="col-md-12"> <div id="logo" class="logo"> <a href="/" title="IBAN Home"> <img src="/images/logo.png" alt="IBAN Logo" width="170" height="75"> </a> </div> <div class="btn-menu"> <span></span> </div> <div class="nav-wrap"> <nav id="mainnav" class="mainnav navbar-right"> <ul class="menu"> <li><a href="/iban-checker" title="Check IBAN Number"><i class="fa fa-check"></i> <div class="atitle">IBAN-Tilinumero</div></a></li> <li><a href="/calculate-iban" title="IBAN Calculator"><i class="fa fa-retweet"></i> <div class="atitle">IBAN-Laskuri</div></a></li> <li><a href="/products" title="Products and services"><i class="fa fa-th-large" ></i> <div class="atitle">Tuotteet</div></a></li> <li><a href="/why-iban" title="Why choose IBAN Services"><i class="fa fa-question-circle" aria-hidden="true"></i> <div class="atitle">Miksi IBAN</div></a></li> <li><a class="active" href="/developers" title="Developers Documentation"><i class="fa fa-cogs"></i> <div class="atitle">Kehittäjät</div></a></li> <li><a href="/pricing" title="Order products and services"><i class="fa fa-tasks"></i> <div class="atitle">Hinnoittelu</div></a></li> </ul> </nav> </div> </div> </div> </div> </div> </header><div class="flat-row"> <div class="container"> <div class="row"> <div class="flat-wrapper"> <div class="flat-title-button"> <h1 class="title"><i class="fa fa-cogs" aria-hidden="true"></i>IBAN-laskenta-API</h1> </div> <h5>Tämä API on osa <a href="/iban-suite">IBAN Suite</a> -palveluamme</h5> <h4>API:n integrointiopas</h4> <a name="whatis"></a> <h4>1. Mikä on IBAN-laskenta-API?</h4> IBAN-laskentajärjestelmä (ts. IBAN-muunnosjärjestelmä) on ohjelmisto, jonka avulla asiakkaamme voivat muuntaa kotimaan pankkikoodit ja tilinumerot vahvistetuiksi kansainvälisiksi tilinumeroiksi (IBAN).<br><br> Järjestelmän ansiosta asiakkaamme voivat käyttää manuaalista käyttöliittymää tai integroida API:n oman yrityksensä sisäisiin järjestelmiin.<br><br> Järjestelmä tunnistaa myös pankit ja rahoituslaitokset sekä tarjoaa tietoa asiakkaillemme. <br><hr> <a name="features"></a> <h4>2. Ominaisuudet</h4> Alla on lueteltu IBAN-laskentajärjestelmämme tärkeimpiä ominaisuuksia:<br><br> <ul class="list"> <li>Vahvista paikallinen pankkikoodi / tilinumeron tarkistenumero (* katso lisätietoa tuetuista)</li> <li>Hanki pankkitietoja paikallisen pankin/haarakonttorin koodin perusteella.</li> <li>Luo automaattisesti voimassaolevan IBAN-numeron toimitettujen pankin/haarakonttorin koodin ja tilinumeron perusteella</li> <li>Järjestelmä tukee monivastemuotoa (JSON/XML)</li> </ul> <br><hr> <a name="countries"></a> <h4>3. Tuetut maat</h4> IBAN-laskenta-API tukee tällä hetkellä seuraavia maita ja kenttiä, jotka ovat pakollisia IBAN-numeron muodostamiseksi.<br><br> <table class="table table-bordered downloads"> <thead> <tr> <th>Maakoodi</th> <th>Maan nimi</th> <th>Pankkikoodi</th> <th>Haarakonttori</th> <th>Tili</th> <th>Tarkistenumero **</th> </tr> </thead> <tbody> <tr> <td>AT</td> <td>Itävalta</td> <td>KYLLÄ</td> <td> </td> <td>KYLLÄ</td> <td> </td> </tr> <tr> <td>BE</td> <td>Belgia</td> <td>KYLLÄ</td> <td> </td> <td>KYLLÄ</td> <td>KYLLÄ</td> </tr> <tr> <td>CH</td> <td>Sveitsi</td> <td>KYLLÄ</td> <td> </td> <td>KYLLÄ</td> <td> </td> </tr> <tr> <td>DE</td> <td>Saksa</td> <td>KYLLÄ</td> <td> </td> <td>KYLLÄ</td> <td> </td> </tr> <tr> <td>EE</td> <td>Viro</td> <td> </td> <td> </td> <td>KYLLÄ</td> <td> </td> </tr> <tr> <td>ES</td> <td>Espanja</td> <td>KYLLÄ</td> <td>KYLLÄ</td> <td>KYLLÄ</td> <td>KYLLÄ</td> </tr> <tr> <td>FI</td> <td>Suomi</td> <td> </td> <td> </td> <td>KYLLÄ</td> <td>KYLLÄ</td> </tr> <tr> <td>FR</td> <td>Ranska</td> <td>KYLLÄ</td> <td>KYLLÄ</td> <td>KYLLÄ</td> <td>KYLLÄ</td> </tr> <tr> <td>GB</td> <td>Iso-Britannia</td> <td>KYLLÄ</td> <td> </td> <td>KYLLÄ</td> <td>KYLLÄ</td> </tr> <tr> <td>HU</td> <td>Unkari</td> <td> </td> <td> </td> <td>KYLLÄ</td> <td>KYLLÄ</td> </tr> <tr> <td>IE</td> <td>Irlanti</td> <td>KYLLÄ</td> <td> </td> <td>KYLLÄ</td> <td>KYLLÄ</td> </tr> <tr> <td>IT</td> <td>Italia</td> <td>KYLLÄ</td> <td>KYLLÄ</td> <td>KYLLÄ</td> <td>KYLLÄ</td> </tr> <tr> <td>MC</td> <td>Monaco</td> <td>KYLLÄ</td> <td>KYLLÄ</td> <td>KYLLÄ</td> <td>KYLLÄ</td> </tr> <tr> <td>MR</td> <td>Mauritania</td> <td>KYLLÄ</td> <td>KYLLÄ</td> <td>KYLLÄ</td> <td> </td> </tr> <tr> <td>MT</td> <td>Malta</td> <td>KYLLÄ</td> <td> </td> <td>KYLLÄ</td> <td> </td> </tr> <tr> <td>NO</td> <td>Norja</td> <td> </td> <td> </td> <td>KYLLÄ</td> <td>KYLLÄ</td> </tr> <tr> <td>PT</td> <td>Portugali</td> <td>KYLLÄ</td> <td>KYLLÄ</td> <td>KYLLÄ</td> <td>KYLLÄ</td> </tr> <tr> <td>SM</td> <td>San Marino</td> <td>KYLLÄ</td> <td>KYLLÄ</td> <td>KYLLÄ</td> <td> </td> </tr> <tr> <td>CZ</td> <td>Tšekki</td> <td>KYLLÄ</td> <td> </td> <td>KYLLÄ</td> <td>KYLLÄ</td> </tr> <tr> <td>AL</td> <td>Albania</td> <td>KYLLÄ</td> <td> </td> <td>KYLLÄ</td> <td> </td> </tr> <tr> <td>SK</td> <td>Slovakia</td> <td>KYLLÄ</td> <td> </td> <td>KYLLÄ</td> <td>KYLLÄ</td> </tr> <tr> <td>SI</td> <td>Slovenia</td> <td>KYLLÄ</td> <td> </td> <td>KYLLÄ</td> <td>KYLLÄ</td> </tr> <tr> <td>PL</td> <td>Puola</td> <td>KYLLÄ</td> <td> </td> <td>KYLLÄ</td> <td>KYLLÄ</td> </tr> <tr> <td>PK</td> <td>Pakistan</td> <td>KYLLÄ</td> <td> </td> <td>KYLLÄ</td> <td> </td> </tr> <tr> <td>SE</td> <td>Ruotsi</td> <td>KYLLÄ</td> <td> </td> <td>KYLLÄ</td> <td>KYLLÄ</td> </tr> <tr> <td>NL</td> <td>Alankomaat</td> <td></td> <td></td> <td>KYLLÄ</td> <td>KYLLÄ</td> </tr> </tbody> </table> Tarkistenumerokenttä määrittää, tukeeko maa tilinumeron ja/tai pankkikoodin tarkistenumeron vahvistusta.<br><br> Tarkistenumeron vahvistus on ylimääräinen tietosuojatarkistus kirjoitusvirheitä vastaan. <br><hr> <a name="inputs"></a> <h4>4. API-syötteet</h4> API hyväksyy syötetyille tiedoille sekä HTTP GET - että POST-pyyntöjä.<br> Hyväksytyt parametrit on listattu alla olevassa taulukossa:<br><br> <table class="table table-bordered downloads"> <thead> <tr> <th>Kentän nimi </th> <th >Tyyppi</th> <th>Kuvaus</th> </tr> </thead> <tbody> <tr> <td>api_avain</td> <td >Merkkijono</td> <td>Oma API-avaimesi. Hankittu asiakasalueelta.</td> </tr> <tr> <td>muoto</td> <td >Merkkijono</td> <td>API-vastausmuoto (xml tai json)</td> </tr> <tr> <td>maa</td> <td >Merkkijono</td> <td>Kaksikirjaiminen maakoodi (UK/US/DE/FR)</td> </tr> <tr> <td>pankkikoodi</td> <td >Merkkijono</td> <td>Ainutlaatuinen pankin tunniste. Eri jokaisessa maassa (valinnainen). Jotkin maat edellyttävät vain tilinumeron.</td> </tr> <tr> <td>haarakonttori</td> <td >Merkkijono</td> <td>Ainutlaatuinen paikallisen haarakonttorin tunniste (valinnainen)</td> </tr> <tr> <td>tili</td> <td >Merkkijono</td> <td>Oma tilinumero</td> </tr> <tr> <td>cd</td> <td >Kokonaisluku</td> <td>Joissain maissa käytettävät tarkistenumerot.</td> </tr> <tr> <td>etuliite</td> <td >Kokonaisluku</td> <td>Tällä hetkellä pakollinen vain Tšekissä (valinnainen)</td> </tr> </tbody> </table> Ensimmäinen argumentti on API-avain. Tämä on ainutlaatuinen merkkijono, joka auttaa järjestelmäämme tunnistamaan sinut käyttäjänä sekä päästämään sinut käsiksi API:in.<br><br> API tukee useita vastausmuotoja tarjotakseen helpomman integroinnin. Tällä hetkellä tuetut muodot: XML ja JSON.<br><br> Maakoodin tulee olla kaksimerkkinen ISO-maakoodi, kuten UK Yhdistyneelle kuningaskunnalle, DE Saksalle, FR Ranskalle… <br> Pankkikoodi on pituudeltaan ja rakenteeltaan erilainen kussakin maassa.<br><br> Haarakonttorin koodi on valinnainen, sillä tämä on pakollinen vain joissain maissa (katso lisätietoja esimerkeistä)<br> Tilinumero on pakollinen kaikille maille ja joissain tapauksissa se on IBAN-numeron muodostamisessa ainoa käytetty parametri.<br><br> Tarkistenumero on pakollinen vain tietyissä maissa, jotka ovat ottaneet kyseiset vahvistusalgoritmit käyttöön tilinumeroiden rakenteissa (katso lisätietoja esimerkeistä).<br><br> Etuliite on valinnainen kenttä, joka on pakollinen ainoastaan Tšekin IBAN-numeron muodostamisessa. <br><hr> <a name="examples"></a> <h4>5. API-esimerkit</h4> Alla olevasta taulukosta löytyy esimerkkejä GET-kyselyn tekemisestä kullekin maalle.<br><br> <table class="table table-bordered downloads"> <thead> <tr> <th>Maa </th> <th>Esimerkkikysely (GET-PYYNTÖ)</th> </tr> </thead> <tbody> <tr> <td>AT</td> <td>?country=AT&format=json&bankcode=12000&account=52700357958 </td> </tr> <tr> <td>BE</td> <td>?country=BE&format=json&bankcode=250&account=0135106&cd=70 </td> </tr> <tr> <td>CH</td> <td>?country=CH&format=json&bankcode=0240&account=240C08011570 </td> </tr> <tr> <td>DE</td> <td>?country=DE&format=json&bankcode=BLZ37010050&account=399509 </td> </tr> <tr> <td>EE</td> <td>?country=EE&format=json&account=55000005511439 </td> </tr> <tr> <td>ES</td> <td>?country=ES&format=json&bankcode=0081&branch=1731&cd=91&account=0006040912 </td> </tr> <tr> <td>FI</td> <td>?country=FI&format=json&account=52900261901092 </td> </tr> <tr> <td>FR</td> <td>?country=FR&format=json&bankcode=30056&branch=00264&account=02640016443 </td> </tr> <tr> <td>GB</td> <td>?country=GB&format=json&bankcode=090127&account=93496333 </td> </tr> <tr> <td>HU</td> <td>?country=HU&format=json&account=107000240416330551100005 </td> </tr> <tr> <td>IE</td> <td>?country=IE&format=json&bankcode=905838&account=71924374 </td> </tr> <tr> <td>IT</td> <td>?country=IT&format=json&country=IT&bankcode=02008&branch=30545&account=000103685854 </td> </tr> <tr> <td>MC</td> <td>?country=MC&format=json&country=MC&bankcode=30002&branch=03260&account=0000079112A </td> </tr> <tr> <td>MR</td> <td>?country=MR&format=json&bankcode=00012&branch=00001&account=00000078326 </td> </tr> <tr> <td>MT</td> <td>?country=MT&format=json&bankcode=07113&account=199008240010 </td> </tr> <tr> <td>NO</td> <td>?country=NO&format=json&account=96803502045 </td> </tr> <tr> <td>PT</td> <td>?country=PT&format=json&bankcode=0038&branch=0000&cd=81&account=39551148771 </td> </tr> <tr> <td>PK</td> <td>?country=PK&format=json&bankcode=HABBPKKA&account=39551148771 </td> </tr> <tr> <td>SE</td> <td>?country=SE&format=json&bankcode=9150&account=0092395696 </td> </tr> <tr> <td>SM</td> <td>?country=SM&format=json&country=SM&bankcode=03034&branch=09800&account=000060164676 </td> </tr> <tr> <td>CZ</td> <td>?country=CZ&format=json&prefix=51&account=1707230277&bankcode=0100</td> </tr> <tr> <td>AL</td> <td>?country=AL&format=json&bankcode=20511117&account=374362CLPRCFEURC</td> </tr> <tr> <td>SK</td> <td>?country=SK&format=json&prefix=&account=4110053902&bankcode=3100</td> </tr> <tr> <td>SI</td> <td>?country=SI&format=json&bankcode=33000&account=0000102423</td> </tr> <tr> <td>PL</td> <td>?country=PL&format=xml&bankcode=11402004&account=0000360275244226</td> </tr> <tr> <td>SE</td> <td>?country=SE&format=json&bankcode=9300&account=5913222524</td> </tr> <tr> <td>NL</td> <td>?country=NL&format=json&account=0006642318</td> </tr> </tbody> </table> <hr> <a name="response"></a> <h4>6. API XML -vastauksen rakenne</h4> Alla olevassa taulukossa on yksityiskohtainen kuvaus mahdollisista palautettavista kentistä:<br><br> <table class="table table-bordered downloads"> <thead> <tr> <th>Kentän nimi </th> <th>Tyyppi</th> <th>Kuvaus</th> </tr> </thead> <tbody> <tr> <td>osoite</td> <td>Merkkijono</td> <td>Pankin haarakonttorin tai pääkonttorin osoite</td> </tr> <tr> <td>pankki</td> <td>Merkkijono</td> <td>Pankin tai rahoituslaitoksen nimi</td> </tr> <tr> <td>bic</td> <td>Merkkijono</td> <td>Pankin BIC-koodi (pankin tunnistekoodi) </td> </tr> <tr> <td>haarakonttori</td> <td>Merkkijono</td> <td>Pankkikoodin perusteella tunnistetun haarakonttorin nimi</td> </tr> <tr> <td>kaupunki</td> <td>Merkkijono</td> <td>Kaupunki, jossa haarakonttori sijaitsee.</td> </tr> <tr> <td>maa</td> <td>Merkkijono</td> <td>Maakoodin kaksikirjaiminen lyhenne, esim. US, UK, AU, FR … jne.</td> </tr> <tr> <td>sähköposti</td> <td>Merkkijono</td> <td>Pankin tai haarakonttorin yhteydenottosähköposti</td> </tr> <tr> <td>faksi</td> <td>Merkkijono</td> <td>Pankin/haarakonttorin faksinumero</td> </tr> <tr> <td>puhelin </td> <td>Merkkijono</td> <td>Pankin/haarakonttorin yhteydenottopuhelin</td> </tr> <tr> <td>maakunta</td> <td>Pankin/haarakonttorin maakunta</td> </tr> <tr> <td>verkkosivusto</td> <td>Merkkijono</td> <td>Pankin/haarakonttorin verkkosivuston osoite</td> </tr> <tr> <td>postinumero</td> <td>Merkkijono</td> <td>Pankin postinumero</td> </tr> </tbody> </table> API-järjestelmä palauttaa tulokset XML- tai JSON-muodossa, mikä helpottaa tietojen jäsentämistä eri ohjelmointikielissä ja -alustoissa.<br><br> API-järjestelmän XML-mallivastaus Yhdistyneen kuningaskunnan lajittelukoodille ja tilinumerolle olisi:<br><br> Kyselyn URL: <br><br> ?api_key=9834hAHx78ba4g8habsdk&country=GB&format=json&bankcode=110377&account=10218962<br><br> <strong><result></strong><br> <strong><iban>GB20ULSB98006054100029</iban></strong><br> <strong><account>54100029</account></strong><br> <strong><sort_code>980060</sort_code></strong><br> <strong><bank>ULSTER BANK LTD</bank></strong><br> <strong><branch>BELFAST CITY OFFICE 1</branch></strong><br> <strong><bic>ULSBGB2BXXX</bic></strong><br> <strong><address>PO BOX 232 11-16 DONEGALL SQUARE EAST </address></strong><br> <strong><city>BT1 5UB</city></strong><br> <strong><country>GB<country/></strong><br> <strong><phone>028 90244112</phone></strong><br> <strong></result></strong><br><br> Saman kyselyn JSON-vastaus olisi:<br><br> <strong>"iban":"GB20ULSB98006054100029","account":"54100029","sort_code":"980060","bank":"ULSTER BANK LTD","branch":"BELFAST CITY OFFICE 1","bic":"ULSBGB2BXXX","address":"PO BOX 232 11-16 DONEGALL SQUARE EAST ","city":"BT1 5UB","country":"GB","phone":"028 90244112"</strong> <br><hr> <a name="errors"></a> <h4>7. API-virheet</h4> Virhetilanteessa IBAN-laskenta-API palauttaa XML- tai JSON-vastauksen, joka sisältää virheviestin.<br> <error></error> XML-tunnisteet palautetaan ilman muita kenttiä.<br> Alta voit löytää kuvauksen kaikista mahdollisista virheviesteistä:<br><br> <p><strong><error>Tilinumeron tarkistenumero on virheellinen.</error></strong><br> <strong><error>Tilinumero (tarkistenumero) on virheellinen.</error></strong><br> <strong><error>Tilinumeron on oltava 11 merkkiä pitkä</error></strong><br> <strong><error>Tilinumeron on oltava 14 merkkiä pitkä</error></strong><br> <strong><error>Tilinumeron on oltava 24 merkkiä pitkä</error></strong><br> <strong><error>Tilinumero on virheellinen</error></strong><br> <strong><error>Tilinumeron lajittelukoodi on virheellinen</error></strong><br> <strong><error>Tilinumeron etuliite on liian pitkä.</error></strong><br> <strong><error>Tilinumero on liian pitkä.</error></strong><br> <strong><error>Pankin/haarakonttorin koodi/tarkistenumero on virheellinen.</error></strong><br> <strong><error>Pankin/haarakonttorin koodi tai tilinumero on liian pitkä.</error></strong><br> <strong><error>Pankin/haarakonttorin koodi (tarkistenumero) on virheellinen.</error></strong><br> <strong><error>Pankkikoodi on virheellinen</error></strong><br> <strong><error>Pankkikoodi on liian pitkä.</error></strong><br> <strong><error>Pankkia ei löytynyt</error></strong><br> <strong><error>Pankkia ei tunnistettu</error></strong><br> <strong><error>BBAN/NIB (tarkistenumero) on virheellinen.</error></strong><br> <strong><error>BLZ/pankkikoodi on virheellinen</error></strong><br> <strong><error>Haarakonttoria ei löytynyt</error></strong><br> <strong><error>Haarakonttorin koodi on liian pitkä.</error></strong><br> <strong><error>Haarakonttoria ei löytynyt</error></strong><br> <strong><error>Tarkistenumero on liian pitkä.</error></strong><br> <strong><error>Selvitysnumero/tilinumero on virheellinen. Tarkistenumero on virheellinen.</error></strong><br> <strong><error>Selvitysnumeroa/pankkikoodia ei voitu tunnistaa. IBAN-numeroa ei voida muodostaa.</error></strong><br> <strong><error>Selvitysnumero tai tilinumero on liian pitkä.</error></strong><br> <strong><error>Codice ABI della Banca / pankkikoodi on virheellinen</error></strong><br> <strong><error>Codice CAB della Filiale / haarakonttorin koodi on virheellinen</error></strong><br> <strong><error>Maakoodi on virheellinen</error></strong><br> <strong><error>Maata tai pankkia ei tueta</error></strong><br> <strong><error>IBAN on virheellinen</error></strong><br> <strong><error>Kontonummer / tilinumero on virheellinen</error></strong><br> <strong><error>Puuttuvia kenttiä</error></strong><br> <strong><error>Ei FR IBAN</error></strong><br> <strong><error>Ei FR IBAN maa</error></strong><br> <strong><error>Pakollinen kenttä puuttuu. Syötä pankkikoodi ja tilinumero</error></strong><br> <strong><error>Pakollisia kenttiä ei ole täytetty.</error></strong><br> <strong><error>RIB on virheellinen</error></strong><br> <strong><error>Lajittelukoodia/pankkikoodia ei voitu tunnistaa. IBAN-numeroa ei voida muodostaa.</error></strong><br> <strong><error>Lajittelukoodia ei löytynyt</error></strong></p> </div> </div> </div> </div> </div> <footer class="footer" > <div class="footer-widgets"> <div class="container"> <div class="row"> <div class="col-md-3 col-sm-6 col-xs-6"> <div class="widget widget_nav_menu"> <div class="menu-footer-menu-container"> <div class="footermenutitle">Verkkotyökalut</div> <ul class="ft-menu"> <li><a href="/iban-checker">IBAN-tarkistin</a></li> <li><a href="/calculate-iban">IBAN-laskuri</a></li> <li><a href="/search-bic">Etsi BIC</a></li>  </ul> </div> </div> </div> <div class="col-md-3 col-sm-6 col-xs-6"> <div class="widget widget_nav_menu"> <div class="menu-footer-menu-container"> <div class="footermenutitle"><a href="/developers">Tuotteet</a></div> <ul class="ft-menu"> <li><a href="/iban-suite">IBAN Suite: Vahvistus & laskenta</a></li> <li><a href="/bic-validation-service">BIC-vahvistuspalvelu</a></li> <li><a href="/register">Tilaa kokeilujakso</a></li> </ul> </div> </div> </div> <div class="col-md-3 col-sm-6 col-xs-6"> <div class="widget widget_nav_menu"> <div class="menu-footer-menu-container"> <div class="footermenutitle"><a href="/developers">Kehittäjät</a></div> <ul class="ft-menu"> <li><a href="/validation-api">IBAN-vahvistus-API</a></li> <li><a href="/calculation-api">IBAN-laskenta-API</a></li> <li><a href="/bic-validation-api">BIC-vahvistus-API</a></li> </ul> </div> </div> </div> <div class="col-md-3 col-sm-6 col-xs-6"> <div class="widget widget_nav_menu"> <div class="menu-footer-menu-container"> <div class="footermenutitle"><a href="/about">Tietoa</a></div> <ul class="ft-menu"> <li><a href="/why-iban">Miksi IBAN</a></li> <li><a href="/customers">Asiakkaat</a></li> <li><a href="/our-data">Tietomme</a></li> </ul>   </div> </div> </div> </div> </div> </div> <div class="content-bottom-widgets"> <div class="container"> <div class="row"> <div class="ft-wrapper"> <div class="col-md-12 text-center footermenutitle">Kumppanit</div></div> </div> </div> </div> <div class="content-bottom-widgets"> <div class="container"> <div class="row"> <div class="flat-wrapper"> <div class="ft-wrapper"> <div class="col-md-4 text-left"> <span style="clear:both;">BIC-tietoja käytetään S.W.I.F.T. SCRL:n suostumuksessa. Tietokannan oikeudet pidätetään, 2025. <br> IBAN.com on valtuutettu VocaLink™ -jälleenmyyjä</span> </div> <div class="col-md-2 col-sm-6 text-center"> <span><img src="/images/logos/swiftref.png" alt="S.W.I.F.T. SCRL">  </span> </div> <div class="col-md-2 col-sm-6 text-center"> <span><img src="/images/logos/deutsche_bundesbank.png" alt="Deutsche Bundesbank">  </span> </div> <div class="col-md-2 col-sm-6 text-center"> <span><img src="/images/logos/banque_de_france.png" alt="La Banque de France Eurosisteme"></span> </div> <div class="col-md-2 col-sm-6 text-center"> <span><img src="/images/logos/vocalink_mastercard.png" alt="Vocalink LTD (Mastercard)">  </span> </div> </div> </div> </div> </div> </div> <div class="footer-content"> <div class="container"> <div class="row"> <div class="copyright"> <div class="copyright-content"> <div class="col-md-4 col-sm-12"> Copyright © 2025<a href="https://www.iban.com/">IBAN</a> </div> <div class="col-md-8 col-sm-12"> <a href="https://www.iban.com/privacy">Tietosuoja</a> <a href="https://www.iban.com/terms">Ehdot</a> <a href="https://www.iban.com/dpa">DPA</a> <a href="https://www.iban.com/security" class="hidden-xs">Turvallisuus</a> <a href="/contact">Yhteydenotto</a> <a href="/sitemap" class="hidden-xs" >Sivukartta</a> </div> </div> </div> </div> </div> </div> </footer> <a class="go-top"> <i class="fa fa-chevron-up"></i> </a> <script type="text/javascript" src="/javascript/jquery-2.2.4.min.js" ></script>   <script type="text/javascript" src="/javascript/ibanlibs.js"></script> <script type="text/javascript"> $(document).ready(function() { $.DivasCookies({ bannerText : "Tämä sivusto käyttää evästeitä, jotta voit parantaa web-kokemustasi.", // text for the Divas Cookies banner cookiePolicyLink : "https://www.iban.com/privacy", // link to the extended cookie policy cookiePolicyLinkText : "Tietosuojakäytäntö", // text for the link to the extended cookie policy thirdPartyPolicyWidget : "", // if set to "iubenda" tries to use the Iubenda widget acceptButtonText : "Hyväksyä", // text for the close button acceptButtonSrc : "", // source for the close button image openEffect : "", // opening effect for Divas Cookies banner ["fade", "slideUp", "slideDown", "slideLeft", "slideRight"] openEffectDuration : 600, // duration of the opening effect (msec) openEffectEasing : "", // easing for the opening effect closeEffect : "", // closing effect for Divas Cookies banner ["fade", "slideUp", "slideDown", "slideLeft", "slideRight"] closeEffectDuration : 600, // duration of the closing effect (msec) closeEffectEasing : "", // easing for the closing effect debugMode : false, // if true, the options are checked and warnings are shown saveUserPreferences : true, // if true, sets a cookie after the Divas Cookies is closed the first time and never shows it again cookieDuration : 30, // number of days after which the Divas Cookie technical cookie will expire (default 365 days) blockScripts : false, // set this to true if you blocked scripts by wrapping them with if($.DivasCookies.optedIn()){**script to be blocked**} (default false) pageReload : false, // if true reloads the actual page after opt-in to show the previuosly blocked scripts (default false) acceptOnScroll : false, // if true sets the Divas Cookie technical cookie on page scroll for cookies agreement (default false) acceptOnClick : true, // if true sets the Divas Cookie technical cookie on click on any <a> in the page except that on Divas Cookies banner for cookies agreement (default false) excludePolicyPage : true // if true excludes the cookie policy page from acceptOnScroll and acceptOnClick (default false) }); }); </script>   <script type="text/javascript" src="https://www.iban.com/javascript/tw-app.js"></script> </body> </html>  <script async src='https://www.googletagmanager.com/gtag/js?id=UA-70849995-14'></script> <script> window.dataLayer = window.dataLayer || []; function gtag(){dataLayer.push(arguments);} gtag('js', new Date()); gtag('config', 'UA-70849995-14'); </script>