Android aplikácie pre platobný terminál

Spôsob vývoja Android aplikácií tretích strán sa na platobnom termináli NEXGO nelíši od vývoja na bežných zariadeniach s OS Android (smartfón).

Komunikácia medzi aplikáciou tretej strany a platobnou aplikáciou je realizovaná pomocou intent volaní podľa špecifikácie "Payment application". Rozhranie ponúka vyvolanie finančných operácií ako je platba, návrat, storno poslednej transakcie alebo servisných operácií ako je uzávierka, handshake či aktualizácia parametrov. Platobná aplikácia po vykonaní danej úlohy vracia výsledok operácie do nadradenú aplikáciu vo formáte JSON.

Aplikácia tretích strán môže pristupovať aj k periférijám terminálu, ako je napríklad tlačiareň. Prístup prebieha prostredníctvom NEXGO SDK, kde cez API rozhranie je možné pristupovať k jednotlivým periférijám.

Distribúcia a inštalácia aplikácií tretích strán prebieha z dôvodu bezpečnosti inak ako na bežných zariadeniach s OS Android. Akákoľvek produkčná verzia aplikácie je distribuovaná a naďalej aktualizovaná prostredníctvom našej špeciálnej predinštalovanej aplikácie Switchio Store, nie zo štandardného obchodu Play. Na základe ID daného platobného terminálu dôjde k inštalácii či aktualizácii príslušnej aplikácie.

V prípade požiadavky na zavedenie novej aplikácie či aktualizácie existujúcej aplikácie je potrebné poskytnúť našej spoločnosti:

súbor s vašou aplikáciou vo formáte .apk,
krátku dokumentáciu minimálne v rozsahu, ako pri testovaní vyvolať všetky typy platobných operácií, ktoré dodaná aplikácia integruje,
prípadné prihlasovací údaje (ak sú pre otestovanie aplikácie potrebné).

Aplikáciu otestujeme a zajistíme jej podpis špeciálnym bezpečnostným certifikátom a následnej distribúcie na požadované platobné terminály.

Na zaradenie aplikácie do Switchio Store je potrebné dodať nasledujúce informácie:

oficiálny názov aplikácie
verzia
krátky popis (max. 80 znakov, odporúčame skôr kratší)
dlhý popis (max. 180 znakov)
ikona vo formáte .ico, rozmer 134×134 px
APK súbor – veľkosť do 70 MB

Alternatívne je možné podpísanú verziu aplikácie poskytnúť jej autorovi, ak si distribúciu na klientske terminály chce zajistit sám (napríklad v prípade neverejného alebo uzavretého firemného systému atď.).

Vyššie uvedený postup je platný pre produkčné platobné terminály. Pre potreby vývoja je možné poskytnúť platobný terminál v takzvanom debug mode, pomocou ktorého je možné vytvárať a lokálne nahrávať aplikácie bežným spôsobom platným pre štandardné zariadenia s OS Android.

Numerický kód meny (currencyCode) vychádza z ISO-4217, v súčasnosti podporujeme meny EUR (978) a CZK (203). Kompletný zoznam je napríklad tu.

Dokumentácia API – ECR protokolu na stiahnutie tu. (platba)

Dokumentácia k NEXGO SDK API na stiahnutie tu. (tlačiareň, čítačka QR)

NEXGO SDK (nexgo-smartpos-sdk-vx.x.x_yyyymmdd.aar) na stiahnutie tu.