Pankkiyhteydet

WS-kanava API: yksi integraatio suomalaisiin pankkeihin

Web Services -kanava on suomalaisten pankkien standardi yritysasiakkaiden aineistoliikenteelle: tiliotteiden noutamiselle ja maksuaineistojen lähettämiselle. Tässä oppaassa käymme läpi, miten se toimii ja mitä integrointi vaatii.

TestiympäristöRekisteröinti vaaditaan · Tilausta ei vaadita · Avoin rekisteröinti
TuotantoRekisteröinti vaaditaan · Maksullinen tilaus vaaditaan · Normaali käyttöönotto

Tarkka vaihe ja pääsy

Käyttö edellyttää asiakkaan pankkisopimuksia. Tarkka pankki- ja aineistotuki määräytyy sopimuksen ja pätevöidyn profiilin mukaan.

Ota yhteyttä

Mikä Web Services -kanava on

WS-kanava on pankkien tarjoama SOAP-pohjainen rajapinta, jonka kautta yrityksen ohjelmisto noutaa konekielisiä tiliotteita ja lähettää maksuaineistoja. Se korvaa vanhemmat eräsiirtomenetelmät ja on käytössä kaikilla suurilla suomalaisilla pankeilla.

Sanomaliikenne on allekirjoitettua ja salattua, ja se perustuu pankin myöntämiin PKI-varmenteisiin. Aineistot ovat pääosin ISO 20022 -muotoisia: tiliote camt.053, maksut pain.001 ja maksupalaute pain.002.

Mitä integrointi vaatii

WS-yhteyden käyttöönotto edellyttää Web Services -sopimusta pankin kanssa sekä varmennehakemusta. Ohjelmiston on osattava muodostaa ja allekirjoittaa WS-sanomat, hallita avaimia ja varmenteiden uusintaa sekä käsitellä ISO 20022 -aineistoja.

Tämä on merkittävä toteutustyö pankkia kohden — ja se on toistettava jokaiselle pankille erikseen, koska yhteyksissä on pankkikohtaisia eroja.

Web Services -sopimus ja varmenteet pankin kanssa
WS-sanomien muodostus, allekirjoitus ja salaus
Avainten ja varmenteiden elinkaaren hallinta
ISO 20022 -aineistojen (camt.053, pain.001/002) käsittely

Miten ISECure yksinkertaistaa tämän

ISECure tarjoaa WS-kanavan yhtenä REST-rajapintana. Hoidamme sanomien allekirjoituksen, varmenteet ja avainten hallinnan sekä pankkikohtaiset erot, joten ohjelmistosi tekee vain yksinkertaisia REST-kutsuja. Yksi integraatio kattaa tukemamme suomalaiset pankit.

Palvelun rajat

Palvelu ei korvaa asiakkaan pankkisopimusta tai pankin myöntämää valtuutta.
File Exchange API siirtää aineistot eikä muuta niiden taloudellista sisältöä.

Kyvykkyydet ja suunta

Suunta	Kyvykkyys
Molempiin suuntiin	PankkiaineistotListaa ja lataa pankin tarjoamia aineistoja sekä lähetä valtuutettuja aineistoja asiakkaan pankkisopimuksen rajoissa.
Sisään	VarmenteetRekisteröi ja uusi pankkiyhteyden varmenteita nykyisen rajapinnan kautta.

Usein kysyttyä

Onko REST API oma pankkituote?

Ei. REST API on Pankkiyhteydet-tuotteen käyttörajapinta pankkiaineistojen siirtoon.