USEIN KYSYTTYJÄ KYSYMYKSIÄ YLEISTÄ: K: Mitä rajapintaa suosittelette käytettäväksi ja miksi? V: XML -API -rajapintaa. Se tarjoaa huomattavasti DoPay rajapintaa laajemman ja joustavamman valikoiman toiminnallisuuksia. Lumo XML -API:lle on myös saatavilla kattava referenssisovelluksen lähdekoodi, joka helpottaa toteutusta. K: Mitä hyötyjä Lumo -integraatiosta saadaan? V: Lumo on jatkokehityksiä varten tehty rajapinta. Sillä mm. päästään käyttämään uudempia päätelaitteita ja sen tarjoamien ratkaisujen kautta voidaan haluttaessa siirtyä PCI:n alle. EmvCard sovelluksen tuki myös loppuu jossain vaiheessa, kun taas Lumon tuki jatkuu pidemmälle. K: Millaisella aikavälillä Lumo-integraatio pitää tehdä? V: Tässä vaiheessa emme osaa antaa tarkkoja suosituksia, mutta kuten aina ohjelmistokehityksessä, pieni etunoja ei ole koskaan haitaksi, kun tiedetään jo varmasti mihin suuntaan tuettu ympäristö tulee muuttumaan. EmvCard -päätteiden uusmyynti päättyy kevään 2013 aikana ja olemassa olevia ympäristöjä tuetaan toistaiseksi. K: Milloin i3380 maksupäätteet ja tuki EmvCard - ohjelmalle loppuvat? V: i3380 laitteen valmistus on jo loppunut, ja niiden uusmyynti loppuu viimeistään 30.4.2013. EmvCard sovelluksen tuki jatkuu toistaiseksi. K: Miten usein uusia versioita julkaistaan? V: Lumo -versioita julkaistaan 2-4 vuodessa. K: Miten voin tilata testipäätteen ja mistä saan testikortteja? V: Testipäätteen kehitystä varten voi tilata Luottokunnan maksupäätetuesta (Maksupaatetuki@luottokunta.fi). Testikortit tilataan korttien liikkeellelaskijoilta omalla sopimuksellaan, ja sopimuksissa yleensä kielletään luovuttaminen kolmansien osapuolien käyttöön.
Luottokunnan korttien (Business EuroCard) osalta voit ottaa yhteyttä osoitteeseen: card.management@luottokunta.fi K: Tarvitseeko minun tehdä jotain sopimuksia testejä varten? V: Tyypillisesti testikortteja varten joutuu tekemään liikkeellelaskijan / liikkeellelaskijoiden kanssa erilliset sopimukset. Luottokunnan maksupäätteiden kanssa ei tarvita erillistä sopimusta testauksesta. K: Millä maksupäätteellä integraatio kannattaa tehdä? V: Nyrkkisääntönä integraatiokehitys kannattaa tehdä sillä päätteellä jota aikoo käyttää. Testipäätteeksi Luottokunta toimittaa tyypillisesti ipp350-päätteen. Lumo-rajapinta toimii suoraan muiden siihen integroitavissa olevien päätteiden kanssa, joten rajapinta on suoraan hyödynnettävissä näiden kanssa. Luettelon Lumoon integroitavista päätteistä löydät täältä: http://www.luottokunta.fi/tuotteet/maksupaatteet/maksupaateasennus/. Ts. Lumo peittää varsin hyvin takanaan olevan maksupäätteen, joten useimmiten voidaan varsin pitkälle käyttää esimerkiksi ipp350-päätettä geneerisenä päätteen mallina kehityksessä. K: Eroaako maksupäätteiden asennus 64-bittisessä käyttöjärjestelmässä vs. 32-bittinen V: Kyllä. Asennus eroaa laitteen USB -ohjaimen osalta sekä SQLite komponentti on korvattava 64- bittisellä. K: Miksi lähimaksamiseen tarkoitetut testikortit eivät toimi teidän päätteissä? Milloin ko. ominaisuutta päästään testaamaan? V: Luottokunta on sertifioinut lähimaksamiseen soveltuvat erillismaksupäätteet. Kassaan liitettävät (integroitavat) päätteet sertifioidaan kevään 2013 aikana. Jatkossa lähimaksamisominaisuutta tukevia kassaan liitettäviä päätteitä ovat: ipp350 ja iwl250. Huomioitahan, että lähimaksamisominaisuutta ei tarvitse erikseen testata, koska lähimaksaminen ei näy kassarajapintaan eikä kassaintegraattorille. K: Mistä saan tarvittavat rajapintakuvaukset ja release Notesit integraation tekemiseen? V: Tuotetuki toimittaa uusien versioiden release notesit suoraan kassatoimittajakumppaneille. Osoitteesta http://www.luottokunta.fi/irtosivut/jarjestelmatiedostot löytyvät asennettavat Lumopaketit, API -kuvaukset sekä joitakin muita dokumentteja. Referenssisovelluksen koodin saat tilattua Luottokuntain tuotetuesta (mptuotetuki@luottokunta.fi)
K: Meillä todennäköisesti tulee Windows 8 seuraavien koneiden mukana. Tukeeko Lumo Windows 8:aa? V: Windows 8 tuki on tulossa kevään aikana.
TEKNISEMPÄÄ K: Mitkä ovat EmvCard -sovelluksen merkittävimmät erot Lumoon verrattuna? V: Dokumentissa EmvCard - Lumo (Siirtyminen_EmvCard_Lumo_1.0.pdf) on kuvattu havainnollisesti näiden kahden eri ratkaisun eroavaisuudet. K: Tarvitseeko EmvLumoAgent -sovelluksen olla käynnissä, kun meidän omasta kassaohjelmasta tehdään maksutapahtumia riippumatta siitä mitä rajapintaa käytetään? V: Jos Lumossa käytetään XML-API tai DoPay -rajapintaa, täytyy EmvLumoAgent -sovelluksen olla käynnissä. EmvLumoAgent -sovelluksessa täytyy olla aktivoituna kyseisen rajapinnan kuuntelu.. Jos ActiveX-komponentti on otettu osaksi kassasovellusta, se latautuu kassasovelluksen mukana ja sitä ei tarvitse erikseen latailla. K: Mikä on Watchdog -sivun tarkoitus ja sen asetukset? V: Watchdog on Lumon erillinen prosessi, jolla tarkkaillaan prosessien määrää. Tämä on kehitetty erityistarpeita varten, ja sillä ei normaalioloissa ole juuri käyttöä. K: Yritän saada yhteyden maksupäätteeseen käyttäen XML-yhteyttä. Yhteys muodostuu ok, mutta saan aina vastaukseksi vain <?xml version="1.0" encoding="utf-8"?><emvlumo xmlns="http://www.luottokunta.fi/emvlumo"><statusupdate><statuscode>1000</statuscode><st atusinfo>isalive 26.9.2012 11:50:14</StatusInfo></StatusUpdate></EMVLumo> Tämä huolimatta siitä, että yritän testata yhteyttä nettisivujen esimerkkitransaktion mukaisena. Osaatteko kertoa mitä teen väärin? V: Kuvaus on tässä varsin suppea, joten joudumme olettamaan joitakin asioita. Oletamme, että kokeilija asiakas on tässä tehnyt jonkin käskyn ja odottanut siihen vastausta. Sen sijaan sieltä on tullutkin vastaukseksi IsAlive -viesti, joka hämmentää. Todennäköisesti asiakkaan odottama viesti olisi ollut seuraavana jonossa, mutta hän on lopettanut TCP -socketin kuuntelun. Rajapinta ei ole synkroninen. Kun sinne lähettää käskyn, niin vastaus tulee, mutta se ei välttämättä ole se odotettu vastaus. Välissä voi tulla muitakin viestejä kuten status-päivityksiä tai IsAlive -viestejä.
K: Miten ML30-maksupäätteen magneettijuovanlukija toimii? V: Sirupäätteessä luku tehdään lähtökohtaisesti sirulta ja magneettijuovan luku on ainoastaan varajärjestelmänä. Rajapintadokumentaatiosta löydät komennot, joilla lukea magneettijuovan sisällön. K: Miten saan luettua eri Bonus-kortteja maksupäätteellä? tällä hetkellä saan vain ilmoituksen Kanta-asiakkuutta ei tunnistettu V: API -dokumentista löydät komennot, joilla bonuskortteja luetaan. Ilmoitus kanta-asiakkuutta ei tunnistettu johtuu siitä, että maksupäätteeseen ei ole aktivoitu ko. kanta-asiakasohjelman sopimusta. Tarjolla on kaksi funktiota: 1) ReadMagStripe ja 2) ReadBonusInformation. ReadMagStripe palauttaa Track2:n sisällön, kunhan on ensin todettu, että kyseessä ei ole maksukortti. Huom! ReadMagStripe on vanha komento ja sen käyttöä ei suositella ellei sen käyttöön ole erityistä syytä, kuten erikoisempien ei-standardien henkilökuntakorttien lukeminen tms. ReadBonusInformation on uudempi ja pidemmälle jalostettu ja se palauttaa bonustiedot joko sirulta tai magneettijuovalta. ReadBonusInformation mahdollistaa vain haluttujen bonustietojen palauttamisen päätteen konfiguroinnista riippuen. Näin esimerkiksi yhden kauppaketjun sinänsä löydettyjä ja luettuja bonustietoja ei ilmoiteta tunnistetuiksi, kun ollaan toisen kauppaketjun kaupassa. Voit kysyä lisätietoja maksupäätetuesta (mptuotetuki@luottokunta.fi). K: Miten päivän päätös hoidetaan (erien lukitseminen)? V: Päivän päätöksen aloittaminen riippuu päätteen asetuksista. Pääte voidaan asettaa toimimaan yhdellä seuraavista tavoista: 1. Normal mode eli tapahtumat säilytetään päätteen sisällä. Päivän päätös voidaan tehdä: a. Päätteeltä päätteen menusta b. Päätteellä ajastetusti c. Integroidulta kassalta käsin XML rajapintaa käyttäen. 2. Matador mode eli tapahtumat välitetään aina heti palvelimelle, joka osaa tehdä päivän päätöksen jommallakummalla tavalla: a. Slave/Master mode. Slave-pääte ei tee koskaan päivänpäätöstä, vaan master -päätteeksi määritelty pääte voi pyytää lukituksen ja päivänpäätöksen.
b. Kaikki saman maksatustunnuksen päätteet slave -tilassa ja maksupäätepalvelun back-endin palvelin tekee lukituksen ajastetusti. K: Onko asiakkaiden mahdollista käyttää EmvCardia ja Lumoa rinnakkain? V: Tilitysten seurannan kannalta näin ei missään nimessä kannata tehdä. K: Ilmeisesti EmvCard ohjelma ei enää mitenkään toimi Lumon kanssa? V: Lumo tarjoaa DoPay socket rajapinnan, mutta tiedostopohjainen ratkaisu on vanhentunut eikä sitä enää tueta. K: EmvLumoAgent.exe sovelluksen optiot eivät tallennu joissakin ympäristöissä. V: Ohjelma pitää käynnistää järjestelmänvalvojan (admin) tunnuksilla, jotta asetukset tallentuvat rekisteriin. Versiosta 1.6. SP4 lähtien Lumo osaa ilmoittaa jos tallentaminen epäonnistuu. K: EmvLumoAgentin ikkuna jää taustalle eikä etualalle. V: Lumon ikkuna on määritelty päällimmäiseksi ikkunaksi. Jos ko. dialogi kaikesta huolimatta jää taustalle, kilpailee joku muu ohjelma Lumon kanssa. K: Miksi pääte ei palauta kaikkien kanta-asiakaskorttien korttinumeroa? V: Pieni osa kanta-asiakaskorttien numeroista on päällekkäisiä maksukorttien numeroavaruuden kanssa, minkä takia EMV -säännöt kieltävät korttinumeron palauttamisen. K: Tukeeko Lumon rajapinta epästandardeja uratietoja? Uralta saattaa puuttua esim. = tai icc-bitti. V: Riippuu tapauksesta miten Lumo käsittelee epästandardeja kortteja. Jos törmää tällaiseen tilanteeseen, kannattaa ottaa yhteys tuotetukeen. K: Mistä saan selville pääteohjelmiston tai Lumon version? V: Lumon versionumero löytyy kahdesta paikasta: - EmvLumoAgentin käyttöliittymästä About välilehdeltä. - Lumon asennushakemistosta build_version.txt tiedostosta Pääteohjelmiston version taas saa selville päätteen näppäimillä painamalla Menu Installer PrintDev Info.
K: Jos pääte on jäänyt edellisestä tapahtumasta vaikka odottamaan korttia tms., niin miten kassa voi komentaa päätteen aloittamaan alusta? V: Kassa voi lähettää CancelTransaction komennon. K: Miksi maksutapahtuman peruuttaminen ei aina onnistu? V: Peruuttaminen tehdään aina arkistoviitteellä ja summalla. Maksuun käytetyn kortin parametrit voivat vaatia kortin paikallaoloa myös peruutuksessa. Jos alkuperäistä tapahtumaa ei löydy (esim. jos tapahtumista on muodostettu lähetyserä) peruutustapahtuma muuttuu hyvitykseksi. Tapahtuman peruuttaminen samalla tapahtuman arkistoviitteellä kumoaa maksutapahtuman joten ko. parista ei synny maksupalvelusta eteenpäin kirjanpitoon mitään vietävää, kun taas hyvitys (eri viite) kuuluu viedä samankokoisena mutta erillisenä ja alkuperäiseen tapahtumaan nähden vastakkaisena kirjanpitoon asti. K: Miksi maksupäätteen Cancel näppäintä saattaa joutua painamaan useita kertoja ennen kuin pääte keskeyttää tapahtuman. V: Tapahtuman keskeyttäminen ei ole aivan joka hetkellä mahdollista, vaan riippuu tapahtuman tilasta. Kortin poistaminen keskeyttää tapahtuman aina turvallisesti heti seuraavassa mahdollisessa kohdassa. K: Maksun vieminen loppuun on ilmeisesti pakko tehdä vain sillä, että kassa saa CardHolderReceiptin tai maksu epäonnistuu. Socket ei tule koskaan suljetuksi jos sitä jää vain odottamaan? V: TransactionStatus viesteistä voi päätellä lähettääkö pääte kuitit ja tuleeko event kortin poistamisesta. K: Miten Lumo kannattaa asentaa client koneelle jos kassa on selainpohjainen? V: Lumo kannattaa asentaa client koneelle ja antaa serverin kommunikoida verkon yli Lumon kanssa. Selainpohjaisten ratkaisujen suunnitteluvaiheessa kannattaa ottaa yhteyttä tuotetukeen.