Yleistä
Kirjastot voivat sallia käyttäjilleen maksujen maksamisen verkossa. Ominaisuus otetaan käyttöön keskitetysti niin, että verkkomaksaminen on käytössä kaikissa näkymissä, joissa kirjastokorttia voi käyttää. Verkkomaksamista voi testata omassa testinäkymässä ennen tuotantokäytön aloittamista.
Finna tukee seuraavia maksunvälittäjiä:
- CPU (Ceepos)
- Paytrail: E2 ja Paytrail Payment API (jälkimmäinen Finnan versiosta 2.77.0 eli 22.3.2022 alkaen)
- Turun Maksupalvelu
Verkkomaksamisen käyttöönotto
Verkkomaksamisen aktivoimiseksi on siis otettava yhteyttä Finnan palveluosoitteeseen (finna-posti ät helsinki.fi). Verkkomaksamisen käyttöönottoon tarvittavat tiedot voi lähettää siten, että pyytää turvapostia. Tietoja ei saa lähettää sähköpostilla, sillä se ei ole turvallista.
Seuraavat tiedot ovat tarpeen:
- Kauppiastunnus (Paytrail)
- Maksulomakkeen URL (CPU)
- Kauppiasvarmenne tai "secret" (Paytrail ja CPU)
- Sähköpostiosoite (tai osoitteet), johon lähetetään tieto mahdollisista virhetilanteista
- Tieto siitä, mikä on pienin maksettavissa oleva maksu
- Tieto siitä, lisätäänkö maksuihin vielä palvelumaksu esim. maksunvälittäjän aiheuttamien kulujen kattamiseksi, ja mikä on palvelumaksun tuotekoodi
- Koha (vain Suomi-versio): Tarvitaan Kohan puolelle käyttäjä, jolla on updatecharges-käyttöoikeus ja oma kategoria (koodi ZMAKSU, nimi Z_verkkomaksut).
Lisäksi tarvittaessa on mahdollista määritellä, miten kirjastojärjestelmän maksutyypit mapataan tuotekoodeiksi maksunvälittäjälle lähetettävässä aineistossa. Tämä on toistaiseksi mahdollista Koha-kirjastojärjestelmien yhteydessä, koska siitä saadaan yksiselitteinen maksun tyyppi.
Verkkomaksamista voidaan testata finna-pre.fi:n puolella ennen sen käyttöönottoa tuotannossa.
Verkkomaksutapahtuman kulku
- Käyttäjä kirjautuu Finnaan
- Käyttäjä siirtyy omiin tietoihin Maksut-välilehdelle
- Finna pyytää käyttäjän kirjastokortilla kirjastojärjestelmältä tiedot maksamattomista maksuista (ja siitä, mitkä voidaan maksaa verkossa)
- Käyttäjä painaa verkkomaksupainiketta Finnassa ja hyväksyy tietojen välittämisen maksunvälittäjälle
- Finna tarkistaa, etteivät maksut ole tällä aikaa muuttuneet
- Finna ohjaa käyttäjän maksunvälittäjän palveluun (CPU tai Paytrail)
- Käyttäjän maksettua maksut välittää maksupalvelu tiedon tästä Finnalle ja ohjaa käyttäjän takaisin Finnaan
- Finna lähettää kirjastojärjestelmälle pyynnön merkitä asiakkaan maksamat maksut maksetuiksi
- Mikäli Finna ei saa yhteyttä kirjastojärjestelmään tai maksujen merkitseminen epäonnistuu, yritetään tapahtuman rekisteröintiä kirjastojärjestelmään uudelleen seuraavan kahden tunnin ajan
- Epäonnistuneiden maksujen olemassaolosta lähetetään tieto kirjaston ilmoittamaan osoitteeseen
- Epäonnistuneet maksut käsitellään hallintaliittymässä (ks. ohje)
Uuden verkkomaksun tekeminen on estetty käyttäjältä niin kauan kun hänellä on keskeneräisiä maksutapahtumia.
