commerce_paytrail_fi Paytrail maksumoduuli Drupal Commerce - verkkokauppaan Drupal 7.x / Drupal Commerce 1.x Page 1
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
Paytrail maksumoduulin käyttöönotto Drupal Commerce verkkokaupassa Järjestelmävaatimukset Paytrail maksumoduulilla on seuraavat järjestelmävaatimukset: Asennus Järjestelmävaatimus Tuetut versiot Drupal Commerce 1.3 1.x Drupal 7.x PHP 5.2.x+ 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
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
Page 5
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
o o o o maksutapa. Poikkeuksena tästä jotkin maksutavat vaativat tilaa kaksi saraketta. 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 Maksutavan viesti (Payment details message) Maksutavan esittelyviesti joka näytetään kun asiakas on valinnut maksutavaksi Paytrailin Tilauksen varmistussivun lähetysnapin teksti (Order review submit button text) Lähetysnapin teksti tilauksen varmistussivulla 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
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
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
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
Lisätietoja Paytrail maksupalvelusta http://paytrail.com/fi Ongelmatilanteet Ole yhteydessä Paytrail tekniseen tukeen: support@verkkomaksut.zendesk.com (Paytrailia koskevat kysymykset) tai maksumoduulin kehittäjään: yhteydenotto@xocovis.com 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ä: yhteydenotto@xocovis.com Page 11