Ohjeistus integraatiota ja käyttöönottoa varten Integroitavat -maksupäätteet Ingenico ML30 Ingenico ipp350 Ingenico iwl250b
DOKUMENTIN TIEDOT Tekijä: Arto Kangas Päiväys: Versionumero: 1.3 Hyväksyjä: Jukka Sippola Hyväksymispäivä: 13.2.2013 VERSIOTIEDOT Päiväys Kuvaus tehdyistä muutoksista Versio Tekijä 10.6.2012 Ensimmäinen julkaisu 1.0 AKa 17.8.2012 Lisätty tietoa EFT930 integroinnista 1.1 AKa 21.1.2013 Korjattu muotovirheitä ja lisätty selventäviä 1.2 AKa kuvia. Laajennettu sanastoa. Vaihdettu EFT930 >> iwl250 1.3 AKa 7.10.2013 Korjattu viitteen rakennekaavio, päivitetty tuen yhteystiedot ja extranetin osoite ST 2/32
Sisällysluettelo: 1. Esittely... 6 1.1. Kenelle tämä dokumentti on tarkoitettu... 6 1.2. PCI-DSS tämä dokumentti on tarkoitettu... 6 1.3. Terminologia ja sanasto... 6 2. Järjestelmään kuuluvat komponentit... 7 3. Käytettävät päätemallit sekä niiden liitännät ja kaapelointi... 9 3.1. Ingenico ipp350... 9 3.1.1. USB -liitäntä... 9 3.1.2. RS232 -liitäntä... 9 3.1.3. Ethernet -liitäntä... 9 3.2. Ingenico ML30... 10 3.2.1. ML30 ja USB -liitäntä... 10 3.2.2. ML30 ja RS232 -liitäntä... 10 3.2.3. ML30 ja ethernet -liitäntä... 10 3.3. Ingenico iwl250 Bluetooth / GPRS... 10 3.3.1. Ingenico iwl250 päätteiden asetukset... 11 3.3.2. Lataus- ja kommunikaatioteline... 11 3.3.2.1. iwl250 ja RS232-liitäntä... 11 3.3.2.2. iwl250 ja ethernet -liitäntä... 11 3.3.2.3. USB-liitäntä... 12 3.3.3. USB-kaapelin pituus... 12 3.3.4. Akun käyttöiän pidentäminen... 12 3.4. Kortinlukijan puhdistus... 12 3.5. Päätteiden MENU-valikko... 12 4. SOVELLUSKOMPONENTIT... 14 4.1. Käyttöoikeudet... 14 4.2. USB-ohjaimen asennus... 14 4.3. Sovellusten asennus... 15 4.3.1. komponenttien asennus asennuspaketin avulla... 15 4.3.1.1. asennuksen komentoriviparametrit... 15 4.3.1.1. Asennusvaiheet... 15 4.3.1.2. Asennuksen toimivuuden tarkistus ja testaus... 16 3/32
4.4. Käyttöjärjestelmän asetukset... 16 4.4.1. Käyttöoikeudet... 16 4.4.2. n dialogin jäädessä muiden avointen ikkunoiden taakse... 17 4.5. Eri rajapintavaihdot... 17 4.1. XML-API... 18 4.2. Dopay -rajapinta... 18 4.3. EMVAgent -sovelluksen asetukset (XML-API ja Dopay)... 18 4.3.1. EMVAgent -välilehdet... 19 4.3.1. EMVAgent sovelluksen komentoriviparametrit... 20 4.4. Komponenttilistaus... 21 4.5. Rajapinnan palauttamat yleisimmät palautekoodit... 21 4.6. Yhteysosoitteet... 22 5. KÄYTTÖÖNOTTO JA ASETUSTEN MUUTTAMINEN... 24 5.1. Päätteestä ja rajapinnan kautta muutettavat asetukset... 24 5.2. Nets Oy:n palvelukeskuksesta muutettavat asetukset... 24 5.3. Laitteen käynnistäminen ensimmäistä kertaa... 24 5.4. Versiopäivitykset laitteelle... 24 6. TAPAHTUMIEN LÄHETYS JA TILITYSERÄT... 25 6.1. Tapahtumien lähetys... 25 6.2. Tilityserien muodostus... 25 7. RAPORTOINTI... 26 7.1. EMVHost Online -raportointi... 26 7.2. EMVHost Online tapahtumien palaute ja tapahtumien täsmäytys... 26 7.3. Raportti erälähetyksestä... 26 7.4. Tapahtumien yksilöinti... 26 7.5. Tilityserien viitteet... 26 8. TESTAUS JA TOIMIVUUDEN VALIDOINTI... 28 8.1. Testiympäristö... 28 8.2. Testaus yleisellä testitunnuksella... 28 8.3. Testaus omalla testitunnuksella... 28 8.4. Testaus tuotantotunnuksilla... 28 9. YHTEYSTIETOJA JA HYÖDYLLISIÄ LINKKEJÄ... 29 10. PIKAOHJE ML30 TAI IPP350 -PÄÄTTEEN KÄYTTÖÖNOTTOON... 30 10.1. Ohjelmistojen asennus... 30 4/32
10.2. Kytkennät... 30 10.3. Ensimmäinen käynnistys... 30 10.4. Testaus... 30 11. PIKAOHJE iwl250 BLUETOOTH -PÄÄTTEEN KÄYTTÖÖNOTTOON... 31 11.1. Ohjelmistojen asennus... 31 11.2. Kytkennät... 31 11.3. Asetukset... 31 11.4. Ensimmäinen käynnistys... 31 11.5. Testaus... 31 5/32
1. Esittely Nets Oy:n maksupääteratkaisu tarjoaa rajapinnan ja komponentit, joiden avulla myyntijärjestelmän osaksi voidaan liittää maksupääte ja tarjota tämän avulla nykyaikaista ja turvallista korttimaksamista osana myyntijärjestelmää. Integroitaessa maksupääte osaksi kassajärjestelmää nopeutetaan kassan toimintaa ja vähennetään virheitä. Integroidulla järjestelmällä tarkoitetaan sitä, että tapahtuman tyyppi, summa ja muut tarvittavat tiedot tulevat myyntijärjestelmästä eikä niitä syötetä erikseen maksupäätteeseen (vrt. erillispääte). 1.1. Kenelle tämä dokumentti on tarkoitettu Tämä ohjeistus on tarkoitettu luettavaksi kaikille, jotka suorittavat - maksupäätejärjestelmän asennuksia tai haluavat tietää miten asennus suoritetaan. Dokumentissa kerrotaan myös mitä asioita tulee ottaa huomioon asennuksia suoritettaessa ja mitä eri tapoja on kytkeä fyysinen maksupääte tietokoneeseen integroitavaksi. Tämän ohjeistuksen lukijalla oletetaan olevan perustiedot maksupäätteiden toiminnasta, verkkoyhteyksistä sekä ainakin perustuntemus Windows-käyttöjärjestelmästä ja ohjelmistojen asennuksesta ko. käyttöjärjestelmään. 1.2. PCI-DSS tämä dokumentti on tarkoitettu Tämä ohjeistus on tarkoitettu luettavaksi kaikille, jotka suorittavat maksupäätejärjestelmän asennuksia tai haluavat tietää miten asennus suoritetaan. Dokumentissa kerrotaan myös mitä asioita tulee ottaa huomioon asennuksia suoritettaessa ja mitä eri tapoja on kytkeä fyysinen maksupääte tietokoneeseen integroitavaksi. 1.3. Terminologia ja sanasto ECR Dopay Dopay RFP Electronic Cash Register API protokolla Nets Oy:n EmvCard maksupäätteille Dopay - Request For Payment: API protokolla pöytärahastukseen 6/32
2. Järjestelmään kuuluvat komponentit Järjestelmä koostuu useista eri komponenteista ja niiden tulee toimia saumattomasti yhteen, jotta vältytään ongelmilta maksamisen yhteydessä. Käytettävät sovelluskomponentit riippuvat siitä mitä rajapintaa myyntijärjestelmän ja maksupäätteen välillä käytetään. Asentajalla edellytetään olevan tieto siitä, mikä rajapinta on käytössä siinä ympäristössä, jossa asennusta suoritetaan. Järjestelmän käyttövaatimukset ja -suositukset sekä käyttämiseen tarvittavat yhteydet on kerrottu dokumentissa System Requirements, jonka on saatavilla osoitteesta http://www.luottokunta.fi/fi/vastaanottopalvelut/maksupaatteet/jarjestelmatoimittajille/ladattavat_ti edostot. Kyseinen dokumentti on myös tämän ohjeen liitteenä. ei tallenna maksutapahtuma-aineistoja tietokoneen levylle vaan kaikki aineistot säilytetään maksupäätteessä ja siirretään salattuina Nets Oy:n maksupäätepalveluiden palvelukeskukseen prosessoitavaksi. Maksupääte voidaan yhdistää tietokoneeseen USB- tai RS232-kaapelin avulla. Tietyissä malleissa virransyöttö on toteutettavissa erillisellä virtalähteellä, mutta pääsääntöisesti virta otetaan USB -kaapelin kautta jos tietokoneen virransyöttö on riittävä ja tarpeeksi vakaa. Riittämätön tai epävakaa virransaanti saattaa aiheuttaa odottamattomia virheitä tai päätteen kaatumista! Järjestelmän komponenttien ja yhteyksien yleiskuva 7/32
Periaatekuva erilaisista asennustavoista riippuen integraatiosta ja tietoliikenteestä. Periaatekuva integraation sovelluskerroksista. 8/32
3. Käytettävät päätemallit sekä niiden liitännät ja kaapelointi Nets Oy:n valikoimissa on päätteitä useisiin eri tarpeisiin. Tässä dokumentissa ei käsitellä erillismaksupäätteitä, vaan ainoastaan mallit jotka ovat integroitavissa myyntijärjestelmiin. Osa erillispäätteinä toimivista malleista on myös integroitavissa, joten rajanveto eri päätetyyppien välillä ei ole tarkka. Integroitavissa olevat mallit voidaan jakaa kahteen pääluokkaan: niihin, joissa on tulostin sisäänrakennettuna ja niihin, joissa ei ole omaa tulostinta. Päätteissä, joissa omaa tulostinta ei ole, kaikki tulostukset ohjataan rajapinnan kautta kutsuvan sovelluksen käsiteltäviksi. Nets Oy:n päätteissä itsessään ei ole verkkopalvelinta jonka kautta integraation voisi suorittaa. Verkon kautta voi päätteitä kuitenkin ohjata tätä varten tehdyn sovelluksen avulla (EMVAgent) TCP Socket -yhteyttä käyttäen (ks. XML API). 3.1. Ingenico ipp350 IPP350 on tarkoitettu vain integroitavaan käyttöön, eikä siinä ole tulostusominaisuuksia. Verkkoyhteys muodostetaan PC:n kautta, johon on asennettu -rajapintakomponentti tai vaihtoehtoisesti pääte voi muodostaa yhteyden oman Ethernet -verkkoyhteyden kautta. Pääte liitetään tietokoneeseen joko USB- tai RS232-kaapelilla. Laitteen mukana toimitetaan USB - kaapeli. Sarjaliikennettä varten on mahdollista tilata RS232-kaapeli virtalähteineen. Ethernet - liitäntää käytettäessä tarvittava kaapeli tilataan erikseen. Esimerkkikuva ipp350 integraation komponenteista 3.1.1. USB -liitäntä USB -liitäntä vaatii 5V jännitteen ja vähintään 500 ma jatkuvaa virtaa. Päätteen on saatava tarpeeksi virtaa toimiakseen, eikä samassa USB -väylässä saa olla muita paljon virtaa käyttäviä laitteita (kuten asiakasnäyttö) jotta 500 ma:n vaatimus täyttyy. USB -kaapeliin on saatavilla myös erillinen virtalähde, joka antaa tarvittavan sähkön riippumatta tietokoneen virtalähteen tehosta. 3.1.2. RS232 -liitäntä USB liitännän tilalla voidaan käyttää myös sarjaporttia. Portti on standardi RS232 ja kaapelin saa tilattua erikseen Nets Oy:ltä. Tietokoneen RS232 portin kautta ei ole mahdollista syöttää virtaa laitteelle vaan se vaatii erillisen virtalähteen, joka toimitetaan kaapelin mukana. 3.1.3. Ethernet -liitäntä IPP350 pääte voidaan myös varustaa ethernet -liitännällä, jolloin kaikki ulkopuolinen verkkoliikenne voidaan ohjata kyseisen liitännän kautta. Integraatiota ei kuitenkaan voi tehdä käyttämällä ethernet porttia vaan rajapinta toimii USB- tai RS232-liitännän kautta. Nämä 9/32
ohjaukset on myös mahdollista asettaa tapauskohtaisesti, eikä ethernet liittimen olemassaolo pakota käyttämään kyseistä liittymää, vaan kaikki verkkoliikenne voidaan reitittää PC:n kautta API komponentin avulla. Kyseiset asetukset on muutettavissa menu valikon kautta. 3.2. Ingenico ML30 ML30 on tarkoitettu vain integroitavaan käyttöön, eikä siinä ole tulostusominaisuuksia tai suoraa verkkoyhteyttä. Verkkoyhteys muodostetaan aina PC:n kautta, johon on asennettu - rajapintakomponentti. Pääte liitetään tietokoneeseen joko USB- tai RS232-kaapelilla. Laitteen mukana toimitetaan vakiona USB -kaapeli. Sarjaliikennettä varten on mahdollista tilata RS232 kaapeli virtalähteineen. ML30 integraatio vastaa ipp350 integraatiota. 3.2.1. ML30 ja USB -liitäntä USB -liitäntä vaatii 5V jännitteen ja vähintään 500 ma jatkuvaa virtaa. Päätteen on saatava tarpeeksi virtaa toimiakseen, eikä samassa USB -väylässä saa olla muita paljon virtaa käyttäviä laitteita (kuten asiakasnäyttö) jotta 500 ma:n vaatimus täyttyy. Laitteen mukana tulevan USB - kaapelin liitin on viisto, eikä siihen ole saatavilla toisenlaista USB -liitintä. Erillisestä tilauksesta on saatavissa USB -haaroitin/jatkojohto, jossa on liitäntä erilliselle virtalähteelle ja tämän avulla virransyöttö voidaan tehdä omalla virtalähteellä jolloin ei olla riippuvaisia PC:n virtalähteestä. 3.2.2. ML30 ja RS232 -liitäntä USB liitännän tilalla voidaan käyttää myös RS232-standardin mukaista sarjaporttia johon sopivan kaapelin voi tilata erikseen Nets Oy:ltä. RS232-portin kautta ei ole mahdollista syöttää virtaa laitteelle, vaan se vaatii erillisen virtalähteen joka toimitetaan kaapelin mukana. 3.2.3. ML30 ja ethernet -liitäntä ML30-päätteessä ei ole mahdollista käyttää Ethernet -liitäntää. Nets Oy:n tarjoamissa ML30- päätteissä ei ole kyseistä liitäntää vaan kaikki verkkoliikenne reititetään PC:n kautta API - komponentin avulla. Tätä varten täytyy PC:ssä olla tietoliikenneyhteydet avattuna ja saatavilla. 3.3. Ingenico iwl250 Bluetooth / GPRS iwl250-sarjan päätteet sisältävät aina tulostimen ja tämän sarjan malleja on mahdollista käyttää monin eri tavoin. Päätettä voidaan käyttää erillispäätteenä tai integroituna päätteenä. Erllispäätteenä käytettäessä esim. summa syötetään päätteen näppäimistöltä ja integroituna summa sekä tapahtumatyyppi tulevat aina rajapinnan kautta eikä summaa voi syöttää maksupäätteen näppäimistöltä. Integroituna päätteen tietoliikenne voidaan ohjata joko PC:n kautta tai oman ethernet -liitännän kautta, josta lisää myöhemmin. Käytettäessä päätettä integroituna voidaan tulostukset ohjata joko laitteen omalle tulostimelle tai vaihtoehtoisesti sarjaliikenteen kautta rajapintaan tulostettavaksi. 10/32
Periaatekuvat EFT930B/iWL250B laitteiden integraatiovaihtoehdoista 3.3.1. Ingenico iwl250 päätteiden asetukset Laitteet sisältävät valikon, johon pääsee Menu (tai F) näppäimen kautta riippuen päätemallista. Valikon rakenne on selitetty tarkemmin toisaalla tässä dokumentissa. Alla olevilla installer valikon vaihtoehdoilla saadaan pääte toimimaan käyttötarkoituksen mukaisesti. INSTALLER Print device info - tulostaa ohjelmistoversion ja laitteen sarjanumeron Primary comm Verkkoyhteyksien kanava, esim. GPRS tai COM Listen comm Integraatiossa käytettävä portti Esimerkkiasetukset integrointia varten: Kaikki liikenne sarjaportin kautta: INSTALLER/Primary comm/com - INSTALLER/Listen comm/com. Verkkoliikenne ethernet portin kautta: INSTALLER/Primary comm/ethernet - INSTALLER/Listen comm/com. 3.3.2. Lataus- ja kommunikaatioteline Laite latautuu kun se on telineessä ja telineeseen on kytketty virta. Akun käyttöikä paranee kun se tyhjennetään ajoittain kokonaan. 3.3.2.1. iwl250 ja RS232-liitäntä Kaapeli kytketään kommunikaatiotelakan porttiin COM0 (nolla) RJ -liittimellä ja vastaavasti RS232 sarjaporttiliitin kytketään tietokoneen vapaaseen sarjaporttiin. RJ -liitin sijaitsee telakan pohjassa suojakannen alla. 3.3.2.2. iwl250 ja ethernet -liitäntä Bluetooth ominaisuuksilla varustetun laitteen lataus-/kommunikaatioteline sisältää ethernet liitännän ja sitä on mahdollista käyttää verkkoyhteyksiin. Oletuksena kaikki tietoliikenne ohjataan 11/32
tätä kautta, mutta sitä ei ole pakko käyttää. Laite voidaan konfiguroida käyttämään DHCP palvelinta tai kiinteää IP-osoitetta. Proxy tukea laitteessa ei ole saatavilla, joten verkkoyhteys täytyy voida muodostaa ilman proxyn vaatimia autentikointeja. 3.3.2.3. USB-liitäntä USB-liitäntä ei ole käytettävissä iwl250-sarjan päätteiden kanssa. Erillisten USB/RS232 - adaptereiden käyttöä ei suositella eikä Nets Oy vastaa toimivuudesta näitä käytettäessä. Päätteen kyljessä oleva Micro USB liitäntä on tarkoitettu vain päätteen lataamiseen esim. tupakansytytinadapterin kautta. 3.3.3. USB-kaapelin pituus Pituus ei saa olla ylittää USB -standardin maksimia 3 metriä, joten laitteen kanssa ei saa käyttää ylipitkiä USB -jatkojohtoja. Liian pitkä kaapeli aiheuttaa häiriöitä ja signaalin heikkenemistä eikä tällöin voida taata häiriötöntä toimintaa. 3.3.4. Akun käyttöiän pidentäminen Kannettavien iwl250 -sarjan päätteiden akku on hyvä tyhjentää parin kuukauden välein käyttöiän pidentämiseksi. Tämä suoritetaan seuraavasti: Aseta pääte lataustelakkaansa Avaa valikko Telium Manager / Initialization / Hardware / Battery setup ja valitse Discharge Pääte kysyy Discharge? johon vastataan 1. YES Mikäli laitteen akkutyyppi tukee purkutoimintoa, näyttöön tulee akun kuva sekä prosenttiluku, joka kuvaa akun latausastetta Poistu valikosta painamalla punaista ja anna akun tyhjentyä kokonaan. Akun tyhjentäminen kestää n. 5 tuntia ja uudelleenlataaminen täyteen varaukseen niin ikään 5 tuntia, jona aikana laitetta ei saa irrottaa telakasta. 3.4. Kortinlukijan puhdistus Kortinlukijat tulee puhdistaa säännöllisesti, koska muuten lukijan lukukyky heikkenee ja käyttöikä lyhenee. Tämä on tärkeää varsinkin pölyisissä ja likaisissa ympäristöissä. Puhdistuskortin tulee olla sellainen, joka puhdistaa magneettijuovanlukijan lisäksi myös sirukortin lukijan. Lisätietoja mm. http://ingenico.cleaningcards.com. 3.5. Päätteiden MENU-valikko Menu valikosta voidaan asettaa joitakin kommunikaatioon liittyviä parametreja. Menu valikossa on myös erilaisia päätteen käyttöön liittyä toiminnallisuuksia. Jos halutaan, että asiakkaat eivät epähuomiossa pääse valikkoon, se voidaan sulkea rajapinnan kautta erillisellä komennolla. Integroitaessa on syytä ottaa huomioon, että on hyvä jättää mahdollisuus valikon avaamiseen siitä syystä, että siellä on poikkeustilanteita varten hyödyllisiä toimintoja. Kaikkia alla lueteltuja toimintoja ei ole saatavilla eri päätemalleille ja menun rakenne vaihtelee pääte- ja käyttötyypin mukaan. Menu valikkoon pääsee päätteestä riippuen joko F-näppäimellä tai Menu-näppäimellä. Menu valikon rakenne on seuraava, harmaaksi merkittyjä ei ole tarkoitettu käytettäväksi. Jokaisen Menu valinnan edessä on numero, jota käyttämällä valikon/toiminnon voi avata. Valinnan voi aktivoida myös liikkumalla navi-näppäimella ja kuittaamalla valinta vihreällä painikkoolla.numero voi muuttua sen mukaan miten monta valintaa tai toimintoa valikossa on 12/32
kulloinkin saatavilla. Valikon edessä oleva numero ei siis välttämättä pysy aina samana vaan voi vaihdella päätemallista ja käyttötavasta riippuen. Telium päätteiden menu valikko: TELIUM MANAGER MAKSUTOIMINNOT Consultation - tietoja asennetuista sovelluksista Evolution - laiteohjelmiston päivittäminen paikallisesti Initialization - perusasetukset Parameters - päivämäärä- ja kelloasetukset, asetusvalikon kieli SIM Code - PIN-koodin kysely; ei käytössä Hardware Modem setup - DHCP- ja IP-asetus Ethernet setup - DHCP- ja IP-asetus Battery setup - pariston tyhjennys ja virransäästön aikaväli Cradle setup - telakan asetukset ja paritus Base update - telakan päivitys Display - taustavalo, kontrasti ja taustavalon kesto Screen saver - valinnainen näytönsäästäjän teksti Password - salasana laitteelle Header - näytetäänkö tilapalkki näytön yläreunassa Beep on key - äänimerkki näppäinpainalluksesta Diagnosis - teknisiä tietoja mm. tietoliikenteen häiriöistä Deletion - tietojen poisto laitteelta Lähetä tapahtumat - tapahtumien lähetys manuaalisesti Uudelleenkäynnistys - pääte käynnistyy uudelleen Hyvitys - hyvitystapahtuma käsin Tulosta Edellinen kuitti - tulostetaan edellinen kuitti uudelleen Vuororaportti - päätetään vuoro ja tulostetaan raportti sen myynneistä Lähettämättömät tapahtumat - tulostetaan lähettämättömät tapahtumat Huom! Integroidussa käytössä (ja jos kuittitulostus on ohjattu päätteeltä sarjaporttiin) kuittisisältö on luettavissa rajapinnan kautta eikä sitä automaattisesti lähetetä tulostimelle. Ylläpito Hae päivityksiä - tarkistetaan ja asennetaan pääteohjelmistopäivitykset Viimeisen tapahtuman parametrit - tulostetaan tapahtuman parametrit Helpdesk - tulostetaan helpdesk-tunnukset, ei käytössä Yhteystesti - testataan onnistuuko yhteys palvelinkeskukseen Tulosta kauppiaan tiedot - tulostetaan kauppiaan konfiguraatio Päivitä installer - tarkistetaan ja asennetaan asennusohjelmistopäivitykset INSTALLER Print device info - tulostaa ohjelmistoversion ja laitteen sarjanumeron Primary comm - verkkoyhteyksien kanava, esim. GPRS Listen comm kassaintegraation portti EMV ENGINE - ei käytössä 13/32
4. SOVELLUSKOMPONENTIT Järjestelmä koostuu käyttötavan mukaan erilaisista sovelluskomponenteista, joiden häiriötön toiminta on edellytys sujuvalle käytölle. Tässä on kerrottu komponenttien toiminnassa lähinnä windows -käyttöjärjestelmissä. Integraatio maksupäätteeseen on mahdollista tehdä myös sarjaportin kautta ja tällöin kaikki tässä kappaleessa kerrotut sovelluskomponentit eivät ole käytössä. Nets Oy ei myöskään voi näin ollen vastata muiden osapuolien rakentamista komponenteista. 4.1. Käyttöoikeudet Asennettaessa rajapintakomponentti asennuspaketin kautta tarvitaan admin oikeudet kyseiseen järjestelmään. Lisäksi tarvitaan luku- ja kirjoitusoikeudet sovelluksen asennuskansioon ja lokitiedoston sekä asetuksien tallennuskansioon. Windows-rekisteriin ei normaalisti tarvitse lisätä mitään oikeuksia. Tästä poikkeuksena EMVAgent sovellus on ainoa, joka asettaa sovelluksen automaattikäynnistyksen tiedot rekisteriin. 4.2. USB-ohjaimen asennus USB ohjaimen asennus tapahtuu käyttämällä valmista asennusohjelmaa, joka esiasentaa tarvittavat tiedostot käyttöjäjestelmään. Laite näkyy laitehallinnassa virtuaalisena sarjaporttina ja USB laitehallinta asettaa sen numeron automaattisesti. USB ohjaimen asennuspaketti on jaeltavissa myös AD:n kautta, mutta asentuessaan se vaatii admin -oikeudet käyttöjärjestelmään. USB ohjain asentuu virtuaaliseksi sarjaportiksi ja Windows antaa sille ensimmäisen vapaan sarjaporttinimen. Jos portti halutaan pitää samana niin silloin laite tulee aina kytkeä samaan USB porttiin. Muussa tapauksessa sarjaportin nimi saattaa vaihdella. USB ohjain asentuu ilman kysymyksiä ennalta määritettyyn esiasennuspolkuun. USB ohjain näkyy esiasennettuna yllä olevassa polussa. Järjestelmä löytää ohjaintiedostot automaattisesti, kun laite kytketään USB porttiin. 14/32
USB liitännäiset maksupäätteet näkyvät laitehallinnassa porttien alla nimellä SAGEM MONETEL USB Telium. Porttinumero näkyy suluissa, mutta se ei välttämättä ole oikein jos porttinumero on asetettu esim. suoraan rekisteriin tai wmi skripteillä. 4.3. Sovellusten asennus rajapinta voidaan asentaa käyttämällä asennuspakettia tai kopioimalla tarvittavat komponentit sopivaan hakemistoon tietokoneelle. Varmista, että windows käyttöjärjestelmästä löytyy Microsoft.NET Framework 2.0. Sovelluksen käyttö ei onnistu ilman kyseistä alustaa. 4.3.1. komponenttien asennus asennuspaketin avulla rajapintakomponenttien asennus voidaan asentaa Windows -käyttöjärjestelmään käyttämällä MSI -asennuspakettia. Päivityksen yhteydessä asennuspaketti osaa ensin poistaa vanhan version ja asentaa uuden version tilalle eikä edellistä versiota tarvitse erikseen poistaa jollei siitä erikseen mainita ohjeistuksessa. Asennuspaketti on mahdollista suorittaa automatisoituna komentorivivalitsimien avulla. 4.3.1.1. asennuksen komentoriviparametrit Esimerkki: EMVSetup_1.00.031.exe /exenoui /quiet APPDIR= d:\my Nämä valinnat asentavat sovelluksen ilman käyttöliittymää "My " hakemistoon paikalliselle d: -asemalle. Komentoriviparametri /quiet voidaan korvata /passive arvolla jos halutaan nähdä asennuksen edistyminen ikkunassa. Passive -parametri ei vaadi käyttäjän toimia, mutta näyttää yksinkertaisen käyttöliittymän. APPDIR -parametri ei ole vaadittu jos käytetään oletushakemistoa asennukseen (C:\EMV) 4.3.1.1. Asennusvaiheet. Asennuksen vaiheet: 1. Jos käytössä USB kaapelilla kytketty laite niin asenna ensin USB ohjain edellä mainitun ohjeen mukaan. 15/32
2. Halutessasi kytke laite tietokoneeseen ja tarkista porttinumero. 3. Suorita asennuspaketti Asennuksen suoritus installer ohjelmalla antaa mahdollisuuden vain asennuspolun muuttamiseen. Cancel painikkeella asennus keskeytyy ja jo asennetut komponentit poistetaan. Finish painikkeella asennusohjelma sulkeutuu ja asennus on tämän jälkeen valmis. 4.3.1.2. Asennuksen toimivuuden tarkistus ja testaus rajapintakomponenttien asennuksen ja järjestelmän toimivuuden voi varmistaa ennakolta käynnistämällä Agent sovelluksen ja sen avulla testata yhteys maksupäätteeseen. Ensimmäisen testimaksun voi aloittaa Test välilehdeltä ja keskeyttämän tapahtuman viimeistään PIN syötössä punaisella painikkeella ei veloitusta suoriteta kortilta. Tällä voidaan helposti varmistaa, että yhteys rajapintakomponenttien ja maksupäätteen välillä toimii. Test - välilehti on mahdollista piilottaa komentoriviparametrien avulla. 4.4. Käyttöjärjestelmän asetukset 4.4.1. Käyttöoikeudet Käyttäjällä, jolla sovellusta suoritetaan, täytyy olla luku- ja kirjoitusoikeudet asennushakemistoon. luo kyseiseen hakemistoon asetustiedoston ja tallentaa sinne 16/32
kaikki tarvittavat asetuset seuraavaa käynnistystä varten. Asennushakemistoon tallennetaan myös lokitietoja jos n lokitus on aktivoitu. Agent sovellus on ainoa, joka tallentaa asetuksiaan rekisteriin. Jos halutaan käyttää AutoStart valintaa Agent sovelluksesta, niin käyttäjällä täytyy olla kirjoitusoikeudet rekisterin run haaraan. Agent sovellus voidaan asettaa myös muilla tavoin käynnistymään, joten rekisterin kirjoitusoikeudet eivät ole pakollisia. Vaihtoehtoisia tapoja on esim. pikakuvake käynnistysvalikkoon. 4.4.2. n dialogin jäädessä muiden avointen ikkunoiden taakse Käytettäessä n omaa dialogia, joka näyttää maksun etenemisen tilan myyjälle, ei ikkuna tule aina päällimmäiseksi vaan jää vilkkumaan tehtäväpalkille. Yleensä tämä tilanne tapahtuu vain ensimmäisen kerran tietokoneen käynnistyksen jälkeen ja vaatii ikkunan aktivoinnin erikseen. Tämä on osa Windows-käyttöjärjestelmän toimintaa ja voidaan ohittaa seuraavalla rekisteriasetuksella: - HKCU\Control Panel\Desktop\ForegroundLockTimeout REG_DWORD arvo 0 (nolla). Varoitus Rekisterieditorin virheellinen käyttö saattaa aiheuttaa vakavia ongelmia, joiden vuoksi käyttöjärjestelmä on ehkä asennettava uudelleen. Nets Oy ei takaa, että virheellisestä Rekisterieditorin käyttämisestä johtuvat ongelmat voidaan ratkaista. Käytät Rekisterieditoria omalla vastuullasi. Voit ratkaista ongelman muokkaamalla ForegroundLockTimeout -rekisterimerkinnän arvoa Rekisterieditorissa seuraavasti: Napsauta Käynnistä-painiketta, valitse Suorita, kirjoita avautuvaan ruutuun regedit ja valitse OK. Etsi ja valitse seuraava rekisterin aliavain Rekisterieditorissa: HKEY_CURRENT_USER\Control Panel\Desktop Etsi oikeanpuoleisesta ruudussa ForegroundLockTimeout ja kaksoisnapsauta sitä. Valitse Lukujärjestelmä-kohdassa Kymmenjärjestelmä, kirjoita Arvon data -ruutuun 0 ja valitse sitten OK. Huomautus ForegroundLockTimeout-rekisterimerkinnän oletusarvon mukaiseksi kymmenjärjestelmäarvoksi on määritetty 200000. Sulje Rekisterieditori ja käynnistä tietokone uudelleen. Ohje on kopioitu Microsoftin www-sivuilta ja mahdollinen päivitetty versio siitä on saatavissa internetin kautta. Lisää ohjeita ja tarkempia tietoja tähän löytyvät mm. alla olevilta sivustoilta: http://support.microsoft.com/kb/886217/fi http://support.microsoft.com/kb/886217/sv http://technet.microsoft.com/en-us/library/cc957208.aspx. 4.5. Eri rajapintavaihdot a voidaan käyttää TCP/IP socket rajapinnan kautta. Rajapintaa kutsutaan XML -sanomilla, jotka on kuvattu erillisessä API dokumentissa. TCP/XML rajapinta tarjoaa käytettäväksi kaksi eri protokollaa, jotka ovat XMLAPI ja DoPay. DoPay on yhteensopiva EmvCardissa käytetyn protokollan kanssa eikä siinä ole kaikkia ominaisuuksia, joita on mahdollista käyttää XML-API:n kautta. TCP/XML rajapinta vaatii aina EMVAgent sovelluksen käyttöä. Rajapinnoista löytyy lisätietoa API kuvauksesta. XML-API:n käyttöönottoon on saatavilla esimerkkitoteutus maksupäätetuen kautta. 17/32
4.1. XML-API XML-API on TCP socket pohjainen rajapinta. Tätä rajapintaa käytettäessä täytyy EMVAgent sovellus olla käynnistettynä ja XML-API aktivoituna. EMVAgent on kevyt palvelinsovellus, joka kuuntelee asetettua TCP porttia ja vastaa rajapintapyyntöihin TCP socket yhteyden kautta. XML-API:n sanomat ovat XML standardin mukaisia ja voidaan validoida XML parserin avulla. 4.2. Dopay -rajapinta DoPay rajapinnalla tarkoitetaan TCP socket pohjaista XML tyyppistä sanomamuotoa. DoPay tarjoaa yksinkertaistetun rajapinnan maksutapahtumien vastaanottoon ja se on yhteensopiva EmvCard sovelluksessa käytetyn protokollan kanssa. DoPay rajapinnan sanomat eivät ole suoraan validoitavissa XML parserin avulla eivätkä ne noudata XML standardia. Dopay protokollan sanomamuodot löytyvät EmvCard dokumentaatiosta. 4.3. EMVAgent -sovelluksen asetukset (XML-API ja Dopay) EMVAgent sovellus toimii API:n päällä ja tarjoaa rajapinnan TCP/Socket liikenteelle. Tämän vuoksi kyseiselle sovellukselle täytyy sallia liikenne palomuurin läpi. Sanomat ovat XML pohjaisia ja vastaavat samaa rakennetta kuin API. EMVAgent sovellus voidaan käynnistää käyttöliittymän kanssa tai ilman käyttöliittymää. Suurin osa asetuksista on myös mahdollista asettaa komentorivivalitsimien kautta ja tällöin käyttöliittymään tallennetut asetuksen ylikirjoitetaan. 18/32
4.3.1. EMVAgent -välilehdet Options välilehti. Options 1. Autostart EMVAgent: asettaa rekisterin run haaraan merkinnän, joka käynnistää sovelluksen automaattisesti seuraavan kirjautumisen yhteydessä. 2. Start to tray: Asettaa sovelluksen käynnistymään kellon viereen pikakuvakkeeksi. Sovellus on mahdollista käynnistää komentoriviltä myös ilman em. kuvaketta, jolloin sovelluksen käyttöliittymä on kokonaan piilotettu. 3. HTTP Proxy authentication: Asettaa n lähettämään kaikissa verkkoyhteyspyynnöissä kirjautuneen käyttäjän tiedot kyselyn mukana. 4. PinPad menu disabled: Sulkee päätteen menu valikon, joka on avattavissa Menu/F näppäimellä. Terminal 1. Type: Asettaa maksupäätteen tyypin. Päätetyypin asetusta ei tavitse muuttaa vaan se voi olla oletusasetus SagemML30 huolimatta käytetystä päätetyypistä. 2. Port: Kenttään voi kirjoittaa käytetyn portin nimen tai valita valikosta järjestelmästä löydetyt käytettävissä olevat portit. Tallennettaessa asetukset tämän jälkeen Save Options painikkeella, pääte käynnistyy automaattisesti sovelluksen käynnistyksen yhteydessä. 3. Initialize: Käynnistää päätteen käyttökuntoon. 4. Close port: Sulkee käytetyn portin. 5. Update: Asettaa päätteen tarkistamaan päivitykset Nets Oy:n palvelukeskuksesta. Bluetooth välilehti TCP API Server 1. Autostart TCP Server: käynnistää TCP palvelimen automaattisesti sovelluksen käynnistymisen yhteydessä kuuntelutilaan asetetun API tyypin ja -portin mukaisesti. 2. Start : Käynnistää TCP palvelimen. Painikkeen vieressä teksti Started tai Not started. 3. API Type: Asettaa käytetyn API rajapinnan tyypin. XML, DoPay tai DoPay with RFP. 4. TCP Port: Asettaa käytettävän TCP porttinumeron XML tai DoPay liikennettä varten. 5. TCP Port (RFP): Asettaa käytettävän TCP porttinumeron RFP liikenteelle. Aktiivinen ainoastaan, kun DoPay with RFP on valittuna. Ei käytössä tässä dokumentissa kuvatuissa päätteissä. 19/32
Test välilehti tarjoaa mahdollisuuden maksutapahtumaan toiminnan testaamiseen ja toiminnan tarkastamiseen. Tämän avulla tehdyt tapahtumat syntyvät oikeasti ja ne välitetään muun maksuaineiston mukana. Tästä syystä toimintoa on syytä käyttää harkiten. Toiminnolla voi myös tehdä hyvityksen tai peruutuksen. Tämä välilehti on mahdollista myös piilottaa komentorivivalitsimen avulla. Watchdog välilehdelle voi asettaa kuuntelijan, joka tarkkailee onko prosessi käynnissä ja aktiivisena. About välilehti näyttää tietoja sovelluksen versiosta. Send log file painikkeella voi lokitiedostot lähettää suoraan Nets Oy:n palvelukeskukseen tarkasteltaviksi. 4.3.1. EMVAgent sovelluksen komentoriviparametrit Käytettäessä EMVAgent sovellusta voidaan sille antaa tietyt asetukset komentoriviparametreina. Osa asetuksista voi myös olla tallennettuna asetustietokantaan ja osa annettuna komentoriviltä. Tässä on kuitenkin joitakin rajoituksia. Taulukko komentoriviparametreista: Nimi -NOGUI -TRAY -COMPORT:<com port> -COMTYPE -TCP -TCPTYPE -TCPPORT -TCPTIMEOUT -HTTPPROXY -DATAPATH -CURRPATH -NOTEST Käyttötarkoitus Käynnistys ilman käyttöliittymää Käynnistys tehtäväpalkille ilmaisinalueelle Asetetaan porttinimi esim. "-COMPORT:COM6" Päätteen tyyppi, COMPORT asetettava myös Käynnistää TCP palvelimen TCP API palvelimen tyyppi (XLMCOMM tai DOPAYCOMM) TCP API portti http pyyntöjen aikakatkaisu Proxy authentication aktiivoitu Tallennuspolku datalle Käynnistypolku Piilottaa testivälilehden käyttöliittymästä 20/32
4.4. Komponenttilistaus Alla olevassa taulukossa on lueteltu järjestelmän käyttämät komponentit. Nimi Tyyppi Käyttötarkoitus EMVAgent exe TCP/XML sekä Dopay rajapinta EMV.dll dll Sisäinen Native.NET API kirjasto EMVCore.dll dll Sisäinen kirjasto EMVDevice.dll dll Sisäinen kirjasto EMVGUI.dll dll Sisäinen kirjasto EMVTCP.dll dll Sisäinen kirjasto EMVUtil.dll dll Sisäinen kirjasto InTheHand.Net.Personal.dll dll Bluetooth-yhteyksen linkkikirjasto System.Data.SQLite.dll dll Tietokantakirjasto (32-bit) [64-bit järjestelmiin korvattava vastaavalla] 4.5. Rajapinnan palauttamat yleisimmät palautekoodit palauttaa virhetilanteissa tietoa ongelman syystä palautekoodien avulla. Joissakin tapauksissa mukana on myös selkokielinen selite antamassa lisätietoa palautekoodia varten. Selkokielistä selitettä ei aina palauteta, koska tieto voi olla jossain määrin arkaluontoista ja näissä tapauksissa käyttäjän tulee tietää palautekoodin aihe. Tällainen tilanne on esim. jos varmennuksessa tulee kielteinen vastaus. Kaikki palautekoodit eivät ilmaise virhettä vaan niissä myös voi olla täydentävää tietoa tapahtumasta. Alla olevassa taulukossa on lueteltu järjestelmän virhe- tai ongelmatilanteissa palauttamia virhekoodeja ja niiden merkityksiä. Koodi Nimi Selite 000 APPROVED Hyväksytty --- 100 AUTHORIZATION_DECLINE Hylätty, ei myyntilupaa 101 EXPIRED_CARD Varmennusvastaus: Vanhentunut kortti 200 AUTHORIZATION_DECLINE_TAKE_CARD Varmennusvastaus: Ei myyntilupaa, ota kortti. 900 AUTHORIZATION_ERROR Varmennusvirhe 999 AUTHORIZATION_NO_ONLINE_CONNECTION Ei varmennusyhteyttä Varmennusvastaukset alueella 1-999 Kieltävät vastaukset välillä 100-999 --- 1000 DATA_NOT_READ Sirukortilta ei saatu luettua tietoja. Magneettijuovakortilla lukuvirhe. 1001 CARD_REMOVED Kortti poistettu kesken tapahtuman 1002 AGREEMENT_NOT_FOUND Sopimusta kortin käytöstä ei löydy 1003 INVALID_PAN_LENGTH Näppäillyn korttinumeron pituus ei täsmää 1004 AUTHORIZATION_CODE_CHECKSUM_MISMATCH Käsin annetun varmennustunnuksen tarkiste ei ole oikein 1005 KEYING_IN_NOT_ALLOWED Kortin näppäily ei ole sallittu 1006 PURCHASE_MAX_LIMIT_EXCEEDED Korttityypin maksimiostoraja ylitetty 1007 PURCHASE_MIN_LIMIT_EXCEEDED Korttityypin minimiostoraja alitettu 1008 CASHWITHDRAWAL_NOT_ALLOWED Käteisnosto ei ole sallittu 1009 CREDIT_PURCHASE_NOT_ALLOWED Luotto-osto ei ole sallittu (Credit) 21/32
1010 INVALID_CARD Viallinen kortti 1011 NO_MATCHING_APPLICATIONS_ON_CHIP Sirulta ei löytynyt maksusovellusta --- 1080 REFUND_FALLBACK_REJECTED Peruutettavaa tapahtumaa ei löytynyt annetulla arkistoviitteellä ja 1081 INVALID_CANCELLATION kassahenkilö kielsi hyvityksen. Kassahenkilö yritti peruuttaa jo peruutetun tapahtuman uudelleen. 1082 CANCELLATION_NOT_ALLOWED Peruutus ei ole sallittu korttityypille 1083 PARTIAL_CANCELLATION_NOT_ALLOWED Osaperuutus ei ole sallittu korttityypille 1084 REFUND_NOT_ALLOWED Hyvitys ei ole sallittu korttityypille 1085 PARTIAL_REFUND_NOT_ALLOWED Osahyvitys ei ole sallittu korttityypille 1090 BLACKLIST_FAILURE Sulkulistatarkistus epäonnistui 1091 CARD_ON_BLACKLIST_TAKE_CARD 1092 CARD_ON_BLACKLIST_CALL_POLICE Kortti sulkulistalla ja kassahenkilöin tulisi ottaa kortti pois Kortti sulkulistalla ja kassahenkilöin tulisi soittaa poliisit paikalle 1093 CARD_ON_BLACKLIST Tapahtuma hylätty, kortti sulkulistalla --- 1100 ICC_DECLINE Siru hylkäsi tapahtuman --- 1200 CARD_BLOCKED Kortti on suljettu 1201 BLOCKED_APPLICATION Maksusovellus suljettu (käyttötapa) --- 1800 AID_OUTDATED Vanhentunut AID taulu käytössä 1801 BIN_OUTDATED Vanhentunut BIN taulu käytössä 1802 PUBLIC_KEYS_OUTDATED Vanhentuneet avaimet käytössä 1803 HOTCARD_OUTDATED Vanhentunut sulkulista käytössä 1804 CONFIG_OUTDATED Vanhentunut konfiguraatiotiedosto 1805 CONFIG_INVALID_OR_NOT_FOUND Viallinen tai puuttuva konfiguraatiotiedosto 1806 SERIAL_NBR_ERROR Sarjanumero puuttuu 1807 HOTCARD_NOT_FOUND Sulkulista puuttuu 1808 TRANSLATION_OUTDATED Käännöstiedot vanhentuneet --- 1900 CANCEL_ON_TERMINAL Tapahtuma keskeytetty päätteeltä 1901 CANCEL_ON_API Tapahtuma keskeytetty rajapinnasta 1902 PIN_BYPASS_NOT_ACCEPTED PIN syötön ohitusta ei sallittu --- 1997 NO_CONNECTION_TO_DEVICE Ei yhteyttä päätteeseen 1998 INCORRECT_SW_ON_TERMINAL Päätteessä väärä sovellusversio 1999 UNDEFINED Määrittelemätön virhe 1800 sarjan virhekoodi tarkoittaa usein sitä, että kyseisten tietojen tarkistus palvelimelta epäonnistui eikä tiedetä olisiko uudempia tiedostoja saatavilla. Liittyy yleensä verkkoyhteysongelmiin. Virhekoodi näkyy kauppiaan ruudulla käytettäessä Dopay rajapintaa tai MakeTransaction metodia. Jos dialogia ei käytetä, niin silloin virhekoodit ovat luettavissa FailureInfo rakenteesta tapahtuman yhteydessä. Tieto on luettavissa jälkeenpäin vain jos maksupäätteeseen on aktivoitu lokitus. Lisää tietoa FailureInfo rakenteesta löytyy API dokumentaatiosta. 4.6. Yhteysosoitteet Tarvittavat yhteysosoitteet ja käytettävät portit sekä protokollat ovat listattuna alla: 22/32
Osoite Portti Protokolla update.screenway.com TCP/80 http update.screenway.com TCP/443 https slave1.screenway.com TCP/443 https slave2.screenway.com TCP/443 https 23/32
5. KÄYTTÖÖNOTTO JA ASETUSTEN MUUTTAMINEN Tässä kappaleessa kerrotaan miten laitteen käyttöönotto tapahtuu ensimmäisellä kerralla ja mitä asetuksia on muokattavissa päätteestä. 5.1. Päätteestä ja rajapinnan kautta muutettavat asetukset Päätteen ja rajapinnan kautta on vain rajallinen määrä asetuksia muutettava. Suurin osa päätteen ohjauksesta tapahtuu hallintaliittymän kautta, jota Nets Oy operoi. Kaikki kauppiaan perustiedot ja parametrit hallitaan Nets Oy:n toimesta eikä kauppias tai integraattori pääse muuttamaan näitä asetuksia itse. On siis tärkeätä, että kyseiset tiedot ilmoitetaan oikein tilauksen tai muutospyynnön yhteydessä. Kauppiaan näytöllä näkyvän dialogin kieli voidaan asettaa joko API rajapintakutsujen kautta tai EMVAgent sovellusta käytettäessä käyttöliittymän kielivalinnalla. Päätteen Installer valikosta voi vaihtaa oletuskommunikointikanavia tarpeen mukaan. Installer valikossa on valittavana yhteyskanava verkkoliikenteeseen ja integraation viestinvälitykseen. Useimmiten ne ovat samat, mutta tarvittaessa ne voidaan ohjata eri kanavaan. Ks. menu valikko ja INSTALLER. 5.2. Nets Oy:n palvelukeskuksesta muutettavat asetukset Nets Oy:n palvelukeskuksesta muutetaan kaikki ne asetukset, joita ei ole mainittu edellisessä kappaleessa. Näihin sisältyvät esim. korttisopimukset, varmennusrajat, päätteen oletuskieli ja kuitille tulostettavat perustiedot. Mm. näistä perustiedoista koostuu päätteen konfiguraatio, joka ohjaa päätteen toimintaa. 5.3. Laitteen käynnistäminen ensimmäistä kertaa Ensimmäisellä käynnistyskerralla laite alustetaan käyttövalmiiksi. Laitteeseen esiasennetaan ennen lähetystä asiakkaalle Installer sovellus, jonka avulla pääte valmistellaan käyttökuntoon. Kun laitteeseen kytketketään virta, se lähtee käynnistymään ja jää odottamaan Waiting for network, press any key to continue tilaan. Tässä kohtaa ei normaalisti tule painaa mitään näppäimiä vaan pääte odottaa verkkoyhteyksien tai rajapinnan heräämistä. Pääte lähtee automaattisesti käynnistymään, kun se saa esim. ethernet verkkoyhteyden auki tai PC:n rajapinta lähettää käynnistyskomennon. Ensimmäisellä käynnistyskerralla päätteeseen esiasennettu Installer sovellus tarkistaa, lataa ja asentaa uusimman ohjelmistoversion palvelinkeskuksesta. Asennus käynnistetään painamalla vihreää painiketta kun pääte ilmoittaa Paina vihreää suorittaaksesi asennuksen. Ohjelmiston asennuksen jälkeen pääte lataa kyseiseen myyntipisteeseen määritetyt parametrit, kuten korttien sulkulistat. Pääte on käytettävissä vasta sen jälkeen, kun em. asennus on suoritettu. Integroidun päätteen näytöllä lukee tällöin normaalitilanteessa TERVETULOA! SYÖTÄ KORTTI. 5.4. Versiopäivitykset laitteelle Maksupäätteen versiopäivityksien jakelua hallinnoidaan Nets Oy:n palvelimilta. rajapintasovellus ladataan www-sivujen kautta. Versiopäivityksissä ota yhteyttä Nets Oy:n maksupäätetukeen. 24/32
6. TAPAHTUMIEN LÄHETYS JA TILITYSERÄT Nets Oy:n maksupäätteet lähettävät kaikki aineistonsa Nets Oy:n maksupäätepalveluiden palvelinkeskuksen kautta ja tätä kautta aineistot reititetään eri osapuolille. Tapahtumia käsitellään tilityserinä ja yleensä jokaisella erällä on oma yksilöllinen viitenumero. Tämän viitenumeron perusteella kauppiaan pankkitilille tehdään suoritus, joka kauppiaalle kuuluu. Nets Oy:n maksupäätteissä on useita eri vaihtoehtoja tapahtumaerin muodostamiseen sekä näiden erien lähettämiseen. Nets Oy:n maksupäätteiden asiakaspalvelu voi muuttaa tapaa, jolla erät muodostetaan. Integraattori voi vaikuttaa tietyissä konfiguraatioissa vain lähetysaikaan ja kaikki muut asetukset tehdään Nets Oy:ssä. Seuraavana on kerrottu näistä eri vaihtoehdoista. 6.1. Tapahtumien lähetys Nets Oy:n maksupäätteet voidaan konfiguroida lähettämään tapahtumat joko yhtenä eränä tai jokaisen tapahtuman jälkeen. Jos maksupääte asetetaan lähettämään tapahtumat omana eränä, niin silloin jokainen maksupääte muodostaa oman tapahtumaeränsä eikä esim. saman myymälän tapahtumia voida yhdistää yhteen tilitykseen. Tästä aiheutuu useita tilityksiä jokaisesta myymälästä. Maksupääte voidaan myös asettaa lähettämään tapahtumat jokaisen transaktion jälkeen. Tällöin jokaisen tapahtuman jälkeen yritetään tyhjentää kaikki lähettämättömät tapahtumat päätteestä. Yhteyskatkojen aikana tapahtumat tallennetaan off-line periaatteella päätteen muistiin ja ne lähetetään seuraavalla yhteyskerralla palvelukeskukseen. Tapahtumaerä voidaan lukita usealla eri tavalla ja kullakin tavalla on oma käyttötarkoituksensa ja rajoitukset. Näistä vaihtoehdoista lisää seuraavassa kappaleessa. Erän lukitus tarkoittaa sitä, että samaan erään ei enää hyväksytä uusia tapahtumia vaan erä prosessoidaan siihen mennessä palvelukeskukseen vastaanotetuilla aineistoilla ja välitetään sen jälkeen eteenpäin tilitettäväksi. 6.2. Tilityserien muodostus Käytettäessä maksupäätteessä muodostettavaa erää, myös tilityserät muodostetaan maksupäätteessä. Kukin pääte tekee itsenäisesti vakioviitteen, joka sisältää myös työasemanumeron. Integroitu pääte on järkevää asettaa lähettämään tapahtumat yksittäisinä jokaisen transaktion jälkeen ja tällöin tilityserät muodostetaan Nets Oy:n palvelukeskuksessa. Lukituksen yhteydessä jokainen tilityserä saa oman viitteensä ja viitteen muoto on myös sovittavissa erikseen. Oletuksena käytetään vakioviitettä, jonka muoto on selitetty tässä dokumentissa. Tilityserien muodostus tapahtuu lukituksen yhteydessä ja käsky lukitukseen voi tulla joko Master -päätteeltä tai se on voitu asettaa tapahtuvaksi ajoitettuna palvelimelta. Palvelimelta ajoitettu lukitus ei mahdollista raportin noutamista päätteelle ja tätä kautta rajapintaan tulostettavaksi vaan tapahtumat tulee tarkastella EMVHost Online raportoinnin kautta. Jos Master pääte lähettää lukituspyynnön niin silloin eräraportti palautuu rajapinnasta tulostettavaksi. Raportti on saatavilla valmiiksi asemoituna tai TLV muotoisena konekielisenä datana. Master pääte on mahdollista ajastaa lähettämään lukituspyynnön automaattisesti tai vaihtoehtoisesti pyyntö voidaan suorittaa rajapinnan metodien avulla. 25/32
7. RAPORTOINTI Maksupäätteen tapahtumien raportointi tapahtuu Nets Oy:n maksupääteraportoinnin eli EMVHostin Online palvelun kautta. Erälähetyksestä saa raportin kuittimuodossa tai TLV-tageina jos tapahtumien lukitus tehdään päätteen hallinoimana. Tämä asetus riippuu konfiguraatiosta, joka päätteille on asetettu. Katso lisää kohdasta Erälähetyksen vaihtoehdot. 7.1. EMVHost Online -raportointi Maksupäätteet lähettävät kaikki tapahtuman Nets Oy:n maksupäätepalveluiden palvelukeskukseen, josta ne välitetään raportointipalveluun. 7.2. EMVHost Online tapahtumien palaute ja tapahtumien täsmäytys Raportointipalvelusta voidaan tarkastella lähetettyjä tapahtumia tai noutaa aineisto tarkasteltavaksi taloushallinnon järjestelmiin. Aineisto voidaan noutaa CSV-muotoisena ja se sisältää kaikki halutun aikavälin tapahtumat. 7.3. Raportti erälähetyksestä Maksupäätteet lähettävät kaikki tapahtuman Nets Oy:n maksupäätepalveluiden palvelukeskukseen ja erälähetyksestä saadaan palauteraportti heti lähetyksen jälkeen. Huom! Jos tapahtumien lukitus erää varten on asetettu tapahtuvaksi palvelimella, niin raporttia ei voi tulostaa eikä se ole saatavilla rajapinnan kautta. 7.4. Tapahtumien yksilöinti Maksupäätejärjestelmäkuvauksen mukaan jokaiselle tapahtumalle annetaan päiväkohtainen arkistoviite. Arkistoviite muodostuu 12 numerosta, joista kuusi ensimmäistä on tapahtuman päivämäärä ja loput kuusi yksilöivät tapahtuman päivän sisällä. Nets Oy:n maksupäätteissä kuudesta jälkimmäisestä numerosta kolme ensimmäistä on työasemanumero ja kolme viimeistä juokseva numero 000-999. Arkistoviite on yksilöllinen kullekin maksupäätteelle (työasemalle) ja sen yksilöinti useamman palvelutunnuksen alla vaatii rinnalleen palvelutunnuksen. Tapahtuman peruutuksen yhteydessä tapahtuma saa alkuperäisen tapahtuman arkistoviitteen, joten yksilöintiin vaaditaan myös tapahtuman tyyppi (veloitus/peruutus). 7.5. Tilityserien viitteet Maksupäätteet lähettävät kaikki tapahtumat Nets Oy:n maksupäätepalveluiden palvelukeskukseen. Erät voidaan asettaa muodostamaan joko päätteessä tai palvelinkeskuksessa. Jokaiselle tilityserälle muodostuu haluttaessa viitenumero, joka pääsääntöisesti yksilöi erän. Viitteen muodostus erille voidaan haluttaessa myös jättää tekemättä. Jos erä muodostetaan maksupäätteessä, jokainen maksupääte tekee erälle oman viitenumeron alla olevan kaavion mukaisesti. Palvelinkeskuksessa muodostettavaan erään voidaan kerätä useiden saman palvelutunnuksen alla olevien päätteiden aineistot ja muodostaa näille yksi yhteinen erä. Tälle erälle on mahdollista asettaa erilaisia viitemalleja, joista oletuksena käytetään alla olevassa kaaviossa esitettyä mallia. Vakioviite muodostuu seuraavan kuvauksen mukaisesti: 26/32
Kaavio. Vakioviitteen muodostussäännön periaate. Haluttaessa käyttää muuta sääntöä viitteen muodostamiseen, ole yhteydessä Nets Oy:n maksupäätetukeen. 27/32