OsCommerce maksumoduulien asennus Tässä ohjeessa oletetaan, että OsCommerce verkkokauppa on asennettu ja toimii. Testikaupan osoite on http://www.rontti.org/oscommerce-2.2ms2-051113/catalog/ jota voit käyttää itsekin maksujen testaamiseen. Verkkomaksumoduulit toimitetaan ZIP tiedostossa, jonka voit purkaa esim. C kansion Temp hakemistoon jolloin syntyy kaksi hakemistoa, catalog_includes_languages_kieli_modules_payment ja catalog_includes_modules_paymenti joissa kussakin on yksi tiedosto per maksumoduuli. Jos olet hankkinut esim. Luottokunnan maksumoduulin, on em. hakemistoissa luottokunta_hdsoft.php tiedostot. Kuva 1. ZIP tiedoston sisältö. Em. hakemistot kuvaavat OsCommerce verkkokaupan hakemistorakennetta eli paikkaa johon sinun tulee em. tiedostot siirtää (huomaa, että hakemistoja ei tule siirtää). Sanan kieli kohdalla on tietysti käyttämäsi kieli, yleensä finnish. Siirrä tiedostot esim. FTP ohjelmalla, esim. WS_FTP ohjelmalla.
Kuva 2. Tiedostojen siirto FTP ohjelmalla. Avaa sitten selain ja siirry pääkäyttäjän näkymään (kuva 3). Napsauta Payment linkkiä jolloin tulisi avautua kuvan 4 kaltainen näkymä. Tätä ennen sinun tulee siirtää maksumoduulitiedostot edellä kuvatun ohjeen mukaisesti oikeisiin hakemistoihinsa. Jos tiedostot on siirretty oikein, näet kuvan 4 listassa kunkin maksumoduulin nimen, esim. Luottokunnan Digitaalinen Maksupäätepalvelu tms. Maksumoduuli asennetaan napsauttamalla maksun nimeä jolloin ikkunan oikeaan reunaan avautuu kuvan 5 mukainen lomake. Napsauta Install painiketta jolloin lomake muuttuu kuvan 6 mukaiseksi. Voit nyt testata maksua vapaasti nähdäksesi, että se toimii. Kun olet varmistanut maksun toimivuuden, on aika syöttää maksuun oikeat tunnukset jotka olet saanut pankista ja/tai Luottokunnalta. Tämän dokumentin liitteenä on ohjeita kunkin maksun tiedoista asennukseen liittyen, tarkista maksuusi liittyvät asetukset sieltä. Maksun asetukset asetetaan napsauttamalla edit painiketta jolloin avautuu kuvan 7 kaltainen lomake. - Lajittelujärjestys on numero, joka kertoo missä järjestyksessä maksumoduulit esitetään (ei tarvitse muuttaa) - Ota käyttöön Luottokunnan Digitaalinen Maksupäätepalvelu määrittää onko maksumoduuli käytössä vai ei (ei tarvitse muuttaa) - Kauppiastunnus on myyjän tunniste joka saadaan pankista ja/tai Luottokunnasta, syötä saamasi tunnus ja varmista, että se on oikein (muutettava) - Salainen avain on vain sinun ja pankin ja/tai Luottokunnan tiedossa oleva salainen tunnus, syötä se ja varmista, että se on oikein (muutettava) - Maksumoduulin voimassaoloalue määrittää missä eri alueilla maksumoduuli toimii (ei tarvitse muuttaa)
- Tilauksen tila kertoo mihin tilaan tilaus menee maksun suorituksen jälkeen, kannattaa laittaa esim. Pending tai Processing tilaan (ei tarvitse muuttaa) Napsauta lopuksi update painiketta jolloin tiedot tallentuvat. Nyt on hyvä käydä testaamassa maksu jolla varmistetaan se, että syötit oikeat tunnukset. Kuvissa 7-19 on esitetty yksi testimaksu. Kuva 3. Pääkäyttäjän näkymä.
Kuva 4. Maksumoduulit Payment sivulla. Kuva 5. Maksumoduulin asennus. Kuva 6. Maksumoduuli oletusasetuksin asennettuna.
Kuva 7. Maksumoduulin asetuksien muuttaminen.
Kuva 7. Lisätään tuote ostoskoriin. Kuva 8. Napsauta Checkout painiketta siirtyäksesi tilaamaan tuotteen/tuotteita. Kuva 9. Mahdollisten kommenttien lisäys, Continue painike jatkaa.
Kuva 10. Valitaan maksutapa, tässä tapauksessa Luottokunnan Digitaalinen Maksupäätepalvelu, Continue jatkaa Kuva 11. Tarkistetaan tilauksen tietojen oikeellisuus, Confirm Order jatkaa.
Kuva 12. Luottokunnan sivu, alla olevissa kuvissa myös muiden maksumuotojen etusivut. Kuva 13. Ålandsbankenin elektroninen maksu.
Kuva 14. Handelsbankenin verkkomaksu. Kuva 15. Nordea e-maksu.
Kuva 16. Osuuspankin verkkomaksu.
Kuva 17. Sampo pankin verkkomaksu.
Kuva 18. Sp/Pop-maksu Kuva 19. Tapiola verkkomaksu.
Liite 1. Maksumoduulien asetukset Liitteen maksumoduuleihin liittyvät tiedot on koottu pankkien ja/tai Luottokunnan dokumenteista, lisätietoa saat siis omasta pankistasi ja/tai Luottokunnalta. Yleissääntö on kuitenkin se, että sinun tulee tehdä sopimus jokaisen pankin ja/tai Luottokunnan kanssa voidaksesi vastaanottaa maksuja heidän maksumoduuliaan käyttäen. Ålandsbanken verkkomaksu Myyjä (asiakastunnus) Laskuttajan tunnus on Ålandsbankenin myyjälle antama asiakastunnus. Pankki tunnistaa myyjäyrityksen tunnuksen perusteella. Laskuttajan tunnus löytyy sopimuslomakkeesta. Tarkisteavain Myyjän tarkisteavain lähetetään postitse sopimuksessa mainitulle yhteyshenkilölle. Myyjän tilinumero Myyjän tili Ålandsbankenissa. Myyjän nimi Myyjän nimi Handelsbanken verkkomaksu Myyjätunnus Verkkomaksusopimus yksilöidään myyjäntunnuksella ja sopimustunnuksella. Niiden perusteella haetaan maksulomakkeelle saajan tilinumero ja saajan nimi. Myyjän tunnus ja sopimustunnus ilmoitetaan myyjälle tarkisteavaimen kuittauslomakkeella. Tarkisteavain Pankki antaa myyjälle tämän verkkopalvelun yksilöivät tunnukset. Tarkisteavaimen avulla myyjä ja pankki laskevat keskinäisessä tiedonsiirrossa käytettävät tarkisteet. Luottokunnan Digitaalinen Maksupäätepalvelu Kauppiastunnus Jäsenliikenumero Salainen avain Luottokunnan kauppiaalle toimittama salainen avain.
Nordea e-maksu Myyjä Myyjäyritys tekee kirjallisen palvelusopimuksen Nordea Pankin kanssa. Myyjän tiedot rekisteröidään pankissa, josta hän saa käyttöönsä myyjän tunnuksen. Tarkisteavain Pankki edellyttää turvatarkisteen käyttöä ja antaa tarkisteavaimen myyjäyritykselle. Osuuspankki verkkomaksu Myyjän tunnus Pankin laskuttajalle antama tunnus. Tuotantotunnukset kirjoitetaan aina ISOLLA (samalla tavalla kuin pankin toimittamassa tunnuskuoressa). Tarkistetieto Tarkistetietoa käytetään tarkisteen laskentaan. Tarkistetieto on 8-512 merkin jono, joka ei sisällä erikoismerkkejä tai välilyöntejä. Sampo verkkomaksu Kauppiasnumero / Salainen avain Sampo toimittaa palveluntarjoajalle palvelussa käytettävät kauppiasnumeron ja salaisen avaimen. Sp/Pop maksu Myyjän tunnus Tunnuksen perusteella määräytyvät maksulomakkeelle tulevat saajan tilinumero ja saajannimi. Tunnus on merkitty pankin kanssa tehtyyn sopimuslomakkeeseen kohtaan Palvelutunnus ja Tarkenne. Tunnus muodostetaan yhtenä merkkijonona ilman välimerkkejä. Esim. palvelutunnus on 1234567890 ja tarkenne on 123, jolloin myyjän tunnus on 1234567890123. Turvatarkiste Turvatarkiste saadaan sopimuslomakkeen kohdasta Turvatarkiste. Turvatarkiste on 16-20 merkkiä pitkä ja sitä käytetään vain maksun tarkisteen laskennassa. Tapiola verkkomaksu Myyjä (asiakastunnus) Laskuttajan tunnus on Tapiola Pankin myyjälle antama asiakastunnus. Pankki tunnistaa myyjäyrityksen tunnuksen perusteella. Laskuttajan tunnus löytyy sopimuslomakkeesta.
Tarkisteavain Myyjäyrityksen tekemässä sopimuksessa verkkomaksusta mainittu yhteyshenkilö saa tarkisteavaimen pankista suljetussa kuoressa. Myyjän tilinumero Tapiola Pankissa tai toisessa pankkiryhmässä esim.363630-00123456. Myyjän nimi Myyjän nimi