WooCommerce Paytrail – Ohje

1. Asentaminen

Lisäosan asentaminen vastaa normaalin WordPressin lisäosan asentamista.

1. Lataa tilausvahvistuksen latauslinkistä lisäosa zip-paketissa.
2. Mene WordPressin ylläpito > Lisäosat > Lisää uusi > Lataa lisäosa ja lataa lisäosan zip-paketti
3. Klikkaa Ota käyttöön
4. Lisäosa on nyt asennettu. Seuraavaksi tulee syöttää asetukset

2. Asetukset

Lisäosa sisältää integraation Paytrailin uuteen lokakuussa 2021 julkaistuun rajapintaan sekä vanhaan E2-rajapintaan. Integraatiot löytyvät erillisinä maksutapoina asetuksista. Valitse oikeat asetukset sen mukaan, kumman rajapinnan otat käyttöön. Paytrailin uudet asiakkaat lokakuusta 2021 lähtien kuuluvat yleensä uuteen rajapintaan.

Uusi rajapinta: WooCommerce > Asetukset > Maksut > Paytrail (uusi)
Vanha rajapinta: WooCommerce > Asetukset > Maksut > Paytrail

1. Mene WooCommerce > Asetukset > Maksut > Paytrail
2. Syötä seuraavat asetukset
   1. Aktivoi Paytrail
   2. Maksaminen – käytetäänkö maksusivua vai sen ohitusta
   3. Kauppiastunnus
   4. Kauppiasvarmenne
   5. Kieli
   6. Nimi – millä nimellä Paytrail esitetään kassalla, esim. ”Maksu verkkopankissa tai kortilla”
   7. Kuvaus – miten maksutapaa kuvataan kassalla, esim. ”Maksu verkkopankissa tai kortilla Paytrailin kautta”
3. Klikkaa Tarkista tunnukset tarkistaaksesi tunnusten toimivuuden
4. Klikkaa Tallenna

Lisäosa on nyt valmis vastaanottamaan maksuja.

2.1 Testitunnukset (uusi rajapinta)

Maksamista voi kokeilla Paytrailin testitunnuksilla ilman oikeaa rahaa esimerkiksi Osuuspankin kautta.

Paytrailin testitunnukset uuteen rajapintaan

Kauppias ID: 375917
Kauppiasvarmenne: SAIPPUAKAUPPIAS

Osuuspankin testitunnukset

Käyttäjätunnus: 123456
Salasana: 7890
Avainluku: 1234

2.2 Yksittäistilitykset

Lisäosa tukee Paytrailin yksittäistilityksiä, missä jokainen maksu tilitetään erikseen omalla viitenumerollaan. Yksittäistilityksiä varten on laskettava pankkiviitenumero WooCommercen puolella, jota varten lisäosasta löytyy viitenumerolaskuri. Lisäosa muodostaa viitenumeron tilausnumerosta lisäämällä siihen vapaavalintaisen etuliitteen (esim. 10) ja laskemalla viitteen tarkisteen.

Yksittäistilitykset otetaan käyttöön seuraavasti:

1. Aktivoi yksittäistilitykset lisäosan asetuksista (WooCommerce > Asetukset > Maksut > Paytrail (uusi) > Yksittäistilitykset > Käytä yksittäistilityksiä)
   1. Valitse myös viitenumeroiden etuliite, esimerkiksi 10. Etuliitteen ansiosta tilitykset on helppo erottaa tiliotteelta
2. Ota yhteyttä Paytrailin asiakaspalveluun ja pyydä aktivoimaan yksittäistilitykset

Tärkeää! Yksittäistilitykset on aktivoitava lisäosan puolelta ennen Paytrailin puolelta aktivointia, koska Paytrail tarkistaa viitenumeron oikeellisuuden ja ilman oikeaa viitenumeroa maksut epäonnistuisivat. Sen sijaan ei ole haittaa, vaikka viitenumerolaskuri olisi käytössä lisäosan puolella ilman yksittäistilityksiä.

Kun Paytrail on aktivoinut yksittäistilitykset, tulevat maksut tilitetään omina suorituksinaan. Tilauksen viitenumero löytyy myös ylläpidon tilausnäkymästä:

3. Maksunpalautus WooCommercesta

Lisäosan avulla on mahdollista palauttaa maksu suoraan WooCommercesta.

1. Mene WooCommerce > Tilaukset > [tilaus]
2. Klikkaa Hyvitys tuoterivien alta
3. Valitse palautettavat tuotteet ja tarkista summa
4. Klikkaa Hyvitä x,xx € käyttäen Paytrail, jolloin maksunpalautus lähetetään automaattisesti Paytrailille käsiteltäväksi

4. Uuteen Paytrailiin siirtyminen

Paytrailin uuteen rajapintaan siirtyminen on hyvin helppoa. Siirtymisessä on kolme vaihetta:

1. Lisäosan päivittäminen 2.x.x versioon
2. Uuden rajapinnan asetusten syöttäminen
3. Vanhan rajapinnan käytöstä poisto

Erittäin tärkeää! Varmista ettei kaupassa ole samaan aikaan päällä useita eri Paytrail tai Checkout lisäosia. Eri integraatiot samaan maksutapaan käyttävät samoja teknisiä ID:tä, joka aiheuttaa ongelmia maksujen kirjaamisessa verkkokauppaan.

1. Lisäosan päivittäminen 2.x.x versioon

Lisäosan voi päivittää 2.x.x versioon suoraan kohdasta WordPressin ylläpito > Lisäosat > WooCommerce Paytrail. Mikäli WordPress ei automaattisesti tarjoa uutta versiota, voi päivityksen hakea Tarkista päivitykset linkistä.

Mikäli automaattinen päivitys ei jostain syystä toimi, lisäosan voi päivittää myös manuaalisesti lataamalla tilausvahvistuksen latauslinkistä uusimman version ja lataamalla sen kohdasta WordPressin ylläpito > Lisäosat > Lisää uusi.

2. Uuden rajapinnan asetusten syöttäminen

Uuden rajapinnan asetukset syötetään kohdasta WooCommerce > Asetukset > Maksut > Paytrail (uusi). Asetuksiin tarvitaan kauppias ID ja -varmenne, jotka saadaan Paytraililta. Varmista myös, että kohta Aktivoi Paytrail on valittu.

3. Vanhan rajapinnan käytöstä poisto

Vanha rajapinta poistetaan käytöstä kohdasta WooCommerce > Asetukset > Maksut. Vanha rajapinta on nimellä Paytrail ja uusi Paytrail (uusi).

Varmista myös ettei kaupassa ole aktiivisena samaan aikaan muiden kehittäjien Paytrail-lisäosia. Jos samalle maksutavalle on useita eri lisäosia, aiheuttaa se yhteensopivuusongelman. Aktiiviset lisäosat näkee kohdasta WordPressin ylläpito > Lisäosat.