Asennus, konfigurointi ja käyttö Asennus Ohjelmisto toimitetaan tilaussähköpostin vastausviestin liitetiedostoina kahdessa eri zip-paketissa. Ensimmäinen asennuspaketti, FipnPs-n.n.n.zip, sisältää kaikille Aivomatic Oy:n PrestaShopille kehittämille maksumoduleille yhteiset jaetut ohjelmistokomponentit. Asenna ne ensin erillisiä ohjeita seuraten. 1 of 6 Toinen asennuspaketti, FipnPsPt-n.n.n.zip, sisältää Paytrail Oyj:n verkkomaksupalvelulle spesifisten maksumodulien tiedostot. Asenna ne edellä mainitun FipnPs-komponentin asentamisen jälkeen.
Ensimmäinen asennuspaketti, FipnPs-n.n.n.zip, sisältää kaikille Aivomatic Oy:n PrestaShopille kehittämille maksumoduleille yhteiset jaetut ohjelmistokomponentit. Asenna ne ensin erillisiä ohjeita seuraten. Toinen asennuspaketti, FipnPsPt-n.n.n.zip, sisältää Paytrail Oyj:n verkkomaksupalvelulle spesifisten maksumodulien tiedostot. Asenna ne edellä mainitun FipnPs-komponentin asentamisen jälkeen. Asennuspaketin hakemistojen ja tiedoston siirto palvelimelle FipnPsPt-asennuspaketin sisältämät hakemistot ja tiedostot puretaan ja kopioidaan PrestaShopin modules-hakemiston alle. Osa FipnPsPt-paketin hakemistoista ja tiedostoista tulee jo aiemmin asennetun modules/fipnps-hakemiston alle asennuspaketin hakemistorakenteen mukaisesti. FipnPsPt-paketin paytrail-hakemisto kopioidaan modules hakemiston alle kaikissa asennuksissa. Maksusivun ohitukseen liittyvät maksutapakohtaiset hakemistot ptaktia-ptvisawc täytyy kopioda palvelimelle modules-hakemiston alle vain jos maksusivun ohitusta käytetään. Niiden maksutapojen, joita ei ole tilattu Paytrailin kautta, ja joita ei siis tulla siksi käyttämään maksusivun ohituksessakaan, ei tarvitse kopioita palvelimelle; tämä myös säästää hiukan vaivaa asennuksen myöhemmässä vaiheessa. Paketit voi esim. purkaa omalle tietokoneelle ja siirtää puretut tiedostot FTP:llä verkkokaupan palvelimelle, tai paketit voi purkaa suoraan palvelimella. Modulien asennus PrestaShopissa Avaa PrestaShopin hallinta-panelissa Modules/All-valikko Suodata modulilista tekijän aivomatic mukaan. Klikkaa täppä paytrail-modulin, ja jos käytät maksusivun ohitusta myös kunkin tilaamasi maksutavan erillisen modulin, valintaruutuun. Asenna kaikki valitut modulit kerralla valitsemalla bulk-toiminto Install the selection. Konfigurointi 2 of 6 Klikkaa paytrail-modulin Configure-painiketta.
Konfigurointi Klikkaa paytrail-modulin Configure-painiketta. Ao. kuvassa käytetään Paytrail Oy:n testitunnuksia. Ennen tuotantokäyttöön siirtymistä ne tulee korvata kauppiaan omilla tunnuksilla. Maksutapalogojen ruudukko on Paytrail Oyj:n kauppiaan itselleen tilaamien maksutapojen mukaan dynaamisesti muodostama kuvatiedosto, joka esitetään asiakkaalle maksutavan valinnassa, jos maksusivun ohitus ei ole käytössä. Paina lopuksi Update settings-nappia. Jos käytät maksusivun ohitusta, pitää halutut maksutavat aktivoida niiden konfiguraatiossa yksi kerrallaan. Kaikille verkkokauppiaille automaattisesti käyttöön tulevat verkkopankkimaksutavat on konfiguraatiossaan automaattisesti aktivoitu, mutta valinnaiset maksutavat pitää aktivoida manuaalisesti. Alla esimerkki Wirecardin prosessoiman Visa-maksutavan aktivointi. 3 of 6
Maksutapojen esitysjärjestys Järjestystä, jossa aktiiviset maksutavat esitetään asiakkaalle ostoskorissa, voi säätää. Avaa PrestaShopin hallinta-panelissa Modules/Positions-valikko ja etsi kohta displaypayment. Muuta modulien järjestystä modulien ylös/alas-nuolipainikkeita kliksuttelemalla. Käyttö Maksusivun ohitus Jos Paytrailin maksullinen maksusivun ohitus -lisäominaisuus on käytössä, asiakas voi valita haluamansa maksutavan heti PrestaShopin ostoskorissa ja siirtyä suoraan esim. valitsemaan verkkopankkiin. Maksutapojen esityksen ulkonäköä ostoskorissa voi säätää mm. sivupohjan tyylitiedostoilla ja maksumodulin template- ja kielitiedostoilla. 4 of 6
Maksusivu Jos maksusivun ohitus -lisäominaisuus ei ole on käytössä, asiakas valitsee PrestaShopin ostoskorissa maksutavan Paytrail. Seuraavaksi asiakas suorittaa varsinaisen maksutavan valinnan Paytrailin maksusivulla, josta hänet ohjataan eteenpäin esim. valitsemaansa verkkopankkiin. Paluu verkkomaksusta PrestaShopiin Verkkomaksun suoritettuaan asiakas palaa takaisin verkkokauppasivustolle. Maksutapahtuma tilaustiedoissa Maksumoduli tallettaa maksutapahtuman paluutiedot tilauksen tietoihin, josta ne voidaan esittää mm. hallinta-panelissa, tilausviesteissä jne. Tilauksen maksutiedot Tilauksen historiatiedot Rajapintaversiot 5 of 6 FipnPsPt tukee Paytrail Oyj:n rajapintaversioita S1 ja E1. Rajapintaversio S1 (simple)
Rajapintaversiot FipnPsPt tukee Paytrail Oyj:n rajapintaversioita S1 ja E1. Rajapintaversio S1 (simple) Rajapintaversiolla S1 voidaan käyttää verkkopankki-, luottokortti- ja PayPal-maksuja. S1 ei tue kaikkia kuten osamaksu- ja laskutusmaksutapoja, eikä mahdollista alv-erittelyä Paytrailin kirjanpitoraportissa. Rajapinnan S1 kautta välitetään verkkokaupasta Paytrail Oyj:n järjestelmään vain tilauksen perustiedot, kuten maksun loppusumma ja tilausnumero. Niinpä se on teknisesti yksinkertaisempi ja asettaa siksi väljemmät vaatimukset verkkokaupan konfiguraatiolle ja kustakin asiakkaasta talletetuille henkilötiedoille. Rajapintaversio E1 (extended) Rajapintaversiolla E1 voidaan käyttää kaikkia Paytrail Oyj:n tarjoamia maksutapoja, ja kirjanpitoraportti sisältää erittelyt alv-kannoittain. Rajapinnan E1 kautta välitetään verkkokaupasta Paytrail Oyj:n järjestelmään tilauksen perustietojen lisäksi tietoja asiakkaasta ja tilaukseen sisältyvistä tuotteista. Niinpä rajapintaversio E1 on teknisesti monimutkaisempi ja asettaa siksi tiukemmat vaatimukset verkkokaupan konfiguraatiolle ja kustakin asiakkaasta talletetuille henkilötiedoille. Jos PrestaShop-verkkokauppassa on käyttössä tavallisesta poikkeavia lisäosia, asetuksia tms., jotka estävät teknisesti monimutkaisemman ja vaativamman API E1:n käytön, voidaan käyttää API S1:ää, joka asettaa väljempiä teknisiä vaatimuksia. Asiakastiedot Kustakin asiakkaasta pitää olla talletettuna seuraavat Paytrail Oyj:lle välitettävät tiedot: Etu- ja sukunimi Lähiosoite Postinumero Postitoimipaikka Kotimaa Puhelinnumero (lanka- ja/tai matkapuhelin) sähköpostiosoite Jos asiakkaalta puuttuu joku em. tiedoista, ja jos käytetään rajapintaversiota E1, maksutapa ei ole valittavissa ostoskoriin siirtymisen yhteydessä. Lisäksi asiakkaalle voi olla määritelty tämän edustaman yrityksen nimi. 6 of 6