USEIN KYSYTTYJÄ KYSYMYKSIÄ YLEISTÄ: K: ”Mitä rajapintaa

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 64bittisellä.
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.