Cieľom tohto API je spúšťať úlohy z akéhokoľvek externého zariadenia alebo cloudového riešenia v aplikácii GP tom. Očakávame, že umožní prepojiť takmer akékoľvek riešenie s aplikáciou GP tom cez internet. Cloudové API funguje tak, že pomocou API môžete vytvárať úlohy pre koncové zariadenia s aplikáciou GP tom. V súčasnosti môžete využívať transakčné úlohy, ale v budúcnosti budú k dispozícii aj ďalšie typy úloh.
Význam úloh
Význam pojmu „úloha“ v rámci tohto API znamená, že môžete vytvoriť neobmedzený počet úloh, ktoré budú spracované riešením GP tom (backend + frontend). Cieľom platobného zariadenia (terminálu alebo mobilného telefónu) je dokončiť úlohu. Výsledok transakcie však nijako nesúvisí s výsledkom platby. Uvádza len, či úloha prebieha, je dokončená alebo zlyhala.
Prečo používame tašky?
V našom riešení môžete paralelne vytvárať viacero úloh pre jeden terminál. Veríme, že táto metóda môže byť prínosom v niektorých prípadoch použitia, keď môžu byť požiadavky generované z viac ako jedného miesta. Vďaka tomu sme schopní kedykoľvek prijímať úlohy a spravovať frontu na koncovom zariadení používateľa (neplatí v polointegrovanom režime).
Ako používať cloudové API
Existujú dva prípady použitia, ako môžete pracovať s Cloud API na koncovom zariadení:
Režim s asistenciou
Platí to v prípade, že zariadenie obsluhuje používateľ a vyberá úlohu, ktorú má GP spracovať. Akonáhle je nová úloha odoslaná do zariadenia, zobrazí sa push notifikácia, ak je aplikácia spustená na pozadí. Keď na ňu používateľ klikne, daná aktivita sa okamžite spustí. V každom prípade je možné na správu úloh použiť prehľad úloh dostupný v aplikácii.
Automatický režim
Použiteľné v prípade, ak je zariadenie umiestnené oproti predajcovi (ako klasický pokladničný terminál prepojený s pokladňou). Ak je aplikácia trvalo v popredí, úlohy sa spracúvajú automaticky – hneď ako zariadenie prijme úlohu, tá sa automaticky spracuje (ak neprebieha žiadna iná aktivita – v tomto prípade sa úloha spracuje ihneď potom).
V podstate je však len na vás, ktorý variant vám viac vyhovuje. Rozdiel je len v používaní aplikácie.
Aké tašky podporujeme
V našom API podporujeme nasledujúce úlohy. Veríme, že budú pre vaše potreby postačujúce. Odporúčame implementovať všetky tri typy.
Predaj
Transakciu predaja použijete v prípade, ak chcete z karty držiteľa okamžite strhnúť sumu za zakúpený tovar alebo služby.
Storno transakcie
Táto funkcia slúži na zrušenie už uskutočnenej predajnej transakcie. Akúkoľvek transakciu kartou môžete zrušiť do 93 dní od pôvodného dátumu.
Termín uzávierky
Účelom dávky je zoskupiť transakcie do jedného balíka. Uzavretím dávky skontrolujete, či terminál a autorizačný server majú rovnaký súčet transakcií. Keď spustíte uzávierku, autorizačné centrum uzavrie existujúcu dávku a otvorí novú.
Keďže sa snažíme poskytnúť vám čo najpodrobnejšiu špecifikáciu, základný prehľad nájdete na tomto portáli; ďalšie podrobnosti a možnosť otestovať niektoré metódy nájdete v rozšírenej špecifikácii pod nižšie uvedeným odkazom.
Príbeh transakcie
Aby sme vám poskytli lepší prehľad o tom, ako sa používa priebeh úloh a transakcií, nižšie nájdete životný cyklus úloh a transakcií:
Nižšie nájdete návod, aký by mal byť ďalší krok na základe zisteného stavu: