Maksutavat
Stripe- ja Paytrail-maksuintegraatioiden määrittäminen ja aktivointi kassalle
Putiikkipalvelu tukee kahta maksuintegraatiota: Stripe kansainvälisille korttimaksuille (Visa, MasterCard, Apple Pay, Google Pay ym.) ja Paytrail suomalaisille verkkopankki- ja mobiilimaksuille (OP, Nordea, MobilePay, Pivo, Siirto ym.).
Sivu löytyy hallintapaneelista kohdasta Asetukset → Maksutavat.
Vain yksi maksutapa kerrallaan
Voit määrittää molemmat maksutavat valmiiksi, mutta kassalla näkyy aina vain yksi aktiivinen maksutapa. Kun aktivoit toisen, järjestelmä poistaa automaattisesti aiemman aktivoinnin.
Ennen kuin aloitat
- Kaupan perustiedot ovat täytetty (Asetukset → Kaupan asetukset). Maksutavat-sivu näyttää ohjeen täydentää asetukset, jos näin ei ole tehty.
- Paytrailin osalta kaupan perustiedoissa on oltava Y-tunnus — Paytrail-kortti on himmennetty ilman sitä, ks. Kaupan asetukset Y-tunnuksesta tarkemmin.
Stripe — ohjattu käyttöönotto
Stripen käyttöönotto on ohjattu — klikkaat painiketta hallintapaneelissa, ja sinut ohjataan suoraan Stripen omaan rekisteröitymislomakkeeseen, jossa täytät tiedot ja palaat takaisin valmiilla integraatiolla.
1. Käynnistä rekisteröinti
Klikkaa Stripe-kortin Lisää Stripe maksutapa -painiketta. Putiikkipalvelu luo taustalla Stripe Connect Standard -tilin Suomessa ja rakentaa sinulle Stripen account onboarding -linkin, johon selain ohjautuu välittömästi.
2. Täytä tiedot Stripen sivuilla
Stripen lomakkeella sinulta kysytään mm.:
- Yritystyyppi ja Y-tunnus (jos yritys) tai henkilötunnus (jos yksityishenkilö)
- Pankkitili maksujen tilitykseen
- Verkkokaupan kuvaus (toimiala, tuotteet)
- Vahvistusasiakirjat (henkilöllisyystodistus, mahdollisesti yritystiedot)
Stripe käsittelee tunnistamisen ja KYC-vaatimukset puolestasi — Putiikkipalvelu ei tallenna sinun pankki- tai henkilötietojasi.
3. Palaa Putiikkipalveluun
Stripen sivuilta on Palaa Putiikkipalveluun -painike. Klikkaus palauttaa sinut hallintapaneeliin, jossa Stripe-kortin tila päivittyy automaattisesti.
Stripen tilat
Stripe-kortti voi näyttää viittä eri tilaa, ja kunkin alla on toimintapainikkeet:
| Tila | Mitä se tarkoittaa |
|---|---|
| Ei aktiivinen | Ei vielä asennettu — paina Lisää Stripe maksutapa |
| Vahvistus vaaditaan | Stripe-tili on luotu, mutta osa tiedoista on vielä täyttämättä. Saat keltaisen Täydennä vahvistus -painikkeen, joka ohjaa takaisin Stripen lomakkeelle siitä kohdasta, johon jäit |
| Rajoitettu | Stripe on rajannut tilin (esim. lisäasiakirjapyyntö). Maksuja ei voi vastaanottaa, kunnes asia on käsitelty Stripe Dashboardissa |
| Ei käytössä | Asennettu mutta ei aktivoitu kassalle. Kortilla on Aktivoi-painike |
| Aktiivinen | Käytössä kassalla (vihreä reunus). Deaktivoi-painike sammuttaa sen ilman poistoa |
Stripen poisto
Aktiivisen tai Ei käytössä -tilassa olevan Stripen voi poistaa Poista-painikkeella. Vahvistusdialogi muistuttaa, että aiemmat tilaukset säilyvät, ja että uusi käyttöönotto vaatii Stripe-tilin luomisen alusta.
Paytrail — käsin syöttäminen
Paytrail edellyttää, että rekisteröidyt ensin Paytrailin omaan palveluun ja saat sieltä Kauppias-ID:n ja Kauppiasvarmenteen (secret key). Nämä syötetään hallintapaneelin omaan modaaliin.
1. Hae Kauppias-ID ja Kauppiasvarmenne Paytrailista
Paytrail itse on tehnyt ohjeen siitä, mistä kohtaa heidän Merchant Panelistaan tunnukset löytyvät:
Kuinka löydät Kauppias-ID:n ja Kauppiasvarmenteen — Paytrailin tukisivut
Lyhyesti:
- Kirjaudu Paytrailin Merchant Paneliin osoitteessa merchant.paytrail.com
- Valitse oikea kauppa, jos sinulla on niitä useita
- Kauppias-ID on numerosarja, joka näkyy paneelissa
- Kauppiasvarmenne löytyy Tekniset tiedot -osiosta — kopioi se huolellisesti
2. Liitä tunnukset Putiikkipalveluun
Paytrail-kortin Lisää Paytrail maksutapa -painike avaa modaalin, jossa on kaksi kenttää:
| Kenttä | Mihin liitetään |
|---|---|
| Kauppias ID | Kopioitu numerosarja Paytrailin paneelista |
| Kauppiasvarmenne | Kopioitu salainen avain Paytrailin Tekniset tiedot -osiosta |
Painikkeella Lisää Paytrail maksutapa modaali tallentaa tunnukset. Itse Kauppiasvarmenne salataan ja säilytetään AWS Secrets Managerissa — se ei ole enää luettavissa hallintapaneelista syötön jälkeen.
Testitunnukset on estetty tuotannossa
Paytrailin julkiset testitunnukset (Kauppias-ID 375917 ja Kauppiasvarmenne SAIPPUAKAUPPIAS) on estetty Putiikkipalvelussa. Käytä aina oikean kauppasi tunnuksia.
Paytrailin tilat
| Tila | Mitä se tarkoittaa |
|---|---|
| Ei aktiivinen | Tunnuksia ei ole vielä syötetty — Lisää Paytrail maksutapa avaa syöttömodaalin |
| Ei käytössä | Tunnukset tallennettu mutta ei aktivoitu kassalle. Aktivoi-painike kytkee päälle |
| Aktiivinen | Käytössä kassalla (vihreä reunus). Deaktivoi sammuttaa ilman poistoa |
Tunnusten päivittäminen
Jos Paytrail antaa sinulle uudet tunnukset (esim. salaisuus on vuotanut), klikkaa Muokkaa Paytrail maksutapaa ja syötä uudet arvot. Vanha varmenne korvautuu välittömästi.
Paytrailin poisto
Poista-painike pyyhkii integraation kokonaan. Vahvistusdialogi muistuttaa, että aiemmat tilaukset säilyvät — poisto vaikuttaa vain uusiin tilauksiin.
Aktivointi kassalle
Kun olet määrittänyt vähintään yhden maksutavan, aktivoi se kassalle. Tämä voi tapahtua kahdella tavalla:
- Stripe muuttuu automaattisesti aktiiviseksi kun Stripen käyttöönotto on suoritettu loppuun (tila vaihtuu Aktiivinen-merkinnäksi)
- Paytrail ja deaktivoidut Stripe-tilit aktivoidaan Aktivoi-painikkeella kortin alalaidassa
Aktivointi vaihtaa toisen pois päältä
Voit pitää vain yhtä maksutapaa aktiivisena kerrallaan. Jos Stripe on aktiivinen ja klikkaat Aktivoi Paytrailin kortilla, Stripe siirtyy automaattisesti Ei käytössä -tilaan. Aiemmin tehdyt tilaukset eivät kärsi vaihdosta — se vaikuttaa vain siihen, kumpi maksutapa näkyy uusille asiakkaille kassalla.
Kumpi kannattaa valita?
| Tilanne | Suositus |
|---|---|
| Asiakkaat ovat enimmäkseen suomalaisia ja haluavat verkkopankki- tai MobilePay-maksuja | Paytrail — kattaa kaikki kotimaiset pankit ja mobiilimaksuvälineet |
| Asiakkaat ovat kansainvälisiä ja haluavat korttimaksun (ml. Apple Pay, Google Pay) | Stripe — toimii kaikkialla ja tukee laajaa korttivalikoimaa |
| Y-tunnusta ei ole tai et halua rekisteröidä yritystä | Stripe — ei välttämättä edellytä Y-tunnusta |
| Y-tunnus on, ja asiakkaat odottavat suomalaisia maksutapoja | Paytrail — Y-tunnus on pakollinen |
Voit myös vaihtaa maksutavasta toiseen koska tahansa — molemmat voivat olla määriteltyinä rinnakkain ja aktivointia voi vaihtaa tarpeen mukaan.
Liittyvät aiheet
- Kaupan asetukset — Y-tunnus ja muut perustiedot
- Toimitustavat