Stripe
Kaikki Stripe-tilillä aktivoidut maksutavat kassalla — kortit, Klarna, PayPal ja muut.
Käyttöönotto
Tarvitset Stripe-tilin. Löydät tunnistetiedot Stripe-hallintapaneelista kohdasta Developers → API keys.
Jos sinulla on useita kassoja, suosittelemme luomaan jokaiselle kassalle oman Stripe-tilin. Stripe mahdollistaa tilien ryhmittelyn yhden organisaation alle, jolloin voit hallita kaikkia tilejä yhdestä hallintapaneelista. Erilliset tilit mahdollistavat maksutapojen itsenäisen konfiguroinnin kassakohtaisesti ja varmistavat webhookien optimaalisen toiminnan.
| Asetus | Kuvaus |
|---|---|
| Publishable key (julkinen avain) | Stripen julkinen avain. Alkaa pk_live_ tai pk_test_. |
| Secret key (salainen avain) | Stripen salainen avain. Alkaa sk_live_ tai sk_test_. |
| Ota maksutapa käyttöön | Aktivoi Stripe-integraatio kassalla. |
| Lisää maksujen webhook Stripeen (suositeltu) | Lisää webhookin automaattisesti Stripe-tiliisi, joka käsittelee maksujen onnistumis- ja epäonnistumistapahtumat. |
pk_test_- ja sk_test_-avaimet ovat vain testausta varten. Muista vaihtaa pk_live_- ja sk_live_-avaimiin ennen kuin otat kassan tuotantokäyttöön.
Stripe vaatii tilauksen loppusummalle minimimäärän — esimerkiksi EUR-valuutassa vähintään 0,50 €. Jos alennuskoodi tai muu alennus laskee summan alle minimin, maksaminen epäonnistuu.
Maksutavat
Verkkokurssikassa käyttää Stripe Payment Elementia, joka näyttää kassalla automaattisesti kaikki Stripe-tilillesi aktivoidut maksutavat — esimerkiksi kortit, Klarna, PayPal ja muut. Näytettävät maksutavat suodattuvat automaattisesti valuutan, asiakkaan sijainnin ja maksusumman perusteella. Katso tuetut maksutavat Stripen dokumentaatiosta.
Ota haluamasi maksutavat käyttöön Stripe-hallintapaneelissa ja seuraa kunkin maksutavan omia ohjeita. Osa maksutavoista edellyttää lisäkonfigurointia — esimerkiksi verkkotunnuksen rekisteröintiä maksutavan asetuksissa ennen kuin se näkyy kassalla.
Stripe määrittää automaattisesti näytettävät maksutavat asiakkaan sijainnin, valuutan ja maksusumman perusteella — et siis itse valitse, mitä maksutapoja kassalla näytetään. Jos haluat testata miltä kassa näyttää tietyssä maassa, käytä VPN:ää ja valitse kohdemaa.
Webhook
Stripe-integraatio vaatii webhookin, jotta maksujen vahvistus toimii luotettavasti. Verkkokurssikassa voi lisätä webhookin Stripe-tiliisi automaattisesti — rastita tämä vaihtoehto maksuasetuksissa.
Webhook kuuntelee payment_intent.succeeded- ja payment_intent.payment_failed-tapahtumia, jotka kutsuvat Verkkokurssikassan rajapintaa maksun tuloksen vahvistamiseksi tai kirjaamiseksi. Ilman webhookia maksun vahvistus voi viivästyä tai epäonnistua.