Ďakujeme, že ste si pre integráciu vybrali naše API! Cieľom tejto dokumentácie je popísať, ako sa môžete pripojiť k platobnej aplikácii bežiacej na zariadeniach so systémom Android a aplikácii GP tom. Toto API by vám malo pomôcť ľahko integrovať vlastné aplikácie vyvinuté na platforme Android. Veríme, že s pomocou nášho API sa integrácia podarí behom chvíle.
Pripravte si všetko potrebné
Prejdite do sekcie „Na stiahnutie“ v tejto príručke a stiahnite si najnovšie balíky s aplikáciou, demo aplikáciou a knižnicou AIDL. Cieľom tohto simulátora je vyhnúť sa potrebe testovacích kariet a pomôcť simulovať všetky prípady výsledkov platieb, s ktorými sa môžete stretnúť v produkčnom prostredí. Podotýkame, že API je v teste aj v produkcii identické.
V súčasnosti môžete odoslaním presnej sumy z vašej aplikácie simulovať nasledujúce správanie:
Suma: 1111
Predaj kariet bol úspešný
Vaša aplikácia dostane informáciu o úspešnom výsledku transakcie a transakciu úspešne spracuje na vašej strane.
Suma: 1122
Neúspešný predaj karty – zamietnuté
Vaša aplikácia dostane negatívny výsledok transakcie a vy túto transakciu na vašej strane spracujete správnym spôsobom – zobrazíte, že transakcia zlyhala.
Suma: 1123
CHYBA PRI PREDAJI KARTY – ČASOVÝ LIMIT
Z našej strany dôjde k časovému limitu platby a vaša aplikácia musí v tomto duchu zobraziť výsledok.
Suma: 1124
VÝNIMKA PRI NEÚSPEŠNOM PREDAJI KARTY
Simuluje situáciu, keď na našej strane dôjde k výnimke – napr. technická porucha. Takto musíte výsledok oznámiť používateľovi.
Ukážková klientska aplikácia
Ak by ste chceli vidieť, ako funguje integrácia s aplikáciou tretej strany, môžete si stiahnuť demo balík klienta, ktorý obsahuje aj zdrojové kódy, ktoré vám pomôžu pochopiť, ako sa dá integrácia realizovať na platforme Android.
Knižnica AIDL
Knižnica AIDL zabezpečuje komunikáciu medzi vašou a našou aplikáciou – je potrebné ju pridať do vášho vývojového projektu. Najnovšiu verziu nájdete v sekcii na stiahnutie.
Príbeh transakcie
Príbeh transakcie je u všetkých typov transakcií veľmi podobný a pozostáva z krokov opísaných nižšie. Ak chcete porozumieť zaslaným výsledkom platieb, ktoré je možné získať z aplikácie GP, pozrite si prosím článok „Kódy návratu“ v tejto kapitole. Zjednodušene priebeh transakcie vyzerá takto:
Predtým, ako budete môcť v GP zavolať akúkoľvek požiadavku, musíte sa uistiť, že je používateľ prihlásený. Všetky požiadavky sa potom spracujú pod prihláseným používateľom.
NOVINKA Od verzie 1.2.0 tohto API môžete overiť identitu prihláseného používateľa odoslaním hodnoty „clientID“. Ďalšie podrobnosti a príklady použitia nájdete v toto článku.
NOVINKA V prípade systému Android 11 sa uistite, že ste zabezpečili viditeľnosť balíka – prečítajte si viac tu. Inak sa aplikácia neotvorí automaticky.
Viazaná služba – bound service
Viazaná služba je server v prostredí klient-server. Viazaná služba umožňuje komponentom (napríklad aktivitám) pripojiť sa k službe, odosielať požiadavky, prijímať odpovede a dokonca vykonávať medziprocesovú komunikáciu (IPC). Viazaná služba zvyčajne pretrváva len vtedy, keď obsluhuje inú komponentu aplikácie, a nebeží na pozadí po neobmedzenú dobu. Pre viac informácií o tom, ako pracovať s viazanými službami, navštívte Portál pre vývojárov Android tu – Viazaná služba.