Sisällysluettelo
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
- 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.
Siirtyminen Paytrailin uuteen rajapintaan
Huom! Suomi.fi-maksamisen sopimuksella Paytrailia käyttävät organisaatiot siirtyvät uuteen rajapintaan syksyllä 2022 useammassa erässä. Siirtymät alkavat 1.8., ja valmista pitäisi olla 30.11. Lisätietoja saa Valtiokonttorista (verkkomaksaminen at valtiokonttori.fi).
Siirtyminen Paytrailin vanhasta E2-rajapinnasta uuteen Paytrail Payment APIin edellyttää muitakin muutoksia kuin tunnusten vaihtamisen uusiin. Pyydämme ottamaan yhteyttä yllämainittuun palveluosoitteeseen muutosten tekemiseksi koko Finna-ympäristössä.
Mikäli asetuksia halutaan testata vain yksittäisessä testinäkymässä, voi muutokset tehdä näkymän paikalliseen datasources.ini-tiedostoon, kunhan vaihtaa myös onlinePayment['handler'] -asetuksen arvoksi PaytrailPaymentAPI.
Esimerkki:
[testi] onlinePayment['handler'] = 'PaytrailPaymentAPI' onlinePayment['merchantId'] = '123456' onlinePayment['secret'] = 'SALAINEN'
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.
