Děkujeme, že jste si pro integraci vybrali naše API! Cílem této dokumentace je popsat, jak se můžete připojit k platební aplikaci běžící na zařízeních se systémem Android a aplikací GP tom. Toto API by vám mělo pomoci snadno integrovat aplikace založené na Androidu vyvinuté vlastními silami. Věříme, že pomocí našeho API se integrujete během chvíle.
Připravte si vše potřebné
Přejděte do sekce “Ke stažení” v této příručce a stáhněte si nejnovější balíčky s aplikací, demo aplikací a AIDL knihovnou. Cílem GP tom simulátoru je vyhnout se nutnosti testovacích karet a pomoci simulovat všechny případy výsledků plateb, se kterými se můžete v produkčním prostředí setkat. Podotýkáme, že API je v testu i na produkci totožné.
V současné době můžete odesláním přesné částky z vaší aplikace simulovat následující chování:
Částka: 1111
CARD SALE SUCCESS ACCEPTED
Vaše aplikace obdrží úspěšný výsledek transakce a transakci úspěšně zpracuje na vaší straně.
Částka: 1122
CARD SALE FAIL DECLINED
Vaše aplikace obdrží zamítavý výsledek transakce a zpracujete transakci správným způsobem na vaší straně – zobrazíte, že transakce selhala.
Částka: 1123
CARD SALE FAIL TIMEOUT
Dojde k time outu platby z naší strany a v tomto duchu musí vaše aplikace zobrazit výsledek.
Částka: 1124
CARD SALE FAIL EXCEPTION
Simuluje stav, kdy dojde k výjimce na naší straně – např. technická porucha. Takto musíte výsledek propagovat uživateli.
Demo klientská aplikace
Pokud byste chtěli vidět, jak funguje integrace s aplikací 3. strany, můžete si stáhnout demo klientský balíček, který obsahuje i zdrojové kódy, které vám mohou pomoci pochopit, jak lze integraci provést na platformě Android.
AIDL knihovna
Knihovna AIDL zajišťuje komunikaci mezi vaší a naší aplikací – je potřeba ji přidat do vašeho vývojového projektu. Nejnovější verzi najdete v sekci ke stažení.
Průběh transakce
Průběh transakce je velmi podobný u všech typů transakcí a skládá se z kroků popsaných níže. Chcete-li porozumět zaslaným výsledkům plateb, které lze obdržet z GP tom aplikace, podívejte se prosím do článku “Návratové kódy” v této kapitole. Zjednodušeně průběh transakce vypadá takto:
Než budete moci zavolat v GP tom jakýkoli požadavek, musíte se ujistit, že je uživatel přihlášen. Všechny požadavky jsou pak vyřízeny pod přihlášeným uživatelem.
NOVINKA Od verze 1.2.0 tohoto API můžete zkontrolovat identitu přihlášeného uživatele odesláním hodnoty „clientID“. Další podrobnosti a případ použití naleznete v tomto článku.
NOVINKA Pro Android 11 se prosím ujistěte, že jste se postarali o viditelnost balíčku – více si přečtěte zde. Jinak se aplikace neotevře automaticky.
Vázání služby – bound service
Vázaná služba je server v rozhraní klient-server. Vázaná služba umožňuje komponentám (jako jsou aktivity) navázat se na službu, odesílat požadavky, přijímat odpovědi a dokonce provádět meziprocesovou komunikaci (IPC). Vázaná služba obvykle přetrvává pouze tehdy, když obsluhuje jinou komponentu aplikace a neběží na pozadí po neomezenou dobu. Pro více informací o tom, jak pracovat se službami bounding, navštivte Portál pro vývojáře Android zde – Bound Service.