Uwaga
Aby uzyskać szczegółowe informacje o transakcji, należy wysłać zapytanie wyłącznie za pomocą żądania Inquiry:
TransactionInquire(String transactionId, IInquireResultListener listener) throws RemoteException
Służy do uzyskania szczegółowych informacji o przeprowadzonej transakcji. Z tej metody warto skorzystać, gdy poprzedni krok został zakończony – transakcja została sfinalizowana, patrz Krok 3: Status transakcji
void TransactionInquire(String transactionId, IInquireResultListener listener) throws RemoteException
Identyfikator transakcji wejściowej zostanie wygenerowany w pierwszym kroku, patrz Krok 1: Rejestracja transakcji
Pole / Pole
wynik
responseMessage
trasanctionID
transactionType
merchantID
terminalID
currencyCode
kwota
TipAmount
kwota zwrotu
cardNumber
cardDataEntry
approvedCode
referenceNumber
traceNumber
data
czas
emvAppLabel
sequenceNumber
batchNumber
cardProduct
pinOK
merchantInfo
emvAid
cardHolderVerificationMethod
externalTransactionID
totalamount
numer pokwitowania
blikCode
dccData:
status
kwota
currencyCode
kurs wymiany
znaczniki
wskaźnik schematu regionu
Typ
Integer
String
String
Integer
String
String
String
String
String
String
String
String
String
String
String
String
String
String
String
String
String
String
String
String
String
Integer
Integer
Integer
Integer
String
String
String
String
String
String
Opcjonalne / Optional
Od
Tak
Tak
Tak
Tak
Tak
Tak
Tak
Tak
Tak
Tak
Tak
Tak
Tak
Tak
Tak
Tak
Tak
Tak
Tak
Tak
Tak
Tak
Tak
Tak
Tak
Tak
Tak
Tak
Tak
Tak
Tak
Tak
Tak
Tak
Tak
Informacje o kwocie
Kwoty, niezależnie od ich wysokości, są zawsze podawane z dokładnością do dwóch miejsc po przecinku *100, co oznacza, że np. 50,25 Kč wpisuje się jako 5025 Kč.
Imię / Nazwisko
Typ
Opcjonalne / Optional
resultCode
Integer
Nie
transactionId
String
Tak
clientID
String
Tak
responseMessage
String
Tak
błąd
ErrorResultEntity
Tak
Objaśnienie pól
Pole
Opis / Description
wynik
CZ: Podaje wynik transakcji (np. 0 oznacza pomyślną transakcję).
EN: Wskazuje wynik transakcji (np. 0 oznacza pomyślną transakcję).
EN: Wskazuje wynik transakcji (np. 0 oznacza pomyślną transakcję).
responseMessage
CZ: Wyświetla wynik transakcji z autoryzacji (np. 201)
EN: Wyświetla wynik transakcji z autoryzacji (np. 201)
EN: Wyświetla wynik transakcji z autoryzacji (np. 201)
transactionID
CZ: Unikalny identyfikator generowany przez aplikację płatniczą podczas procesu rejestracji transakcji.
EN: Unikalny identyfikator wygenerowany przez aplikację płatniczą podczas procesu rejestracji transakcji.
EN: Unikalny identyfikator wygenerowany przez aplikację płatniczą podczas procesu rejestracji transakcji.
transactionType
PL: Typ transakcji określa typ transakcji, którą chcesz zainicjować. Dostępne wartości to:
1 – Sprzedaż 2 – Anulowanie transakcji 4 – Zamknięcie EN: Określa typ transakcji. Dostępne wartości to:
1 – Sprzedaż, 2 – Anulowanie transakcji, 4 – Zamknięcie partii / Zamknięcie dnia
1 – Sprzedaż 2 – Anulowanie transakcji 4 – Zamknięcie EN: Określa typ transakcji. Dostępne wartości to:
1 – Sprzedaż, 2 – Anulowanie transakcji, 4 – Zamknięcie partii / Zamknięcie dnia
merchantID
CZ: Unikalny identyfikator sprzedawcy, zwykle reprezentujący identyfikator lokalizacji.
PL: unikalny identyfikator sprzedawcy, zazwyczaj identyfikator lokalizacji
PL: unikalny identyfikator sprzedawcy, zazwyczaj identyfikator lokalizacji
terminalID
CZ: Identyfikator terminala, na którym przetwarzane są transakcje. Identyfikuje terminal w systemach GP.
PL: Unikalny identyfikator terminala, na którym przetwarzana jest transakcja.
PL: Unikalny identyfikator terminala, na którym przetwarzana jest transakcja.
currencyCode
CZ: Trzycyfrowe kody walut ISO - lista znajduje się na stronie Wiki.
PL: kod ISO waluty składający się z trzech znaków.
PL: kod ISO waluty składający się z trzech znaków.
kwota
CZ: Kwota określa wielkość transakcji. Kwota ta jest obliczana w walucie krajowej używanej przez terminal. W przypadku zamknięcia obejmuje ona wszystkie transakcje kartą, uznane minus obciążone.
PL: Kwota określa wielkość transakcji. Kwota ta jest obliczana w walucie krajowej używanej przez terminal. W dniu zamknięcia zawiera ona wszystkie transakcje kartą, uznanie minus obciążenie.
PL: Kwota określa wielkość transakcji. Kwota ta jest obliczana w walucie krajowej używanej przez terminal. W dniu zamknięcia zawiera ona wszystkie transakcje kartą, uznanie minus obciążenie.
TipAmount
CZ: Wskazówki. Wypełnione, jeśli zostało wprowadzone.
PL: Wskazówka. Wypełnione w razie potrzeby.
PL: Wskazówka. Wypełnione w razie potrzeby.
kwota zwrotu
CZ: Kwota zwrotu zostanie wpisana w przypadku skorzystania z transakcji z zwrotem.
EN: Kwota zwrotu gotówki jest wpisywana w momencie skorzystania z transakcji z zwrotem gotówki.
EN: Kwota zwrotu gotówki jest wpisywana w momencie skorzystania z transakcji z zwrotem gotówki.
cardNumber
CZ: Numer karty (PAN). Jest podany w postaci zamaskowanej. Przykład: "479608********1859"
EN: Numer karty (PAN). Jest on przedstawiony w postaci zamaskowanej. Przykład: "479608********1859"
EN: Numer karty (PAN). Jest on przedstawiony w postaci zamaskowanej. Przykład: "479608********1859"
cardDataEntry
CZ: Określa zastosowaną metodę odczytu karty. Możliwe wartości to:
MANUAL – ręczne wprowadzenie
ICC – chip
CTLS – bezstykowy
MAG – pasek magnetyczny.
EN: Określa zastosowaną metodę odczytu karty. Możliwe wartości:
MANUAL – ręczne wprowadzenie
ICC – chip
CTLS – bezstykowy
MAG – pasek magnetyczny.
MANUAL – ręczne wprowadzenie
ICC – chip
CTLS – bezstykowy
MAG – pasek magnetyczny.
EN: Określa zastosowaną metodę odczytu karty. Możliwe wartości:
MANUAL – ręczne wprowadzenie
ICC – chip
CTLS – bezstykowy
MAG – pasek magnetyczny.
approvedCode
CZ: Należy wypełnić tylko wtedy, gdy transakcja zostanie zatwierdzona.
PL: Jest obecny tylko wtedy, gdy transakcja jest przetwarzana.
PL: Jest obecny tylko wtedy, gdy transakcja jest przetwarzana.
referenceNumber
CZ: Numer referencyjny wprowadzony podczas żądania płatności.
EN: numer referencyjny podany podczas dokonywania płatności
EN: numer referencyjny podany podczas dokonywania płatności
traceNumber
CZ:
data
CZ: Data przetworzenia transakcji w systemie autoryzacyjnym.
EN: Data przetworzenia transakcji.
EN: Data przetworzenia transakcji.
czas
CZ: Czas, w którym transakcja została przetworzona w systemie autoryzacyjnym.
EN: Czas przetworzenia transakcji.
EN: Czas przetworzenia transakcji.
emvAid
CZ: Określa aplikację EMV używaną do przetwarzania transakcji – np. Visa Debit
EN: Określa aplikację EMV używaną do przetwarzania transakcji – na przykład Visa Debit
EN: Określa aplikację EMV używaną do przetwarzania transakcji – na przykład Visa Debit
emvAppLabel
CZ: nazwa karty EMV, która została użyta do płatności.
EN: etykieta używanej karty
EN: etykieta używanej karty
sequenceNumber
CZ: Służy do anulowania transakcji. Użyj otrzymanej wartości, która była częścią transakcji, którą chcesz anulować.
PL: Służy do anulowania transakcji. Używa otrzymanej wartości, która była częścią transakcji, którą chcesz anulować.
PL: Służy do anulowania transakcji. Używa otrzymanej wartości, która była częścią transakcji, którą chcesz anulować.
batchNumber
CZ: Identyfikuje numer zamknięcia. Należy wypełnić, jeśli wymagany jest termin.
PL: Określa numer partii. Występuje podczas zamykania transakcji wsadowej.
PL: Określa numer partii. Występuje podczas zamykania transakcji wsadowej.
cardProduct
CZ: Możliwe wartości to:
VISA
MASTER
AMEX
DISCOVERY
EN: Możliwe wartości:
VISA
MASTER
AMEX
DISCOVERY
VISA
MASTER
AMEX
DISCOVERY
EN: Możliwe wartości:
VISA
MASTER
AMEX
DISCOVERY
pinOk
CZ: Wskazuje, czy wprowadzono kod PIN
EN: Wskazuje, czy wprowadzono kod PIN
prawda/fałsz
EN: Wskazuje, czy wprowadzono kod PIN
prawda/fałsz
merchantInfo
CZ: Wyświetli dane adresowe sprzedawcy.
EN: Wyświetla adres sprzedawcy.
EN: Wyświetla adres sprzedawcy.
cardHolderVerificationMethod
CZ: Wyświetla informacje o weryfikacji posiadacza karty płatniczej, za pomocą której dokonano płatności (kod PIN, brak).
EN: Wyświetla metodę weryfikacji posiadacza karty (kod PIN, brak).
EN: Wyświetla metodę weryfikacji posiadacza karty (kod PIN, brak).
externalTransactionID
CZ: Numer identyfikacyjny transakcji w aplikacji GP to
EN: Numer identyfikacyjny transakcji w aplikacji GP tom
EN: Numer identyfikacyjny transakcji w aplikacji GP tom
totalAmount
CZ: Łączna kwota wraz z napiwkiem, która została zapłacona.
EN: Całkowita kwota, która została zapłacona, obejmowała napiwek.
EN: Całkowita kwota, która została zapłacona, obejmowała napiwek.
numer pokwitowania
CZ: Numer identyfikacyjny paragonu
EN: Numer identyfikacyjny paragonu
EN: Numer identyfikacyjny paragonu
blikCode
CZ: Sześciocyfrowy kod numeryczny, który należy wprowadzić przed dokonaniem płatności.
EN: Sześciocyfrowy kod numeryczny, który należy wprowadzić przed dokonaniem płatności.
EN: Sześciocyfrowy kod numeryczny, który należy wprowadzić przed dokonaniem płatności.
status (DCC)
CZ: Podaje status DCC. Jeśli wyświetla się "ACCEPTED", oznacza to, że transakcja została zrealizowana za pośrednictwem DCC i należy wypełnić paragon DCC odpowiednimi danymi. Jeśli wyświetla się "NOT_ACCEPTED", w takim przypadku można zignorować dane DCC.
EN: Wskazuje status DCC. Jeśli wyświetla się komunikat "ACCEPTED", transakcja została zrealizowana za pośrednictwem DCC i należy wpisać dane DCC na paragonie. Jeśli wyświetla się komunikat "NOT_ACCEPTED", można zignorować dane DCC.
EN: Wskazuje status DCC. Jeśli wyświetla się komunikat "ACCEPTED", transakcja została zrealizowana za pośrednictwem DCC i należy wpisać dane DCC na paragonie. Jeśli wyświetla się komunikat "NOT_ACCEPTED", można zignorować dane DCC.
kwota (DCC)
CZ: Kwota transakcji w walucie DCC – w walucie karty klienta. Należy ją wyświetlić dokładnie tak, jak pojawi się w odpowiedzi API, łącznie z liczbą miejsc po przecinku.
EN: Kwota transakcji w walucie DCC – w walucie karty klienta. Należy ją podać na paragonie dokładnie tak, jak została otrzymana w odpowiedzi API, z zachowaniem prawidłowej liczby miejsc po przecinku.
EN: Kwota transakcji w walucie DCC – w walucie karty klienta. Należy ją podać na paragonie dokładnie tak, jak została otrzymana w odpowiedzi API, z zachowaniem prawidłowej liczby miejsc po przecinku.
currencyCode (DCC)
CZ: Waluta karty lojalnościowej.
EN: Waluta karty klienta.
EN: Waluta karty klienta.
kurs wymiany (DCC)
CZ: Podaje kurs wymiany. Wartość ta jest wyrażona w lokalnej walucie terminala. Należy ją wyświetlić dokładnie tak, jak pojawia się w odpowiedzi API, łącznie z liczbą miejsc po przecinku.
EN: Wskazuje kurs wymiany. Wartość ta jest podana w lokalnej walucie terminala. Należy ją podać na paragonie dokładnie tak, jak została otrzymana w odpowiedzi API, z zachowaniem prawidłowej liczby miejsc po przecinku.
EN: Wskazuje kurs wymiany. Wartość ta jest podana w lokalnej walucie terminala. Należy ją podać na paragonie dokładnie tak, jak została otrzymana w odpowiedzi API, z zachowaniem prawidłowej liczby miejsc po przecinku.
znaczniki (DCC)
CZ: Dodatek do kursu wymiany. Należy go wyświetlić dokładnie tak, jak pojawia się w odpowiedzi API, łącznie z liczbą miejsc po przecinku.
EN: Oznaczenie współczynnika konwersji. Należy je podać na paragonie dokładnie tak, jak zostało otrzymane w odpowiedzi API, z zachowaniem prawidłowych miejsc po przecinku.
EN: Oznaczenie współczynnika konwersji. Należy je podać na paragonie dokładnie tak, jak zostało otrzymane w odpowiedzi API, z zachowaniem prawidłowych miejsc po przecinku.
regionSchemaIndicator (DCC)
CZ: Wskazuje, czy karta klienta została wydana w UE, czy poza nią. Jeśli wartość wynosi "0" lub "1", na paragonie należy umieścić tekst "Markup". Jeśli wartość wynosi "2", na paragonie należy umieścić tekst "Markup over ECB rate”.
EN: Wskazuje, czy karta klienta została wydana w UE, czy poza nią. Jeśli wartość wynosi "0" lub "1", na paragonie należy umieścić tekst "Markup". Jeśli wartość wynosi "2", na paragonie należy umieścić tekst "Markup powyżej kursu EBC".
EN: Wskazuje, czy karta klienta została wydana w UE, czy poza nią. Jeśli wartość wynosi "0" lub "1", na paragonie należy umieścić tekst "Markup". Jeśli wartość wynosi "2", na paragonie należy umieścić tekst "Markup powyżej kursu EBC".