• Produkt
  • Obchod
  • Ceník
  • Příručka
  • Podpora
 0 Kč
Přihlášení / Registrace
  • EN
  • RO
  • DE
  • SK
  • HU
  • PL
  • EL
  • Produkt
  • Obchod
  • Ceník
  • Příručka
  • Podpora
  • EN
  • RO
  • DE
  • SK
  • HU
  • PL
  • EL
KOUPIT

API

  • Transakce prodej (iOS)

Úvod

  • Než začnete
  • Vizuál účtenky
  • Ke stažení
  • Právní vyloučení odpovědnosti
  • Podpora při integraci
  • Certifikace & Testovací scénáře

app2app API

  • Úvod k app2app API
  • 1. Registrace transakce
  • 2. Požadavek na platbu [transactionRequestV2]
  • 3. Získání stavu transakce
  • 4. Získání detailů o transakci
  • Příklady kódů
  • Návratové kódy
  • Kontrola nainstalované aplikace
  • ID klienta
  • Nastavení v Android
  • Release notes

iOS API

  • Transakce prodej (iOS)
  • Zrušení transakce (iOS)
  • Provedení uzávěrky (iOS)
  • Úvod k iOS API

Cloud API

  • Úvod ke Cloud API
  • Flow transakce
  • Transakce prodej
  • Storno transakce
  • Uzávěrka
  • Master API účet
View Categories
  • Hlavní strana
  • Příručka
  • API
  • Cloud API
  • Úvod ke 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 GP tom. Očekáváme, že umožní propojit téměř jakékoli řešení s GP tom přes internet. Cloud API funguje tak, že pomocí API můžete vytvářet tasky pro koncové zařízení s aplikací GP tom. V tuto chvíli můžete využívat transakční tasky, ale v budoucnu budou k dispozici i další typy tasků.

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 GP tom (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í:

Asistovaný mód

Platí v případě, že zařízení obsluhuje uživatel a vybírá úlohu, kterou má GP tom 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ě.

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 poř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.

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

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. Tato metoda není použitelná pro kryptoměny.

FLOW STORNA

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

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

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
Step
Popis
Stav tasku
Detail transakce
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
Step
Popis
Stav tasku
Detail transakce
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
Step
Popis
Stav tasku
Detail transakce
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
Stav
Popis
Jak se zachovat
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
Stav
Popis
Jak se zachovat
INIT_ERROR
Inicializace platebního procesu se nezdařila. Zkontrolujte přijatou chybu.
Postupujte podle pokynů k chybě.
Stav
Popis
Jak se zachovat
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
Stav
Popis
Jak se zachovat
CANCELLED
Úloha byla zrušena uživatelem.
měli byste spustit novou úlohu, protože tato úloha byla zrušena uživatelem
Stav
Popis
Jak se zachovat
ERROR
Během zpracování úlohy došlo k nějaké chybě.
Postupujte podle pokynů k chybě.
Stav
Popis
Jak se zachovat
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
Jak se vám líbí tento návod?
Obsah
  • Proč používáme tasky?
  • Jak lze používat cloud API
  • Jaké tasky podporujeme
  • Průběh transakce

O produktu

  • Produkt
  • Instalace aplikace
  • Vydané verze
  • Podpora
  • Blog

Pro vývojáře

  • Úvod do integrace
  • app2app API
  • Cloud API
  • Integrace dle typu terminálu
  • Integrované společnosti
  • Ke stažení

O společnosti

  • Kontakt
  • Prohlášení o ochraně informací
  • Podmínky používání stránek
  • Všeobecné obchodní podmínky
  • GDPR

Příručka

  • Instalace aplikace
  • První spuštění aplikace
  • Platba kartou
  • Storno platby
  • Biometrika
  • Podpora přímo v aplikaci