Siirry sisältöön

Näin otat Stripen käyttöön Johkussa

Tämä ohje vie sinut uuden Stripe-tilin luomisesta siihen, että asiakkaasi voivat maksaa Johku-kauppapaikalla Stripen kautta. Aikaa kuluu noin 30–60 minuuttia, ja lisäksi Stripen tarkastus voi kestää tunneista muutamaan päivään.

Lyhyesti: Johku käyttää Stripen omaa maksusivua (Stripe Checkout). Stripeen tarvitsee tehdä vain kolme asiaa: aktivoida tili, valita maksutavat ja kopioida kaksi avainta Johkuun. Johku luo webhookin (maksuilmoitukset) automaattisesti, eikä sitä tarvitse yleensä tehdä käsin.

Stripessä ei tarvitse luoda checkoutia, maksulinkkiä tai tuotteita (esimerkiksi Create checkout, Payment Links tai Product catalog). Johku luo maksusivun jokaiselle tilaukselle automaattisesti. Jos olet jo aloittanut checkoutin luomisen Stripessä, voit poistaa luonnoksen.

Ennen kuin aloitat

Tarvitset:

  • yrityksen Y-tunnuksen ja virallisen nimen

  • yrityksen osoitteen ja puhelinnumeron

  • verkkosivujen osoitteen (Johku-kauppapaikkasi osoite käy)

  • vastuuhenkilön henkilötiedot ja henkilöllisyystodistuksen (passi, ajokortti tai henkilökortti)

  • tiedot omistajista ja hallituksen jäsenistä (osakeyhtiöillä)

  • yrityksen pankkitilin IBAN-numeron

  • pääsyn Johkun hallintaan ylläpitäjän oikeuksilla

Maksunvälitys on maksullista, ja Stripe perii kustannukset suoraan sinulta: Johku ei ole niissä osapuolena.

Stripen hallintapaneeli (Dashboard) on usein englanninkielinen, joten valikoiden nimet on kirjoitettu alla lihavoituina ja englanniksi niin kuin ne Stripessä näkyvät. Stripe muuttaa valikoitaan ajoittain. Jos valikkoa ei löydy, käytä suoria linkkejä tai Dashboardin hakukenttää.

Osa 1: Luo ja aktivoi Stripe-tili

1. Luo Stripe-tili

  1. Mene osoitteeseen dashboard.stripe.com/register.

  2. Anna sähköpostiosoite, nimesi ja salasana, ja valitse maaksi Finland. Maata ei voi muuttaa myöhemmin.

  3. Vahvista sähköpostiosoite Stripen lähettämästä viestistä.

  4. Ota kaksivaiheinen tunnistautuminen käyttöön, kun Stripe sitä pyytää. Tarvitset sitä myöhemmin avainten käsittelyyn.

2. Aktivoi tili oikeiden maksujen vastaanottamista varten

Uusi tili toimii aluksi vain testitilassa (Sandbox). Oikeiden maksujen vastaanottamiseksi yritys pitää tunnistaa.

  1. Klikkaa Dashboardin etusivulla Activate payments tai Complete your account setup. Saman lomakkeen löydät myös kohdasta Settings → Business → Account status.

  2. Täytä lomake:

    • Business type: yritysmuoto, esimerkiksi Company (Oy) tai Individual / Sole proprietor (toiminimi).

    • Business details: yrityksen virallinen nimi ja Y-tunnus (Business ID / Company registration number), osoite ja puhelinnumero, toimiala, verkkosivujen osoite (esimerkiksi Johku-kauppapaikkasi osoite) ja lyhyt kuvaus siitä, mitä myyt (esim. ”Elämyspalvelut ja aktiviteettien lipunmyynti verkossa”).

    • Representative (vastuuhenkilö): nimi, syntymäaika, kotiosoite, sähköposti ja puhelin. Stripe voi kysyä suomalaista henkilötunnusta ja kuvaa henkilöllisyystodistuksesta. Lataa se vain Stripen Dashboardin kautta, älä koskaan sähköpostilla.

    • Owners / Directors: yli 25 % omistavat henkilöt ja hallituksen jäsenet (osakeyhtiöt).

    • Bank account (Payouts): yrityksen tilin IBAN. Tilin tulee olla yrityksen nimissä.

    • Public details / Statement descriptor: teksti, joka näkyy asiakkaan tiliotteella. Käytä nimeä, jonka asiakas tunnistaa, esimerkiksi yrityksesi tai brändisi nimeä. Tekstissä pitää olla vähintään 5 merkkiä, ja sen täytyy muistuttaa yrityksen nimeä tai verkko-osoitetta. Tunnistamaton veloitus johtaa helposti takaisinperintään.

  3. Lähetä tiedot. Stripe tarkistaa ne yleensä nopeasti, mutta se voi pyytää lisäasiakirjoja. Seuraa tilannetta kohdasta Settings → Business → Account status ja Stripen lähettämistä sähköposteista.

Valmis, kun: Dashboardissa ei enää näy aktivointikehotetta, eikä Account status -sivulla ole avoimia pyyntöjä.

3. Tarkista asiakkaalle näkyvät tiedot (suositeltava)

  • Settings → Business → Public details: näkyvä yritysnimi, asiakastuen sähköposti ja puhelin, verkkosivu ja tiliotteella näkyvä teksti (Statement descriptor).

  • Settings → Branding (valinnainen): logo, ikoni ja värit. Nämä näkyvät Stripen maksusivulla, jolle asiakkaasi ohjataan Johkusta.

Osa 2: Valitse maksutavat

Johku ohjaa asiakkaan Stripen omalle maksusivulle, joka näyttää automaattisesti ne maksutavat, jotka olet laittanut päälle Stripessä. Johkussa ei tarvitse valita maksutapoja erikseen.

4. Valitse maksutavat

  1. Mene kohtaan Settings → Payments → Payment methods (suora linkki: dashboard.stripe.com/settings/payment_methods).

  2. Jos asetuksia on useita, varmista, että ylhäällä on valittuna oletusasetus (Default).

  3. Suosittelemme laittamaan päälle (Turn on):

    • Cards (Visa, Mastercard ym.): pakollinen, ja yleensä valmiiksi päällä.

    • Apple Pay ja Google Pay: toimivat Stripen maksusivulla ilman lisäasetuksia. Verkkotunnusta ei tarvitse rekisteröidä, koska maksusivu on Stripen.

    • Link (Stripen tallennetut kortit): vapaaehtoinen.

    • Klarna: vapaaehtoinen, ja siihen liittyy omat ehtonsa.

  4. Suosittelemme jättämään pois päältä maksutavat, joissa maksu vahvistuu viiveellä (delayed notification), kuten SEPA Direct Debit ja pankkisiirrot (Bank transfers). Johku pitää varauksen voimassa vain rajallisen ajan. Jos maksu vahvistuu vasta päivien päästä, varaus voi ehtiä vapautua.

Osa 3: Kopioi API-avaimet

Johku tarvitsee Stripestä kaksi avainta:

Stripen nimi

Alkaa

Johkun kenttä

Huom.

Publishable key

pk_live_

Julkinen avain

Ei ole salainen.

Secret key

sk_live_

Salainen avain

Salainen! Älä lähetä sitä sähköpostilla tai chatissa kenellekään, ei myöskään Johkun tukeen. Liitä se suoraan Johkuun.

5. Kopioi avaimet

  1. Varmista, että Dashboard on live-tilassa eikä testitilassa.

    • Testitilan tunnistaa siitä, että Dashboardin ylälaidassa näkyy teksti Sandbox tai Test mode. Palkin väri vaihtelee.

    • Live-avaimet alkavat pk_live_ ja sk_live_. Testiavaimet alkavat pk_test_ ja sk_test_.

  2. Mene kohtaan Developers → API keys. Uudemmissa Dashboardeissa sama löytyy kohdasta Workbench → API keys (suora linkki: dashboard.stripe.com/apikeys).

  3. Kohdassa Standard keys:

    • Kopioi Publishable key (pk_live_…).

    • Klikkaa Secret key -rivillä Reveal live key ja kopioi avain (sk_live_…).

    • Stripen valmiiksi luoman salaisen avaimen voi näyttää uudelleen myöhemminkin. Itse luodun avaimen Stripe näyttää vain kerran.

  4. Jos olet hukannut salaisen avaimen tai se on päässyt vääriin käsiin, valitse avaimen rivillä ⋯ → Rotate key ja liitä uusi avain Johkuun.

Edistyneille: Stripe suosittelee rajattuja avaimia (Restricted key, rk_live_…). Ne toimivat Johkussa, kunhan oikeudet ovat riittävät. Katso Stripen rajattu avain Johkussa. Jos et ole varma, käytä tavallista Secret key -avainta.

Osa 4: Kytke Stripe Johkuun

6. Liitä avaimet Johkuun

  1. Kirjaudu Johkun hallintaan.

  2. Avaa Asetukset → Perusasetukset → Maksaminen ja napsauta Stripe-otsikkoa. Paneelin löytää myös asetusten hausta sanalla ”Stripe”.

  3. Täytä kentät:

    • Otsikko: maksutavan nimi kauppapaikalla, esim. ”Kortti, Apple Pay, Google Pay, MobilePay”. Jos jätät kentän tyhjäksi, nimeksi tulee ”Stripe”.

    • Salainen avain: sk_live_…

    • Julkinen avain: pk_live_…

    • Webhook-salaustunniste: jätä tyhjäksi. Johku täyttää kentän itse.

    • Maksutapalisä (€ tai %): vapaaehtoinen. Huomaa, että kuluttajilta ei EU:ssa yleensä saa periä lisämaksua kortti- tai mobiilimaksusta.

  4. Klikkaa Tallenna. Tallennuksen yhteydessä Johku luo Stripe-tilillesi automaattisesti webhookin ja tallentaa sen salaustunnisteen. Webhook on maksuilmoitus, jolla Stripe kertoo Johkulle maksun onnistuneen.

7. Ota maksutapa käyttöön

  1. Avaa Stripe-paneeli uudelleen. Jos kenttä ei ole täyttynyt, päivitä selainsivu.

  2. Tarkista, että Webhook-salaustunniste on nyt täytetty (whsec_…). Jos kenttä jäi tyhjäksi, katso Jos jokin ei suju.

  3. Rastita paneelin alareunasta Käytössä ja valittavissa verkkotilauksille. Ruutu on harmaa, kunnes kaikki kolme avainkenttää on täytetty.

  4. Klikkaa Tallenna.

Stripe-paneelin otsikkoon tulee nyt merkintä Verkossa.

8. Tarkista webhook Stripessä (suositeltava)

  1. Mene Stripessä kohtaan Developers → Webhooks tai uudemmissa Dashboardeissa Workbench → Webhooks (suora linkki: dashboard.stripe.com/webhooks).

  2. Listalla pitäisi olla Johkun luoma osoite https://johku.com/api/stripe/.

  3. Älä poista tai muuta sitä.

Osa 5: Testaa oikealla maksulla

9. Tee koeosto

  1. Avaa Johku-kauppapaikkasi ja lisää ostoskoriin edullinen tuote. Stripen minimimaksu on 0,50 €. Voit tehdä testiä varten piilotetun 1 € tuotteen.

  2. Valitse maksutavaksi Stripe (tai antamasi otsikko) ja maksa omalla kortillasi tai MobilePaylla. Apple Pay ja Google Pay näkyvät vain, jos laitteesi tukee niitä.

  3. Tarkista:

    • Palaat maksun jälkeen kauppapaikan kiitossivulle.

    • Saat tilausvahvistuksen ja mahdolliset liput sähköpostiin.

    • Tilaus näkyy Johkussa maksettuna, ja siitä on muodostunut tosite.

    • Stripessä maksu näkyy kohdassa Payments tilassa Succeeded.

    • Stripessä kohdassa Webhooks → (Johkun webhook) → Event deliveries tapahtumilla on tila Delivered (200).

  4. Palauta koeosto: etsi maksu Stripen kohdasta Payments, valitse Refund ja tee Johkussa Hyvitä tosite.

  5. Jos teit testituotteen, pidä se piilotettuna tai poista se testin jälkeen, jotta se ei näy kauppapaikallasi.

Korttitiedot syötetään Stripen maksusivulle, eivätkä ne tallennu Johkuun. Stripen banneria ei aseteta Johkuun itse: se näytetään tilaussivun alareunassa automaattisesti, kun asiakas valitsee maksutavaksi Stripen.

Samat avaimet useassa saman yrityksen Johku-kaupassa

  1. Kopioi kaupastasi Stripe-maksutavan salainen avain, julkinen avain ja webhook-salaustunniste.

  2. Liitä ne toisen Johku-kauppasi vastaaviin kenttiin.

  3. Valitse Käytössä ja valittavissa verkkotilauksille ja tallenna.

  4. Testaa maksaminen kyseisessä kaupassa.

Hyvä tietää

  • Palautukset: Stripe-maksut palautetaan asiakkaalle Stripen palvelussa (Payments → maksu → Refund). Tee Johkussa lisäksi Hyvitä tosite: se kirjaa hyvityksen Johkun raportteihin, mutta se ei palauta Stripe-maksua.

  • Rahan tilitys: Stripe tilittää myynnit pankkitilillesi automaattisesti. Ensimmäinen tilitys tulee yleensä noin viikon viiveellä, ja aikataulua voi muuttaa kohdassa Settings → Payouts. Stripen palkkiot vähennetään tilityksistä.

Jos jokin ei suju

Webhook-salaustunniste ei täyttynyt tallennuksessa

Johku ei luo webhookia, jos Stripessä on jo webhook samaan osoitteeseen, esimerkiksi toisen Johku-kauppasi vuoksi tai käsin tehtynä.

  1. Avaa Stripessä Webhooks ja klikkaa Johkun webhookia (https://johku.com/api/stripe/).

  2. Klikkaa Signing secret -kohdassa Reveal ja kopioi tunniste (whsec_…).

  3. Liitä se Johkun kenttään Webhook-salaustunniste ja tallenna.

Vaihtoehtoisesti voit poistaa vanhan webhookin Stripestä, tyhjentää Johkun salaustunnistekentän ja tallentaa uudelleen, jolloin Johku luo webhookin uudestaan. Älä tee tätä, jos sama webhook on käytössä toisessa Johku-kaupassasi.

Maksu onnistui Stripessä, mutta tilaus jäi Johkussa maksamattomaksi, ja Stripessä näkyy webhook-virhe 400

Webhook-salaustunniste ei vastaa Stripen webhookia. Yleisin syy on, että avaimet on vaihdettu testiavaimista live-avaimiin, mutta salaustunniste on jäänyt testitilan ajalta.

  1. Tyhjennä Johkussa kenttä Webhook-salaustunniste.

  2. Tallenna. Johku luo nyt live-tilan webhookin.

  3. Avaa paneeli uudelleen, rastita Käytössä ja valittavissa verkkotilauksille ja tallenna.

Jos Stripessä on jo live-tilan webhook samaan osoitteeseen, kopioi sen tunniste käsin edellisen kohdan ohjeen mukaan. Muut tarkistukset: Maksu veloitettu, mutta tilausta ei näy Johkussa.

Tallennus antaa virheen avaimia lisätessä

  • Salainen avain on kopioitu kokonaan, eikä sen alussa tai lopussa ole välilyöntejä.

  • Julkinen ja salainen avain ovat samasta tilasta, eli molemmat ovat live tai molemmat test.

  • Jos käytät rajattua avainta (rk_), sillä on tarvittavat oikeudet.

Asiakas ei näe Apple Payta, Google Payta tai MobilePayta

  • Maksutapa on päällä kohdassa Settings → Payments → Payment methods.

  • Kaupan valuutta on euro.

  • Asiakkaan laitteessa on lompakko käytössä. Apple Pay näkyy varmimmin Safarissa ja Applen laitteilla.

Hyvitit tilauksen Johkussa, mutta asiakas ei saanut rahojaan

Tee palautus Stripen palvelussa. Johkun hyvitys ei siirrä rahaa Stripe-maksuissa. Tarkistuspolku: Hyvitys ei näy asiakkaalla.

Haluan testata ennen kuin otan oikeat maksut vastaan

Voit käyttää Stripen testitilan (Sandbox / Test mode) avaimia (pk_test_ / sk_test_) ja testikorttia 4242 4242 4242 4242.

  • Kun siirryt oikeisiin maksuihin, vaihda tilalle live-avaimet ja tyhjennä samalla Webhook-salaustunniste ennen tallennusta.

  • Testiavaimilla kauppapaikkasi oikeat asiakkaat eivät pysty maksamaan. Testaa siis hiljaisena aikana.

Liittyvät aiheet