--- title: Úvod ke Cloud API description: Cílem tohoto API je spouštět úkoly z jakéhokoli externího zařízení nebo cloudového řešení v aplikaci Genius mobile pay. Očekáváme, že umožní propojit téměř jakékoli řešení s Genius mobile pay přes internet. Cloud API funguje tak, že pomocí API můžete vytvářet… url: "https://www.gptom.com/el/docs/api/cloudapi/uvod-ke-cloud-api/" updated: "2026-10-21" category: Cloud API --- # Úvod ke Cloud API Cílem tohoto API je spouštět úkoly z jakéhokoli externího zařízení nebo cloudového řešení v aplikaci Genius mobile pay. Očekáváme, že umožní propojit téměř jakékoli řešení s Genius mobile pay přes internet. Cloud API funguje tak, že pomocí API můžete vytvářet tasky pro koncové zařízení s aplikací Genius mobile pay. V tuto chvíli můžete využívat transakční tasky, ale v budoucnu budou k dispozici i další typy tasků. ![](http://www.gptom.com/wp-content/uploads/2022/04/information.png) Význam tasků Význam tasku v rámci tohoto API to znamená, že můžete vytvořit neomezený počet úloh, které budou zpracovány řešením Genius mobile pay (backend + frontend). Cílem platebního zařízení (terminálu nebo mobilního telefonu) je dokončit task. **Výsledek tasku ale nijak nesouvisí s výsledkem platby.** Pouze říká, že úkol probíhá, je dokončen nebo selhal. ## Proč používáme tasky? V našem řešení můžete paralelně vytvářet mnoho úloh pro jeden terminál. Věříme, že tato metoda může být přínosná pro některé případy použití, kdy mohou být požadavky generovány z více než jednoho místa. Díky tomu jsme schopni kdykoli přijímat úkoly a spravovat frontu na koncovém zařízení uživatelem (neplatí v polointegrovaném režimu). ## Jak lze používat cloud API Existují dva případy použití, jak můžete pracovat s Cloud API na koncovém zařízení: ![](https://www.gptom.com/wp-content/uploads/2022/04/gptom_asisted-mode.png) #### Asistovaný mód Platí v případě, že zařízení obsluhuje uživatel a vybírá úlohu, kterou má Genius mobile pay zpracovat. Jakmile je nový úkol odeslán do zařízení, zobrazí se push notifikace, pokud je aplikace na pozadí. Když na ní uživatel tapne, okamžitě se daná aktivat spustí. Každopádně přehled tasků dostupný v aplikaci lze použít k jejich správě. ![](https://www.gptom.com/wp-content/uploads/2022/04/gptom_semi-integrated.png) #### Automatický mód Použitelné v případě, kdy je zařízení umístěno naproti prodejci (jako klasický pokladní terminál spojený s pokladnou). Pokud je aplikace trvale v popředí, tasky se zpracovávají automaticky – jakmile zařízení task přijme, je automaticky zpracován (pokud neprobíhá žádná jiná aktivita - v tomto případě se task zpracuje ihned poté). V zásadě je ale na vás, který případ vám vyhovuje lépe. Rozdíl je pouze v používání apklikace. ## Jaké tasky podporujeme V našem API podporujeme následující tasky. Věříme, že pro vaše potřeby budou dostačující. Doporučujeme implementovat všechny tyto tři typy. ![](https://www.gptom.com/wp-content/uploads/2022/04/027-piggy-bank.png) #### Prodej Transakce prodej se používá, pokud chcete z karty držitele karty okamžitě strhnout částku za zakoupené zboží nebo služby. [FLOW PRODEJE](https://www.gptom.com/el/docs/api/cloudapi/transakce-prodej/) ![](https://www.gptom.com/wp-content/uploads/2022/04/reload.png) #### Storno transakce Tato funkce se používá ke zrušení již uskutečněné prodejní transakce. Jakoukoli transakci kartou můžete zrušit do 93 dnů od původního data. [FLOW STORNA](https://www.gptom.com/el/docs/api/cloudapi/storno-transakce/) ![](https://www.gptom.com/wp-content/uploads/2022/04/120-tools-and-utensils-2.png) #### Uzávěrka Účelem dávky je konsolidovat objem transakcí do jednoho balíčku. Uzavřením dávky zkontrolujete, že terminál a autorizační hostitel mají stejný součet transakcí. Když spustíte uzávěrku, autorizační centrum zavře existující dávku a otevře novou. [FLOW UZÁVĚRKY](https://www.gptom.com/el/docs/api/cloudapi/uzaverka-2/) Protože se snažíme poskytnout vám co nejpodrobnější specifikaci, základní shrnutí naleznete na tomto portálu, pro více podrobností a možnost otestování některých metod naleznete pokročilé specifikace pod odkazem níže. [ODKAZ NA DETAILNÍ DEFINICI](https://cloud-api-dev.gptom.com/documentation/index.html) ## Průběh transakce Abychom vám poskytli lepší přehled o tom, jak se průběh tasků a transakcí používá, níže najdete životní cyklus tasků a transakcí: Step Popis Stav tasku Detail transakce 1 Jakmile systém úspěšně přijme task (obsah, formát je správný). Úkol je předán do zařízení. CREATED NOT AVAILABLE 2 Zařízení spustí platební část. Pokud bude úspěšná = INIT_OK pokud dojde k chybě, zobrazí se INIT_ERROR . INIT_OK INIT_ERROR NOT AVAILABLE 3 Jakmile je transakce úspěšně zahájena, bude vrácen stav IN PROGRESS. Zahrnuje obrazovky transakce (přiložení karty, autorizace, výsledek). Pokud uživatel proces platby zruší, stav se změní na CANCELLED. Pokud během transakce dojde k jakékoli chybě, použije se stav ERROR. IN PROGRESS CANCELLED ERROR NOT AVAILABLE 4 Jakmile je transakce dokončena s jakýmkoli výsledkem (schváleno, odmítnuto), stav úlohy se změní na COMPLETED. Pouze když je stav úlohy COMPLETED, můžete požádat o podrobnosti transakce a její výsledek. COMPLETED STATUS AVAILABLE Níže naleznete průvodce, jaký by měl být další krok na základě obdrženého stavu: Stav Popis Jak se zachovat CREATED Váš úkol byl vytvořen a bude pokračovat - IN PROGRESS zavolejte GET /v1/tasks/{taskID} pro aktualizaci stavu, dokud nebude COMPLETED INIT_OK Proces platby byl úspěšně zahájen a platba může začít. zavolejte GET /v1/tasks/{taskID} pro aktualizaci stavu, dokud nebude COMPLETED INIT_ERROR Inicializace platebního procesu se nezdařila. Zkontrolujte přijatou chybu. Postupujte podle pokynů k chybě. IN PROGRESS Probíhá zpracování úkolu. Možný výstup může být: CANCELLED, ERROR nebo COMPLETED. zavolejte GET /v1/tasks/{taskID} pro aktualizaci stavu, dokud nebude COMPLETED CANCELLED Úloha byla zrušena uživatelem. měli byste spustit novou úlohu, protože tato úloha byla zrušena uživatelem ERROR Během zpracování úlohy došlo k nějaké chybě. Postupujte podle pokynů k chybě. COMPLETED Jakmile získáte tento stav, váš úkol byl dokončen a výsledek je k dispozici. měli byste pokračovat s TRANSACTION DETAIL