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.

GA
  • 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.

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öä.

Testaa ensin Pankkisimulaattorilla

Aloita jo silloin, kun pankkisopimus ja tuotantovarmenteet ovat vielä työn alla. Pankkisimulaattorilla voit testata saman API:n varmenteen rekisteröinnin, tiedostojen listauksen ja latauksen sekä allekirjoitetun maksuaineiston lähetyksen synteettisillä aineistoilla. Kun oikea pankki on valmis, kohdista täsmälleen sama File Exchange API erikseen määritettyyn pankkiyhteyteen ja säilytä simulaattori testausta varten. Oikeat pankkikanavat eivät tarjoa vastaavaa asiakkaan hallitsemaa testiympäristöä.

Kyvykkyydet ja suunta

SuuntaKyvykkyys
Molempiin suuntiinPankkiaineistotListaa ja lataa pankin tarjoamia aineistoja sekä lähetä valtuutettuja aineistoja asiakkaan pankkisopimuksen rajoissa.
SisäänVarmenteetRekisterö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.

Viestisi

Miten voimme auttaa?

Nimi on pakollinen ja voi sisältää vain kirjaimia
Anna kelvollinen sähköpostiosoite
Viestin tulee olla vähintään 10 merkkiä pitkä