Vă mulțumim pentru alegerea noastră API! 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 și aplicații Android GP tom. Acest API ar trebui să vă ajute să integrați cu ușurință aplicațiile bazate pe Android dezvoltate intern. Noi credem că, cu ajutorul nostru API te integrezi î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 demonstrative și biblioteca AIDL. Scopul simulatorului GP tom este de a evita nevoia de carduri de test ș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 test și în producție.
În prezent, trimițând o sumă exactă din aplicația dvs., puteți simula următorul comportament:
Suma: 1111
CARD SALE SUCCESS ACCEPTED
Aplicația dumneavoastră primește un rezultat de succes al tranzacției și procesează cu succes tranzacția de partea dvs.
Suma: 1122
CARD SALE FAIL DECLINED
Aplicația dumneavoastră primește un rezultat negativ al tranzacției și procesați tranzacția în mod corect de partea dvs., veți vedea că tranzacția a eșuat.
Suma: 1123
CARD SALE FAIL TIMEOUT
Va exista un timp de plată din partea noastră și, în acest spirit, cererea dumneavoastră trebuie să afișeze rezultatul.
Suma: 1124
CARD SALE FAIL EXCEPTION
Acesta simulează o situație în care apare o excepție din partea noastră – de exemplu, o defecțiune tehnică. Acesta este modul în care aveți nevoie pentru a promova rezultatul pentru utilizator.
Aplicație client demo
Dacă doriți să vedeți cum funcționează integrarea cu o aplicație 3rd party, puteți descărca un pachet de clienți demo care include și cod sursă care vă poate ajuta să înțelegeți cum se poate face integrarea pe Android.
Biblioteca AIDL
Biblioteca AIDL asigură comunicarea între aplicația dumneavoastră și a noastră – trebuie să o adăugați la proiectul dumneavoastră de dezvoltare. Puteți găsi cea mai recentă versiune în secțiunea de descărcare.
Progresul tranzacției
Fluxul tranzacției este foarte asemănător pentru toate tipurile de tranzacții și constă în etapele descrise mai jos. Pentru a înțelege rezultatele plăților trimise care pot fi primite de la aplicația GP tom , consultați secțiunea "Return Codes" din acest capitol. În termeni simplificați, fluxul tranzacției arată astfel:
Înainte de a putea apela GP tom Orice solicitare, trebuie să vă asigurați că utilizatorul este conectat. Toate solicitările sunt apoi procesate sub utilizatorul conectat.
NOU De la versiunea 1.2.0 a acestui API puteți verifica identitatea utilizatorului conectat prin trimiterea valorii "clientID". Pentru mai multe detalii și caz de utilizare, consultați acest articol.
NOU Pentru Android 11, asigurați-vă că aveți grijă de vizibilitatea pachetului - citiți mai multe aici. În caz contrar, aplicația nu se va deschide automat.
Serviciu legat
Un serviciu legat este un server într-o interfață client-server. Un serviciu legat permite componentelor (cum ar fi activitățile) să se lege la un serviciu, să trimită solicitări, să primească răspunsuri și chiar să efectueze comunicații interproces (IPC). De obicei, un serviciu legat persistă numai atunci când servește o altă componentă a aplicației și nu se execută în fundal pe termen nelimitat. Pentru mai multe informații despre cum să lucrați cu serviciile de încadrare, vizitați Portalul pentru dezvoltatori Android aici - Bound Service.