Tämä UKK on tarkoitettu julkishallinnon organisaatioille, jotka käyttävät tai suunnittelevat ottavansa käyttöön Suomi.fi-maksut-palvelun.
Jos et löydä vastausta kysymykseesi, ota yhteyttä Valtiokonttoriin sähköpostitse osoitteeseen verkkomaksaminen@valtiokonttori.fi tai varaa maksuton suunnittelupalaveri Valtiokonttorin asiantuntijan kanssa.
Suomi.fi-maksut on Valtiokonttorin tuottama keskitetty verkkomaksamisen palvelu, jonka avulla julkishallinnon organisaatiot voivat vastaanottaa maksuja loppuasiakkailtaan.
Palvelu on tarkoitettu sähköiseen asiointiin ja verkkokauppoihin. Sitä voidaan hyödyntää myös mobiilisovelluksissa.
Palvelu tarjoaa yhdellä sopimuksella yleisimmät verkkokaupan maksutavat:
Palveluun sisältyvät maksujen välitys ja palautus, tilitykset ja raportointi.
Palvelu ei sisällä asiointipalvelun tai verkkokaupan toteutusta eikä integraation tekemistä Suomi.fi-maksut palveluun.
Palvelu ei myöskään sisällä fyysisen kaupan maksuratkaisuja, kuten maksupäätteitä.
Tyypillisiä käyttökohteita ovat esimerkiksi:
Kunnissa palvelua käytetään muun muassa:
Suomi.fi-maksut tukee sähköistä asiointia ja tehostaa maksamisen prosessia.
Laskutukseen verrattuna verkkomaksamisessa maksu peritään yleensä etukäteen. Tämä vähentää laskutukseen liittyvää saatavien hallintaa ja perintää.
Yhdellä sopimuksella organisaatio saa käyttöönsä laajan maksutapavalikoiman. Suomi.fi-maksut on kilpailutettu, kustannustehokas ja helppo ottaa käyttöön Valtiokonttorin tuella.
Suomi.fi-maksut palvelu on osa Suomi.fi-palvelukokonaisuutta, johon kuuluu useita eri palveluita. DVV vastaa monista näistä muista palveluista, kuten Suomi.fi-viesteistä ja Suomi.fi-tunnistuksesta.
Suomi.fi-maksut palvelun tuottaa Valtiokonttori, joten ole yhteydessä Valtiokonttoriin kaikissa tähän palveluun liittyvissä asioissa: verkkomaksaminen@valtiokonttori.fi.
Halutessasi tietoa muista kuin Suomi.fi-maksut palvelusta ole yhteydessä DVV:hen: digiratkaisut@dvv.fi
Ei. Asiointipalvelussa voidaan kuitenkin käyttää Suomi.fi-maksujen lisäksi myös Suomi.fi-tunnistus ja/tai Suomi.fi-viestit palvelua, mutta niiden käyttöönotto tapahtuu DVV:n kautta.
Käyttöönotto alkaa kartoittamalla organisaation verkkomaksamisen käyttökohteet. Esimerkkejä käyttökohteista löytyy kysymyksen ”Missä palvelu on tyypillisesti käytössä?” alta, UKK:n kohdassa ”1) Yleistä palvelusta”. Seuraavaksi suositellaan varaamaan maksuton käyttöönoton suunnittelupalaveri täältä. Palaverin voi varata myös palveluun tutustumista varten ennen varsinaista käyttöönottoon valmistelua.
Organisaatiolla tulee olla käytössään sähköinen asiointipalvelu tai verkkokauppa, johon Suomi.fi‑maksut integroidaan.
Käyttöönotto etenee pääpiirteissään seuraavasti:
Vaiheita voidaan toteuttaa osittain rinnakkain tai eri järjestyksessä organisaation tilanteen mukaan.
Palaverissa (varataan täältä) käydään läpi:
Palaveriin osallistuu yleensä myös palvelun toimittaja Paytrail Oyj.
Palaveriin osallistuvat tyypillisesti:
Verkkokauppatoimittajan edustajan ei yleensä ole tarpeen osallistua käyttöönoton suunnittelupalaveriin, mikäli integraatiossa ei ole mitään varmistettavaa.
Sopivaa aikaa suunnittelupalaveriin ei löytynyt Valtiokonttorin verkkosivuilta. Mitä tehdä? Ole yhteydessä Valtiokonttoriin sähköpostitse: verkkomaksaminen@valtiokonttori.fi.
Käyttöönoton suunnittelupalaverin jälkeen organisaatio tekee palveluun liittyvät valinnat käyttöönottolomakkeella ja allekirjoittaa sopimusdokumentit Valtiokonttorin kanssa.
Asiakkuuden ja kauppiastunnuksen avaamiseen varataan tyypillisesti 1–2 viikkoa. Kiiretilanteissa aikataulua voidaan pyrkiä poikkeustilanteissa nopeuttamaan.
Aikaa vievintä on yleensä asiointipalvelun tai verkkokaupan hankinta ja käyttöönotto sekä asiointiprosessien ja tuotetietojen määrittely niissä. Tarkempia lisätietoja voi kysyä verkkokauppatoimittajalta.
Myös integraation toteutus voi viedä aikaa, jos se ei sisälly käytössä olevaan järjestelmään.
Ei. Suomi.fi-palveluhallinta liittyy vain Digi‑ ja väestötietoviraston tuottamiin Suomi.fi-palveluihin.
Suomi.fi-maksut palvelu otetaan käyttöön tekemällä sopimus palvelun käytöstä Valtiokonttorin kanssa.
Palvelua voivat käyttää kaikki julkishallinnon organisaatiot, kuten valtion virastot ja laitokset, kunnat ja hyvinvointialueet.
Käyttöoikeus perustuu lakiin hallinnon yhteisistä sähköisen asioinnin tukipalveluista (571/2016). Valtiokonttori voi myöntää käyttöoikeuden myös muille julkista tehtävää hoitaville toimijoille.
Käyttövelvollisuus perustuu lakiin hallinnon yhteisistä sähköisen asioinnin tukipalveluista (571/2016). Käyttövelvollisia ovat muun muassa valtion virastot ja laitokset, hyvinvointialueet, tuomioistuimet sekä kunnalliset viranomaiset laissa säädetyissä tehtävissä.
Kyllä, käyttövelvollisuudesta on mahdollista hakea poikkeusta tukipalvelulaissa mainituin perustein. Poikkeuslupaa haetaan Valtiokonttorilta, olemalla yhteydessä osoitteeseen verkkomaksaminen@valtiokonttori.fi tarkemman ohjeistuksen saamiseksi.
Sopimus tehdään Valtiokonttorin kanssa.
Palvelun käyttö ei edellytä erillisiä sopimuksia maksutavoista. Uutta kauppiastunnusta varten tarvitaan uusi käyttöönottolomake.
Sopimus on vakiosopimus.
Sopimuksen käyttöönottolomakkeella, joka vastaa kauppiastunnusta, määritellään palveluun liittyvät valinnat ja organisaation yhteyshenkilöt.
Valtiokonttori, joka tuottaa palvelun, on kilpailuttanut palvelun toimittajan. Kuluvalla sopimuskaudella maksunvälittäjä ja toimittaja on Paytrail Oyj.
Nykyinen sopimuskausi päättyy viimeistään 31.10.2029.
Kyllä. Suomi.fi‑maksut liitetään organisaation omaan sähköiseen asiointipalveluun tai verkkokauppaan.
Ei. Palvelu ei ole itsenäinen järjestelmä, vaan se edellyttää taustalle asiointipalvelun tai verkkokaupan.
Organisaatio voi käyttää joko valmiita verkkokauppa- tai sähköisen asioinnin järjestelmiä, tai rakentaa itse oman asiointipalvelun, johon Suomi.fi-maksut palvelu liitetään.
Vertaistukea saa esimerkiksi muilta Suomi.fi-maksut palvelua käyttäviltä organisaatioilta, jotka löytyvät Valtiokonttorin verkkosivujen Suomi.fi-maksujen tilastoista. Organisaatio-kentän valinnan avulla saa näkyviin halutun käyttäjäorganisaation maksumäärät eri maksutavoilla Suomi.fi-maksut palvelussa. Tilastojen alapuolelta löytyy kuntakartta, josta näkee yhdellä silmäyksellä Suomi.fi-maksut palvelua käyttävät kunnat.
Palvelun integraatiossa käytetään toimittajan rajapintakuvausta. Paytrailin Payment API ‑rajapintakuvauksen (englanninkielinen) löytyy osoitteesta https://docs.paytrail.com/.
Integraation toteuttaa organisaation asiointipalvelun tai verkkokaupan toimittaja tai organisaatio itse.
Tarvittaessa tukea saa Valtiokonttorilta ja Paytraililta. Teknisiä kysymyksiä voidaan käsitellä myös palaverissa, johon voidaan varata aika täältä.
Maksunvälittäjänä toimii kuluvalla sopimuskaudella Paytrail Oyj, joka vastaa tekniikasta, maksujen välityksestä ja tilityksestä sekä tarjoaa raportoinnin palvelumallin mukaisesti.
Palvelussa ovat käytettävissä seuraavat maksutavat:
Organisaatio voi valita, mitkä maksutavat ovat loppuasiakkaille käytettävissä, ja muuttaa valintoja sopimuskauden aikana.
Maksunvälittäjänä toimii tällä sopimuskaudella Paytrail Oyj, joka palvelun toimittajana vastaa rajapinnasta ja tekniikasta ja hoitaa maksujen välityksen, tilityksen ja raportoinnin palvelumallin mukaisesti
Kauppiastunnus (Kauppias ID) ja sen kauppiasvarmenne ovat tunnisteet, joita tarvitaan Suomi.fi-maksut palvelun käyttöön.
Kauppiastunnus määrittää organisaation palvelua koskevat valinnat. Yksi käyttöönottolomake vastaa yhtä kauppiastunnusta.
Kauppiastunnus ja kauppiasvarmenne ovat luottamuksellisia, ja ne tulee säilyttää huolellisesti eikä luovuttaa henkilöille, joilla ei ole niihin oikeutta.
Kauppiastunnus ja kauppiasvarmenne löytyvät Kauppiaspaneelista valikon kohdasta ”Kauppiastili” niille käyttäjille, joilla on tähän vaadittava käyttöoikeusrooli (”Palvelun tietojen hallinta”).
Kauppiastunnuksen ja varmenteen pääsee hakemaan Kauppiaspaneelista vain henkilö, jolla on ”Palvelun tietojen hallinta” -rooli.
Käyttöönottolomakkeella nimetylle pääkäyttäjälle ei tätä roolia ole annettu kauppiastunnusta perustettaessa, sillä hyvän hallintotavan mukaisesti suositellaan eriyttämään roolit siten, että ”Palvelun tietojen hallinta” ja ”Käyttäjien hallinta” -rooli ovat eri henkilöillä. Valtiokonttorin Tiimeristä löytyy Kauppiaspaneelin ohje (linkki), jonka kohdassa ”2.1.2 Käyttäjätunnuksen luominen ja muokkaaminen” ohjeistetaan käyttöoikeuksien antaminen.
Kauppias ID on sama kuin kauppiastunnus.
Tarve riippuu organisaation palvelurakenteesta ja raportoinnin tarpeista. Mitoitusta arvioidaan tarvittaessa käyttöönoton suunnittelupalaverissa (katso UKK:n kohta ”2. Palvelun käyttöönotto”).
Kauppiastunnuksia voi lisätä olemalla yhteydessä Valtiokonttoriin (verkkomaksaminen@valtiokonttori.fi).
Kauppiastunnuksia voi vähentää sopimuskauden aikana. Ole yhteydessä Valtiokonttoriin (verkkomaksaminen@valtiokonttori.fi) tarkemman ohjeistuksen saamiseksi.
Kauppiaspaneeli on palvelun raportointityökalu, josta löytyy kauppiastunnuksittain maksujen raportointi ja tilitysraportit.
Vastaavat tiedot ovat saatavilla myös rajapinnan kautta.
Organisaatio voi valita tilityksissä seuraavista vaihtoehdoista:
Palvelussa käytetään bruttotilitysmallia, jolloin palvelumaksut veloitetaan kuukausittain jälkikäteen Valtiokonttorin lähettämässä palvelumaksulaskussa.
Kyllä. Palautuksia voi tehdä Kauppiaspaneelissa tai rajapinnan kautta, jos organisaation asiointijärjestelmä tukee rajapintapalautuksia.
Palautus voi olla koko- tai osapalautus. Osapalautuksia voi tehdä maksulle useita.
Ei. Palautus kohdistuu automaattisesti maksajan käyttämälle maksutavalle. Jos maksajan pankkitilitietoja joudutaan poikkeustapauksissa erikseen selvittämään, hoitaa palvelu tämän, mikäli toimeksiannossa on annettu maksajan sähköpostiosoite.
Testaaminen tehdään saman rajapinnan kautta testitunnuksia käyttäen. Erillistä testiympäristöä ei ole.
Valtiokonttori suosittelee:
Yleiset testitunnukset löytyvät rajapintakuvauksesta https://docs.paytrail.com/.
Tarvittaessa Paytrail voi luoda organisaatiolle omat testitunnukset, jotka mahdollistavat muun muassa Kauppiaspaneelin käytön sekä tilitysraporttien noudon sekä Kauppiaspaneelin, että rajapinnan kautta.
Yleiset maksutapakohtaiset rajoitukset löytyvät rajapintakuvauksesta https://docs.paytrail.com/.
Testitunnuksilla, jotka löytyvät rajapintakuvauksesta, on seuraavat rajoitteet:
Valtiokonttori vastaa:
Paytrail tukee:
Yhteydenotot: info@paytrail.com (puh. 020 718 1820, ark. 8–17)
Ei tarvitse. Voit olla yhteydessä Valtiokonttoriin ja/tai Paytrailiin jo suunnitteluvaiheessa.
Ei. Suomi.fi‑maksut palvelulla ei ole erillistä käyttöönotto‑ tai aloitusmaksua.
Palvelun hinnoista säädetään valtiovarainministeriön asetuksessa Valtiokonttorin maksullisista suoritteista, jonka liitteestä löytyy Suomi.fi-maksut palvelun hinnasto.
Kustannukset muodostuvat pääosin transaktio‑ ja provisiomaksuista sekä kauppiastunnusten kuukausimaksuista.
Organisaatio vastaa itse omista integraation ja asiointipalvelun kehittämis- ja ylläpitokustannuksistaan.
Kyllä. Rajapintakuvaus on käytännössä sama molemmissa palveluissa, joten Paytrailin kaupalliseen palveluun tehty integraatio toimii myös Suomi.fi-maksut palvelussa.
Kyse on kuitenkin eri palveluista, joten samaa kauppiastunnusta ja -varmennetta ei voi käyttää molemmissa palveluissa.
Suomi.fi‑maksut palvelussa sopimus tehdään Valtiokonttorin kanssa.
Palvelulla on oma hinnoittelunsa sekä käyttöönotto‑ ja asiakaspalvelumalli julkishallinnon tarpeisiin.
Suomi.fi-maksuista löytyy myös muita hyödyllisiä eroavaisuuksia, jotka kuuluvat palveluun. Lisätietoa palvelusta saat Valtiokonttorista osoitteesta verkkomaksaminen@valtiokonttori.fi.
