Ďakujeme, že ste si vybrali naše API! Cieľom tejto dokumentácie je opísať, ako sa môžete pripojiť k platobnej aplikácii spustenej na zariadeniach a aplikáciách s Androidom GP tom. Toto API by vám mali pomôcť ľahko integrovať aplikácie založené na Androide vyvinuté interne. Veríme, že s pomocou našich API integrujete sa v krátkom čase.
Pripravte si všetko, čo potrebujete
Ak chcete stiahnuť najnovšie balíky aplikácií, demo aplikácie a knižnicu AIDL, prejdite do časti "Na stiahnutie" v tejto príručke. GP tom Cieľom simulátora je vyhnúť sa potrebe testovacích kariet a pomôcť simulovať všetky prípady výsledku platby, s ktorými sa môžete stretnúť v produkčnom prostredí. API Podotýkame, že je identický v testovacom aj produkčnom prostredí.
V súčasnosti môžete odoslaním presnej sumy z vašej aplikácie simulovať nasledujúce správanie:
Množstvo: 1111
AKCEPTOVANÝ ÚSPECH PREDAJA KARTY
Vaša žiadosť získa úspešný výsledok transakcie a úspešne spracuje transakciu na vašej strane.
Množstvo: 1122
VÝPREDAJ KARIET BOL ZAMIETNUTÝ
Vaša aplikácia dostane negatívny výsledok transakcie a vy spracujete transakciu správnym spôsobom na svojej strane - uvidíte, že transakcia zlyhala.
Množstvo: 1123
ČASOVÝ LIMIT ZLYHANIA PREDAJA KARTY
Z našej strany bude čas mimo platby a v tomto duchu musí vaša žiadosť zobrazovať výsledok.
Množstvo: 1124
VÝNIMKA PRE ZLYHANIE PREDAJA KARTY
Simuluje situáciu, keď z našej strany nastane výnimka – napr. technická porucha. Takto musíte propagovať výsledok používateľovi.
Demo klientska aplikácia
Ak by ste chceli vidieť, ako funguje integrácia s aplikáciou 3rd party, môžete si stiahnuť balík demo klienta, ktorý obsahuje aj zdrojový kód, ktorý vám pomôže pochopiť, ako je možné integráciu vykonať v systéme Android.
Knižnica AIDL
Knižnica AIDL zabezpečuje komunikáciu medzi vašou aplikáciou a našou – musíte ju pridať do svojho vývojového projektu. Najnovšiu verziu nájdete v sekcii na stiahnutie.
Priebeh transakcie
Priebeh transakcie je veľmi podobný pre všetky typy transakcií a pozostáva z krokov opísaných nižšie. GP tom Ak chcete pochopiť odoslané výsledky platieb, ktoré možno prijať z aplikácie, pozrite si časť "Kódy vrátenia" v tejto kapitole. Zjednodušene povedané, priebeh transakcie vyzerá takto:
Skôr než sa ozvete GP tom Akákoľvek požiadavka, musíte sa uistiť, že používateľ je prihlásený. Všetky požiadavky sú potom spracované pod prihláseným používateľom.
NOVINKY Z verzie 1.2.0 tohto API identitu prihláseného používateľa môžete skontrolovať odoslaním hodnoty "clientID". Ďalšie podrobnosti a prípady použitia nájdete v tomto článku.
NOVINKY V prípade systému Android 11 sa uistite, že sa staráte o viditeľnosť balíka - viac sa dočítate tu. V opačnom prípade sa aplikácia neotvorí automaticky.
Viazaná služba
Viazaná služba je server v rozhraní klient-server. Viazaná služba umožňuje komponentom (napríklad činnosti) viazať sa na službu, odosielať žiadosti, prijímať odpovede a dokonca vykonávať medziprocesovú komunikáciu (IPC). Viazaná služba zvyčajne pretrváva len vtedy, keď slúži inej zložke aplikácie a nespúšťa sa na pozadí donekonečna. Viac informácií o tom, ako pracovať s ohraničujúcimi službami, nájdete na Android Developer Portáli tu - Bound Service.