Dziękujemy za wybranie naszego API do integracji! Celem tej dokumentacji jest opisanie, w jaki sposób można połączyć się z aplikacją płatniczą działającą na urządzeniach z systemem Android i aplikacją GP tom. Ten interfejs API powinien pomóc w łatwej integracji aplikacji opartych na systemie Android opracowanych we własnym zakresie. Wierzymy, że dzięki naszemu API integracja przebiegnie błyskawicznie.
Przygotuj wszystko, czego potrzebujesz
Przejdź do sekcji "Pliki do pobrania" w tym przewodniku, aby pobrać najnowsze pakiety aplikacji, aplikacje demonstracyjne i bibliotekę AIDL. Celem symulatora GP tom jest uniknięcie konieczności korzystania z kart testowych i pomoc w symulacji wszystkich przypadków płatności, które można napotkać w środowisku produkcyjnym. Zwracamy uwagę, że interfejs API jest identyczny w środowisku testowym i produkcyjnym.
Obecnie można symulować następujące zachowanie, wysyłając dokładną kwotę z aplikacji:
Kwota: 1111
SUKCES SPRZEDAŻY KART AKCEPTOWANY
Aplikacja otrzymuje pomyślny wynik transakcji i pomyślnie przetwarza transakcję po swojej stronie.
Kwota: 1122
SPRZEDAŻ KARTY NIE POWIODŁA SIĘ
Aplikacja otrzymuje wynik odrzucenia transakcji i przetwarza transakcję w prawidłowy sposób po swojej stronie - pokazując, że transakcja nie powiodła się.
Kwota: 1123
LIMIT CZASU NIEPOWODZENIA SPRZEDAŻY KARTY
Po naszej stronie nastąpi przerwa w płatności, a aplikacja musi wyświetlać wynik w tym duchu.
Kwota: 1124
WYJĄTEK NIEUDANEJ SPRZEDAŻY KARTY
Symuluje stan, w którym wystąpi wyjątek po naszej stronie - np. awaria techniczna. W ten sposób należy poinformować użytkownika o wyniku.
Demonstracyjna aplikacja kliencka
Jeśli chcesz zobaczyć, jak integracja działa z aplikacją innej firmy, możesz pobrać pakiet klienta demonstracyjnego, który zawiera kod źródłowy, który pomoże Ci zrozumieć, w jaki sposób można przeprowadzić integrację na platformie Android.
Biblioteka AIDL
Biblioteka AIDL obsługuje komunikację między Twoją aplikacją a naszą - musisz dodać ją do swojego projektu deweloperskiego. Najnowszą wersję można znaleźć w sekcji pobierania.
Postęp transakcji
Przepływ transakcji jest bardzo podobny dla wszystkich typów transakcji i składa się z kroków opisanych poniżej. Aby zrozumieć wyniki płatności wysyłanych pocztą, które można otrzymać z aplikacji GP tom, zapoznaj się z artykułem "Kody zwrotne" w tej sekcji. W uproszczeniu przepływ transakcji wygląda następująco:
Przed wykonaniem jakiegokolwiek żądania w GP tom należy upewnić się, że użytkownik jest zalogowany. Wszystkie żądania są następnie obsługiwane przez zalogowanego użytkownika.
NOWOŚĆ Od wersji 1.2.0 tego interfejsu API można sprawdzić tożsamość zalogowanego użytkownika, wysyłając wartość "clientID". Więcej szczegółów i przypadków użycia można znaleźć w tym artykule.
NOWOŚĆ W przypadku systemu Android 11 upewnij się, że Twój pakiet jest widoczny - przeczytaj więcej tutaj. W przeciwnym razie aplikacja nie otworzy się automatycznie.
Usługa wiązania - usługa wiązana
Powiązana usługa jest serwerem na interfejsie klient-serwer. Usługa powiązana pozwala komponentom (takim jak aktywności) na powiązanie się z usługą, wysyłanie żądań, odbieranie odpowiedzi, a nawet wykonywanie komunikacji międzyprocesowej (IPC). Usługa powiązana zazwyczaj utrzymuje się tylko wtedy, gdy obsługuje inny komponent aplikacji i nie działa w tle przez nieokreślony czas. Więcej informacji na temat pracy z usługami powiązanymi można znaleźć na stronie Android Developer Portal - Bound Service.