Obavijest
Da biste dohvatili detalje transakcije, morate koristiti upit:
TransactionInquire(String transactionId, IInquireResultListener listener) throws RemoteException
Nakon što primite ID transakcije, vaša aplikacija treba generirati i poslati zahtjev za transakciju. Aplikacija za plaćanje pokrenut će cijeli proces plaćanja i vratiti rezultat. U starijim verzijama (prije verzije 1.2) koristila se sinkrona komunikacija za dohvaćanje rezultata transakcije (funkcija slušanja je sada zastarjela). U novoj verziji komunikacija je asinkrona, a metoda getTransactionState koristi se za dohvaćanje trenutnog statusa transakcije.
void transactionRequestV2(String transactionRequestJsonString, ITransactionResultListener listener) throws RemoteException
Zahtjev [TransactionRequestV2Entity]
Ovisno o vrsti transakcije, sljedeća polja su obavezna/neobavezna/izborna:
[(M) obavezno, (O) izborno]
KARTA
PLAĆANJE_RAČUNA
BLIK_PLATNJA
PLAĆANJE_VRATA
Obavijest
Svi iznosi trebaju biti uneseni s dvije decimalne znamenke; na primjer, 50 Kč treba unijeti kao 5000.
Opisi polja
iznos
Iznos određuje vrijednost transakcije. Ovaj se iznos izračunava u lokalnoj valuti koju terminal koristi. Format je s dvije decimalne znamenke, pa se, na primjer, 50 CZK unosi kao 5000.
iznos
U restoranima možete tražiti od gostiju da dodaju napojnicu, pri čemu se napojnica unosi putem vašeg sustava. Taj se iznos zatim zbraja s iznosom koji je unio blagajnik.
ID transakcije
Jedinstveni ID koji je generirao aplikacija za plaćanje tijekom procesa registracije transakcije.
ID klijenta
vrsta transakcije
Tip transakcije definira vrstu transakcije koju želite pokrenuti. Dostupne opcije su:
- RASPRODAJA(1)
- Prazno (2)
- REFUND(3) – since version 1.75.4, AIDL 1.28
- ZATVORI_SERIJU(4)
ID transakcije podrijetla
Ovo se koristi za otkazivanje transakcije i treba uključivati ID transakcije koju želite otkazati.
broj izvora
Ovo polje je neobavezno i može se ispuniti referentnim brojem – bilo kojim AN nizom do 20 znakova. Taj je niz vidljiv u svim izvješćima o transakcijama i pomaže računovodstvenim odjelima uskladiti uplate s narudžbama. Dijakritički znakovi nisu podržani.
otkažiMod
2 – Starije transakcije
isprintaj po uplati
Ovo određuje hoće li vaša aplikacija ili GP tom isporučiti račun kupcu. Zadana vrijednost je true (što znači da će GP tom ponuditi isporuku računa kupcu). Ako ovo postavite na false, korisnika ćemo vratiti u vašu aplikaciju odmah nakon transakcije, a na vama je da isporučite račun.
informacije o klijentu
Ako pošaljete račun izravno iz GP tom aplikacije, možete koristiti API za unaprijed popunjavanje adrese e-pošte ili telefonskog broja kupca.
poželjeni tip potvrde o uplati
Prilikom slanja računa iz GP aplikacije moguće je unaprijed definirati metodu slanja računa putem API-ja. Moguće vrijednosti su:
- TELEFON
- E-pošta
- QR
- Isprintaj
savjetPrikupi
Neobavezivo polje koje otvara zaslon za unos napojnice u GP aplikaciji. Nakon što je napojnica unesena u aplikaciju, pojavit će se zaslon za dodirivanje kartice. Da bi se ovaj zaslon prikazao, napojnice moraju biti omogućene u aplikaciji.
Način plaćanja
Od verzije 1.64.5 nadalje dodali smo mogućnost pozivanja dodatnih načina plaćanja putem app2app API-ja koristeći niz PaymentMethod. Trenutne opcije su:
GOTOVINA – gotovinska plaćanja
KARTICA – kartično plaćanje
ACCOUNT_PAYMENT – plaćanje putem računa (novi način plaćanja za češko tržište)
Ako se polje ostavi prazno, zadana vrijednost je CARD.