Hvala što ste odabrali naš API za svoju integraciju! Cilj ove dokumentacije je opisati kako se možete povezati s aplikacijom za plaćanje koja radi na Android uređajima i aplikacijom GP Tom. Ovaj API trebao bi vam pomoći da jednostavno integrirate vlastite, interno razvijene aplikacije temeljene na Androidu. Sigurni smo da ćete uz pomoć našeg API-ja vrlo brzo biti spremni za rad.
Provjerite imate li sve što vam treba
Idite u odjeljak „Preuzimanja“ ovog vodiča i preuzmite najnovije pakete koji sadrže aplikaciju, demo aplikaciju i AIDL biblioteku. Cilj ovog simulatora je izbjeći potrebu za testnim karticama i pomoći simulirati sve moguće ishode plaćanja na koje biste mogli naići u produkcijskom okruženju. Imajte na umu da je API identičan u oba okruženja, testnom i produkcijskom.
Trenutno možete simulirati sljedeće ponašanje slanjem točnog iznosa iz vaše aplikacije:
Iznos: 1111
Prodaja kartica uspješno obrađena
Vaša će aplikacija primiti rezultat uspješne transakcije i uspješno obraditi transakciju na svojoj strani.
Iznos: 1122
Plaćanje karticom nije uspjelo – odbijeno
Vaša će aplikacija dobiti odbijanje transakcije i vi ćete na svojoj strani ispravno obraditi transakciju – prikazujući da je transakcija neuspjela.
Iznos: 1123
Prodaja kartice nije uspjela zbog isteka vremena
Plaćanje će na našoj strani isteći, a vaša aplikacija mora prikazati odgovarajući rezultat.
Iznos: 1124
IZJEMA PRODAJE KARTICA
Ovo simulira situaciju u kojoj na našoj strani dođe do iznimke – na primjer, tehničkog kvara. Ovako biste trebali korisniku priopćiti rezultat.
Demo klijentska aplikacija
Ako želite vidjeti kako funkcionira integracija s aplikacijom treće strane, možete preuzeti paket demo klijenta, koji također uključuje izvorni kod kako bi vam pomogao razumjeti kako implementirati integraciju na Android platformi.
AIDL biblioteka
AIDL biblioteka olakšava komunikaciju između vaše i naše aplikacije – morat ćete je dodati u svoj razvojni projekt. Najnoviju verziju možete pronaći u odjeljku za preuzimanje.
Proces transakcije
Proces transakcije vrlo je sličan za sve vrste transakcija i sastoji se od koraka opisanih u nastavku. Da biste razumjeli rezultate plaćanja koje možete dobiti iz odjeljka GP aplikacije, pogledajte članak „Kodovi povrata“ u ovom poglavlju. Jednostavno rečeno, proces transakcije izgleda ovako:
Prije nego što možete izvršiti bilo kakav zahtjev u GP-u, morate osigurati da je korisnik prijavljen. Svi se zahtjevi potom obrađuju pod računom prijavljenog korisnika.
NOVO Od verzije 1.2.0 ovog API-ja možete provjeriti identitet prijavljenog korisnika slanjem vrijednosti „clientID“. Za daljnje detalje i primjere upotrebe pogledajte ovo članak.
NOVO Za Android 11, molimo provjerite jeste li konfigurirali vidljivost paketa – pročitajte više ovdje. U suprotnom se aplikacija neće automatski otvoriti.
Povezana usluga
Vežani servis je poslužitelj u arhitekturi klijent-poslužitelj. Vežani servis omogućuje komponentama (kao što su aktivnosti) da se povežu na servis, šalju zahtjeve, primaju odgovore pa čak i izvode međuprocesnu komunikaciju (IPC). Vezena usluga obično traje samo dok opslužuje drugu komponentu aplikacije i ne radi u pozadini neograničeno. Za više informacija o radu s vezanim uslugama posjetite Android Developer Portal ovdje – Ograničena usluga.