Vă mulțumim că ați ales API-ul nostru pentru integrare! Scopul acestei documentații este de a descrie modul în care vă puteți conecta la o aplicație de plată care rulează pe dispozitive Android și la aplicația GP tom. Acest API ar trebui să vă ajute să integrați cu ușurință aplicațiile bazate pe Android dezvoltate in-house. Credem că prin utilizarea API-ului nostru vă veți integra în cel mai scurt timp.
Pregătiți tot ce aveți nevoie
Accesați secțiunea „Descărcări“ din acest ghid pentru a descărca cele mai recente pachete de aplicații, aplicații demo și biblioteca AIDL. Scopul simulatorului GP tom este de a evita necesitatea cardurilor de testare și de a ajuta la simularea tuturor cazurilor de rezultate ale plăților pe care le puteți întâlni într-un mediu de producție. Menționăm că API este identic în testare și în producție.
În prezent, puteți simula următorul comportament prin trimiterea sumei exacte din aplicația dvs:
Suma: 1111
CARD DE VÂNZARE SUCCES ACCEPTAT
Aplicația dvs. primește un rezultat pozitiv al tranzacției și procesează tranzacția cu succes pe partea dvs.
Suma: 1122
VÂNZARE CARD EȘUATĂ REFUZATĂ
Aplicația dvs. primește o respingere a tranzacției și procesează tranzacția în mod corect pe partea dvs. - vedeți că tranzacția a eșuat.
Suma: 1123
VÂNZARE CARD EȘEC TIMEOUT
Va exista un termen de plată din partea noastră, iar aplicația dvs. trebuie să afișeze rezultatul în acest spirit.
Suma: 1124
VÂNZAREA CARDULUI EȘUEAZĂ EXCEPȚIA
Simulează o condiție în care apare o excepție din partea noastră - de exemplu, o defecțiune tehnică. Acesta este modul în care trebuie să anunțați rezultatul utilizatorului.
Aplicație client demonstrativă
Dacă doriți să vedeți cum funcționează integrarea cu o aplicație terță parte, puteți descărca pachetul client demo, care include codul sursă care vă poate ajuta să înțelegeți cum poate fi realizată integrarea pe platforma Android.
Biblioteca AIDL
Biblioteca AIDL gestionează comunicarea dintre aplicația dvs. și a noastră - trebuie să o adăugați la proiectul dvs. de dezvoltare. Cea mai recentă versiune poate fi găsită în secțiunea de descărcare.
Progresul tranzacției
Fluxul tranzacției este foarte similar pentru toate tipurile de tranzacții și constă din pașii descriși mai jos. Pentru a înțelege rezultatele plăților prin poștă care pot fi primite din aplicația GP tom, consultați articolul „Coduri de retur“ din această secțiune. În termeni simplificați, fluxul de tranzacții arată astfel:
Înainte de a efectua orice apel în GP tom orice cerere, trebuie să vă asigurați că utilizatorul este conectat. Toate solicitările sunt apoi gestionate de utilizatorul conectat.
NOU Începând cu versiunea 1.2.0 a acestui API, puteți verifica identitatea utilizatorului conectat prin trimiterea valorii „clientID“. Pentru mai multe detalii și cazuri de utilizare, vă rugăm să consultați Aceasta Articol.
NOU Pentru Android 11, asigurați-vă că v-ați asigurat că pachetul este vizibil - citeste mai mult aici. În caz contrar, aplicația nu se va deschide automat.
Serviciu de legare - serviciu legat
Serviciul legat este un server pe interfața client-server. Un serviciu legat permite componentelor (cum ar fi activitățile) să se lege de un serviciu, să trimită cereri, să primească răspunsuri și chiar să efectueze comunicare între procese (IPC). Un serviciu legat persistă de obicei numai atunci când deservește o altă componentă de aplicație și nu rulează în fundal pentru o perioadă nelimitată de timp. Pentru mai multe informații despre cum să lucrați cu serviciile bounding, vizitați portalul dezvoltatorilor Android aici - Serviciul Bound.