Asennus ja konfigurointi

Maksutapalomake / Asetukset

Avaa maksutapalomakkeen Asetukset-välilehti. Tämän ohjeen kuvissa kentät on täytetty Suomen Verkkomaksut Oy:n testitunnuksilla. Tuotantokäytössä ne tulee täyttää kauppiaan omilla varsinaisilla tunnuksilla.

• MERCHANT_ID
  • Myyjän tunnus
• AUTH_CODE
  • Salainen kauppiastunnus
• DESC_ROW1 ja 2
  • Suomen Verkkomaksut Oy:n hallintapaneliin välittyvän viestin kaksi vapaamuotoista tekstiriviä. Viesti ei näy asiakkalle.
• DESC_USER
  • Suomen Verkkomaksut Oy:n hallintapaneliin välittyvän viestin kolmas riviä. Jos valinta on Kyllä, viestiin lisätään asiakkaan Id- eli asiakasnumero, käyttäjätunnus ja nimi.
• Status-valikot
  • Tilaus merkitään erilaisten tapahtumien perusteella näihin tiloihin (kts. tilauksen tilatyypit aiemmin tässä ohjeessa). On suositeltavaa käyttää kuvassa näkyviä tilatyyppejä tai niiden käännöksiä.
• Sähköposti-ilmoitus asiakkaalle ja Lisätietoja asiakassähköpostiin?
  • Lähetetäänkö asiakkaalle sähköposti, kun tilauksen tila muuttuu (esim. kun asiakkaan maksu on otettu vastaan tai jos maksussa on tapahtunut peruutus tai virhe) ja sisällytetäänkö sähköpostiin tarkempia tietoja tilauksen tilan vaihtumisen syystä.
• Kulttuuri
  • Kieli jolla FipnVmSvm:n käyttöliittymä ja Suomen Verkkomaksut Oy:n sivusto esitetään asiakkaalle. Jos valinta on auto, kieli valitaan automaattisesti: Joomla 1.0:ssa sivuston kieliasetuksen perusteella. Joomla 1.5:ssä ensisijaisesti käyttäjän kieliasetuksen perusteella, tai jos sitä ei ole asetettu, sivuston oletuskielen perusteella. Jos valinta on suomi/Suomi, kieli on aina suomi. Jos valinta on englanti/USA, kieli on aina englanti.
• Rajapintaversio
  • Suomen Verkkomaksut Oy:n maksupalvelun verkkorajapinnan versio. Versio on joko S1 (suppea) tai E1 (laaja). Suppeampi rajapinta S1 ei tue lasku-, osamaksu- ja Netposti-maksutapoja, mutta toisaalta se asettaa vähemmä vaatimuksia esim. asiakkaalta rekisteröitymisen aikana kerättyjen asiakastietojen suhteen.
• Maksutapakuvan tyyppi
  • Suomen Verkkomaksut Oy:n verkkomaksupalvelu tarjoaa mahdollisuuden käyttää kauppiaskohtaista dynaamista maksutapanappien kuvaa. Tyyppi-asetuksella valitaan pysty- tai vaakasuuntainen kuva.
• Maksutapakuvan sarakkeet
  • Maksutapakuvan rinnakkaisten sarakkeiden lukumäärä. Sarakkeiden määrällä voidaan kontrolloida maksutapanappien asettumista kuvaan rinnakkain ja allekkain.
• Maksutapakuvan URL
  • Maksutapakuvan URL:n voi kopioida esim. sivuston templatessa käytettäväksi. URL:n alla esitettävä kuva näkyy asiakkaalle tilausprosessin viimeisessä vaiheessa ennen verkkomaksuun siirtymistä.
• Maksutavan lisäinfo
  • Kopioi lomakkeella mainittu ohjelmakoodi <?php require_once CLASSPATH.'payment/aivomatic/fipnvm/suomenverkkomaksut/formExtraInfo.suomenverkkomaksut.php'; ?> Maksutavan lisäinfo -kenttään.

Klikkaa lopuksi Tallenna

Rajapintaversiot

FipnVmSvm tukee Suomen Verkkomaksut Oy:n uusimpia rajapintaversioita S1 ja E1.

Rajapintaversio S1

Rajapintaversiolla S1 (simple) voidaan käyttää verkkopankki-, luottokortti- ja PayPal-maksuja. S1 ei tue Klarnan tai Collectorin osamaksu- ja laskutus-maksutapoja, eikä Itellan Netpostia.

Rajapinnan S1 kautta välitetään verkkokaupasta Suomen Verkkomaksut Oy: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

Rajapintaversiolla E1 (extended) voidaan käyttää kaikkia Suomen Verkkomaksut Oy:n tarjoamia maksutapoja mukaan lukien Klarna, Collector ja Netposti.

Rajapinnan E1 kautta välitetään verkkokaupasta Suomen Verkkomaksut Oy:n järjestelmään tilauksen perustietojen lisäksi tietoja asiakkaasta ja tilaukseen sisältyvistä tuotteista. Niinpä rajapintaversio viisi on teknisesti monimutkaisempi ja asettaa siksi tiukemmat vaatimukset verkkokaupan konfiguraatiolle ja kustakin asiakkaasta talletetuille henkilötiedoille.

Asiakastiedot

Kustakin asiakkaasta pitää olla talletettuna seuraavat Suomen Verkkomaksut Oy:lle välitettävät tiedot:

• Etu- ja sukunimi
• Lähiosoite
• Postinumero
• Postitoimipaikka
• Kotimaa
• Puhelinnumero
• sähköpostiosoite

Lisäksi asiakkaalle voi olla määritelty tämän edustaman yrityksen nimi.

Kaupan konfigurointi

VirtueMart-ohjelmiston ao. asetukset pitää konfiguroida seuraavasti:

• Veron peruste: Euroopan unionin veromuoto (engl. European Union mode) euro-alueen kaupassa tai Saapumisosoite (engl. Based on vendor address) eli kauppiaan osoitteeseen perustuva veromuoto
• Vähennä maksualennus ennen veroa/huolintaa: Ei valittu (eli kuponki- ja maksutapa-alennukset/-lisät lasketaan arvonlisäverollisille hinnoille)

Kuponki- ja maksutapa-alennukset

Rajapintaversiossa viisi maksun loppusummaa ei välitetä Suomen Verkkomaksut Oy:n palveluun sellaisenaan, vaan loppusumma muodostuu maksupalveluun välitettävien tuoterivien yhteenlasketuista summista. Kullakin rivillä välitetään mm. seuraavat tiedot: hinta (ALV 0%), ALV-prosentti ja tuotteiden määrä. Kuponkialennukset ja maksutapa-alennukset ja -lisät välitetään erillisinä riveinä. Jos toimitus sisältää eri ALV-luokkiin kuuluvia tuotteita, alennukset ja lisät jyvitetään niiden suhteessa erillisiksi ALV-luokkakohtaisiksi riveiksi.