Kirjastot voivat sallia käyttäjilleen maksujen maksaminen verkossa Paytrailin tai CPU:n kautta. Ominaisuus otetaan käyttöön keskitetysti niin, että verkkomaksaminen on käytössä kaikissa näkymissä, joissa kirjastokorttia voi käyttää. Verkkomaksamisen aktivoimiseksi on siis otettava yhteyttä finna-postiin. Verkkomaksamisen käyttöönottoon tarvittavat tiedot voi kirjata hallintaliittymässä oman näkymän local/config/vufind-hakemistoon maksut.txt -tiedostoon. Tietoja ei tule lähettää sähköpostilla, sillä se ei ole turvallista. Seuraavat tiedot ovat tarpeen:
- Kauppiastunnus (Paytrail)
- url (CPU)
- Secret (Paytrail ja CPU)
- Sähköpostiosoite, johon lähetetään tieto mahdollisista virhetilanteista
- Koha: Tarvitaan Kohan puolelle käyttäjä, jolla on updatecharges-käyttöoikeus. Lisää käyttäjän tunnus ja salasana yllä mainittuun maksut.txt-tiedostoon.
- 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
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 vain Voyager- ja Koha-kirjastojärjestelmien yhteydessä, koska niistä saadaan yksiselitteinen maksun tyyppi.
Verkkomaksamista voidaan testata finna-test.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.
