---
title: Úvod k app2app API
description: "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í Genius mobile pay. Toto API by vám mělo pomoci snadno integrovat…"
url: "https://www.gptom.com/el/docs/api/app2app/uvod-k-app2app-api/"
updated: "2026-10-21"
category: app2app API
---

# Úvod k app2app API

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í Genius mobile pay. 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 Genius mobile pay 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í:

       ![](https://www.gptom.com/wp-content/uploads/2022/04/001-payment-method.png)

#### Částka: 1111

CARD SALE SUCCESS ACCEPTED

Vaše aplikace obdrží úspěšný výsledek transakce a transakci úspěšně zpracuje na vaší straně.

 

       ![](https://www.gptom.com/wp-content/uploads/2022/04/001-payment-method.png)

#### Čá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.

 

       ![](https://www.gptom.com/wp-content/uploads/2022/04/001-payment-method.png)

#### Čá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.

 

       ![](https://www.gptom.com/wp-content/uploads/2022/04/001-payment-method.png)

#### Čá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 Genius mobile pay 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:

  ![](https://www.gptom.com/wp-content/uploads/2022/04/app2app-trx_flow.png)

Než budete moci zavolat v Genius mobile pay 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](https://www.gptom.com/docs/api/app2app/id-klienta/) č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](https://www.gptom.com/docs/api/app2app/nastaveni-v-android-11/). 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](https://developer.android.com/guide/components/bound-services).