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. To API powinno 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 stosowania kart testowych i pomoc w symulacji wszystkich przypadków wynikó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Ę
Twoja aplikacja otrzymuje odrzucenie transakcji i przetwarza ją we właściwy sposób po Twojej stronie - widzisz, że transakcja nie powiodła się.
Kwota: 1123
LIMIT CZASU NIEPOWODZENIA SPRZEDAŻY KARTY
Po naszej stronie nastąpi przekroczenie limitu czasu 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 sekcji To Artykuł.
NOWOŚĆ W przypadku Androida 11 upewnij się, że pakiet jest widoczny - czytaj 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 - tutaj. Bound Service.