commerce_paytrail_fi
Paytrail maksumoduuli Drupal Commerce verkkokauppaan
Drupal 7.x / Drupal Commerce 1.x
Page 1
Copyright © Xocovis
Yleistä
Paytrail maksupalvelu
Paytrail maksupalvelu sisältää kaikkien suomalaisten pankkien verkkomaksupainikkeet, korttimaksamisen ja
laskulla ostamisen.
Paytrail maksumoduuli
Maksumoduulin integrointi on toteutettu käyttäen Paytrailin (ent. Suomen Verkkomaksujen) laajempaa
rajapintaversiota E1. E1-versiossa Paytrail palveluun välitetään maksutietojen lisäksi tilaajan tiedot (nimi,
yritys ja osoite) sekä tiedot tilattavista tuotteista. Laajempi rajapintaversio mahdollistaa seuraavat edut:



Paytrailin kauppiaspaneelissa näytetään tilaajan tiedot sekä yksityiskohtainen luettelo tilatuista
tuotteista
Laskulla- ja Osamaksulla-palvelut ovat käytettävissä (Collector, Klarna ja Joustoluotto)
Maksutavoille voidaan määritellä maksutapalisiä (euro- tai prosenttimääräinen lisämaksu tietyn
maksutavan käyttämisestä).
Paytrailin maksumoduulin käyttö edellyttää palvelusopimusta Paytrailin kanssa. Jos et ole vielä tilannut
Paytrail maksupalvelua käyttöösi niin voit tilata palvelun osoitteesta:
https://ssl.paytrail.com/register//index/index/rid/238604
Paytrail maksupalvelun hinnasto löytyy osoitteesta: http://paytrail.com/fi/hinnasto
Palvelun tilauksen yhteydessä muista mainita/lisätä seuraava jälleenmyyjätunnus (238604 tai Xocovis)
ja lisätiedot kenttään maininta Drupal Commerce.
Muistathan mainita jälleenmyyjätunnuksen ja uuden verkkokauppa-alustan, jos olet siirtänyt nykyisen
verkkokauppasi Drupal Commerceen.
Jälleenmyyjätunnuksen avulla Paytrail pystyy olemaan suoraan yhteydessä moduulin kehittäjään esim
rajapintamuutoksissa tai mahdollisissa ongelmatilanteissa.
Page 2
Copyright © Xocovis
Paytrail maksumoduulin käyttöönotto Drupal Commerce –
verkkokaupassa
Järjestelmävaatimukset
Paytrail maksumoduulilla on seuraavat järjestelmävaatimukset:
Järjestelmävaatimus
Drupal Commerce
Drupal
PHP
Tuetut versiot
1.3 – 1.x
7.x
5.2.x+
Asennus
Paytrail maksumoduulin asennus noudattelee normaalia moduulien asennusohjetta Drupal
sisällönhallintaohjelmistolle:
Asennus käyttöliittymän kautta:
1. Navigoi Drupalin ylläpitosivuilta Ylläpito - Sivuston rakentaminen - Moduulit – Asenna uusi
moduuli (Administer – Site building – Modules - Install new module, url: admin/modules/install)
2. Valitse Lataa moduuli tai teema joka asennetaan vaihtoehto ja klikkaa Browse. Hae moduulin
asennuspaketti (esim. commerce_paytrail_fi-7.x-1.0.tar.gz) tiedostojärjestelmästä ja klikkaa lopuksi
Asenna.
Asennus suoraan tiedostojärjestelmän kautta:
1. Kopio commerce_paytrail_fi -7.x-1.x.tar.gz Drupal asennuksen /sites/all/modules –hakemistoon
(oletus) ja pura pakattu tiedosto
2. Navigoi Drupalin ylläpitosivuilta Ylläpito - Sivuston rakentaminen - Moduulit (Administer – Site
building – Modules, url: admin/modules)
3. Enabloi Paytrail –moduuli (Commerce (contrib) –ryhmässä)
4. Valitse lopuksi Tallenna asetukset (Save configuration)
Page 3
Copyright © Xocovis
Käyttöönotto
Asetusten määrittely
commerce_paytrail_fi maksumoduulin asetusten määrittely tapahtuu Ylläpito - Verkkokaupan hallinta Asetukset - Maksuasetukset (Admistration – Store – Configuration – Payment settings) osiossa.
1. Etsi maksutapalistasta Paytrail maksupalvelu ja valitse Muokkaa (Edit)
2. Etsi avautuvasta Muokkaa maksutavan sääntöjä –sivusta (Editing reaction rule "Paytrail Payment
Service") Toimenpiteet (Actions) osio ja valitse Muokkaa (Edit)
3. Maksuasetusten määrittely –sivu avautuu jossa voit määritellä Paytrail moduulin asetukset
seuraavasti:
Moduulin toimintatila (Mode)
Tuotantoympäristö on käytössä kun moduulin toimintatilaksi valitaan Tuotanto (Production)
Testiympäristön saa käyttöön valitsemalla toimintatilaksi Testi (Testing).
Testiympäristössä maksurajapintaa on mahdollista testata testitunnuksilla käyttäen pankkien
testitunnuksia. Testitunnusten avulla on mahdollista testata Paytrailin koko maksuprosessi ilman, että
syntyy todellisia maksuja. Pankkien testitunnukset löytyvät esim. Paytrailin maksupalvelun sivuilta kun
Paytrail moduuli testaustilassa.
Tuotantoympäristön asetukset (Production mode settings)
Ko osiossa määritellään varsinaisessa tuotantokäytössä tarvittavat kauppiastunnus ja
kauppiastunnusta vastaava salainen avain (kauppiasvarmenne).
Jos et ole vielä tilannut Paytrail maksupalvelua käyttöösi niin voit tilata palvelun joko Luo uusi
kauppiastunnus linkistä käyttöliittymästä käsin tai selaimen kautta osoitteesta
https://ssl.paytrail.com/register//index/index/rid/238604
Palvelun tilauksen yhteydessä muista mainita/lisätä seuraava jälleenmyyjätunnus (238604 tai
Xocovis) ja lisätiedot kenttään maininta Drupal Commerce.
Page 4
Copyright © Xocovis
Page 5
Copyright © Xocovis
Maksutavan asetukset

Maksu- ja toimitustapojen asetukset
o Maksutavan otsikko (Payment method title)
 Otsikko / teksti joka näytetään maksutapaa valittaessa
o Näytä Paytrailin maksutapakuva otsikon yhteydessä (Show icon beside the
payment method title)
 Määrittelee näytetäänkö Paytrailin maksutapakuva vai ei
o Maksutapakuvassa käytettyjen sarakkaiden määrä
 Paytrail tarjoaa dynaamisen kuvan käytössä olevista maksutavoista
verkkokaupassa. Sarakkaiden määrä määrittää kuinka monta saraketta
per maksutaparivi on käytössä. Jokaisessa sarakkeessa näytetään yksi
Page 6
Copyright © Xocovis

maksutapa. Poikkeuksena tästä jotkin maksutavat vaativat tilaa kaksi
saraketta.
o Ohjaa sivut tilauksen lopussa automaatisesti Paytrail maksupalveluun (Redirect
automatically to Paytrail Payment Service site at checkout)
 Määrittelee ohjataako verkkokaupan sivut tilauksen lopussa
automaatisesti Paytrail maksupalvelun sivuille vai ei
o Maksutavan viesti (Payment details message)
 Maksutavan esittelyviesti joka näytetään kun asiakas on valinnut
maksutavaksi Paytrailin
o Tilauksen varmistussivun lähetysnapin teksti (Order review submit button text)
 Lähetysnapin teksti tilauksen varmistussivulla
o Maksun viitenumeron etuliite (Reference number prefix)
 Viitenumeron on yleisesti oltava vähintään neljä (4) numeroa pitkä ja
viitenumero ei voi alkaa nollalla (0). Viitenumeron etuliite liitetään
tilausnumeroon tilauksen viitenumeroa laskettaessa. Esim jos tilauksen
numero on 52 ja etuliite 1000 niin tällöin tilauksen viitenumeroksi tulee
1000520.
Lopuksi tallenna asetukset (Save)
Maksumoduulin käyttöönotto
Paytrail maksumoduuli on oletuksena poissa käytössä ja se tulee asetusten määrittelyn jälkeen ottaa
käyttöön ennenkuin Paytrail maksutapa on näkyvillä asiakkaille maksutapavalikossa.
Maksumoduulin käyttöönotto tapahtuu helpoiten klikkaamalla Active valintaruutua Asetukset (Settings) osiossa Muokkaa maksutavan sääntöjä –sivulla (Editing reaction rule " Paytrail Payment Service"), joka
avautuu uudestaan kun Paytrail maksumoduulin asetukset tallennetaan.
Page 7
Copyright © Xocovis
Lokalisointi
Paytrail maksumoduuli sisältää lokalisointituen suomeksi. Jos olet lisännyt Suomen Drupal asennukseesi,
suomen kieliset käännökset lisätään kieliasetusten mukaisesti Drupal asennukseesi Paytrail maksumoduulin
asennuksen yhteydessä.
Jos lisäät Suomen myöhemmin Drupal asennukseesi ja haluat lisätä suomen kielen käännökset Paytrail
maksumoduuliin niin lisäys onnistuu Käyttöliittymän kääntäminen – Tuo sivuilta (Translate Interface –
Import). Suomen kielen käännökset löytyvät tiedostosta: commerce_paytrail_fi/translations/fi.po
Huom! Jos et halua syystä tai toisesta lisätä suomenkielisiä käännöksiä automaattisesti Drupal asennukseesi
Paytrail moduulin asennuksen yhteydessä niin poista tai uudelleen nimeä
commerce_paytrail_fi/translations/fi.po tiedosto ennen Paytrail moduulin asennusta.
Page 8
Copyright © Xocovis
Paytrail maksumooduulin käyttö Drupal Commerce -verkkokaupassa
Kun Paytrail maksumoduuli on asennettu ja otettu käyttöön, näkyy Paytrail yhtenä maksutapana Tilauksen
tekeminen -sivuilla Maksutapa –osiossa
Jos ”Ohjaa sivut tilauksen lopussa automaatisesti Paytrail maksupalveluun” asetus on päällä, ohjautuvat
sivut automaattisesti Paytrail maksupalveluun, kun asiakas klikkaa ”Jatka seuraavaan vaiheeseen”
painiketta. Muussa tapauksessa Maksu-osio avautuu, josta asiakas voi Paytrail maksupalveluun klikkaamalla
”Siirry Paytrail maksupalveluun" painiketta.
Page 9
Copyright © Xocovis
Maksujen tilakyselyt
Kun tilaus maksetaan Paytrailin maksupalvelua käyttäen voit tilaushallinnassa tarkastella maksun tilaa
Paytrail palvelusta valitsemalla Paytrail –välilehden ja klikkaamalla Tarkista maksun tila -painiketta. Tällöin
kysytyn maksun tila esitetään Paytrailin palvelun sivulla.
Palvelun avulla voit varmistaa maksun todellisen tilan.
Page 10
Copyright © Xocovis
Lisätietoja Paytrail maksupalvelusta
http://paytrail.com/fi
Ongelmatilanteet
Ole yhteydessä Paytrail tekniseen tukeen: [email protected] (Paytrailia koskevat
kysymykset) tai maksumoduulin kehittäjään: [email protected]
Maksumoduulin kehittäjän kautta myös mahdollista saada asennustukea (sis. maksumoduulin asennus
palvelimelle, asetusten määrittely ja testaus).
That’s all!
Palaute ja kehitysehdotukset
Ole yhteydessä: [email protected]
Page 11
Copyright © Xocovis