Ď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
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ľ GP tom Simulátor má zabrániť potrebe testovacích kariet a pomôcť simulovať všetky výsledky platieb, s ktorými sa môžete stretnúť vo výrobe. Berieme na vedomie, že API je identický v teste a vo výrobe.
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. Na pochopenie výsledkov odoslaných platieb, ktoré je možné prijať od GP tom Aplikácia, pozrite si článok "Návratové kódy" v tejto kapitole. Jednoducho 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.