Android aplikace pro platební terminál

Způsob vývoje android aplikací třetích stran se na platebním terminálu NEXGO neliší od vývoje na běžných zařízeních s OS Android (smartphone).

Komunikace mezi aplikací třetí strany a platební aplikací je realizována pomocí intent volání dle specifikace "Payment application". Rozhraní nabízí vyvolání finančních operací typu platba, návrat, storno poslední transakce či servisních operací typu uzávěrka, handshake či update parametrů. Platební aplikace po vykonání daného úkonu vrací výsledek operace do nadřazené aplikace ve formátu JSON.

Aplikace třetích stran může přistupovat i k periferiím terminálu, jako je např. tiskárna. Přístup probíhá pomocí NEXGO SDK, kde je přes API rozhraní možnost přistupovat k jednotlivým periferiím.

Distribuce a instalace aplikací třetích stran probíhá z důvodu bezpečnosti odlišně od běžných zařízení s OS Android. Jakákoliv produkční verze aplikace je distribuována a nadále aktualizována pomocí naší speciální předinstalované aplikace Switchio Store, nikoliv ze standardního obchodu Play. Na základě ID daného platebního terminálu dojde k instalaci či aktualizaci příslušné aplikace.

V případě požadavku na zavedení nové aplikace či update stávající aplikace je potřeba poskytnout naší společnosti:

soubor s vaší aplikací ve formátu .apk,
krátkou dokumentaci minimálně v rozsahu, jak při testování vyvolat všechny typy platebních operací, které dodaná aplikace integruje,
případně přihlašovací údaje (pokud jsou pro otestování aplikace potřeba).

Aplikaci otestujeme a zajistíme její podpis speciálním bezpečnostním certifikátem a následnou distribuci na požadované platební terminály.

Pro zařazení aplikace do Switchio Store je potřeba dodat následující informace:

oficiální název aplikace
verze
krátký popis (max. 80 znaků, doporučujeme spíš kratší)
dlouhý popis (max. 180 znaků)
ikona ve formátu .ico, rozměr 134×134 px
APK soubor – velikost do 70 MB

Alternativně je možné podepsanou verzi aplikace poskytnout jejímu autorovi, pokud si distribuci na klientské terminály chce zajistit sám (např. jde-li o neveřejný či uzavřený firemní systém apod.).

Výše uvedený postup je platný pro produkční platební terminály. Pro potřeby vývoje je možno poskytnout platební terminál v tzv. debug mode, pomocí něhož lze vyvíjet a lokálně nahrávat aplikaci běžným způsobem platným pro standardní zařízení s OS Android.

Numerický kód měny (currencyCode) vychází z ISO-4217, aktuálně podporujeme měny EUR (978) a CZK (203). Kompletní seznam je např. zde.

Dokumentace API – ECR protokolu ke stažení zde. (platba)

Dokumentace k NEXGO SDK API ke stažení zde. (tiskárna, čtečka QR)

NEXGO SDK (nexgo-smartpos-sdk-vx.x.x_yyyymmdd.aar) ke stažení zde.