Upozornenie
Na získanie podrobností o transakcii je potrebné zaslať žiadosť výlučne prostredníctvom žiadosti o informácie (Inquiry request):
TransactionInquire(String transactionId, IInquireResultListener listener) throws RemoteException
Slúži na získanie podrobností o vykonanej transakcii. Túto metódu má zmysel použiť v prípade, že bol dokončený predchádzajúci krok – transakcia bola dokončená, pozri Krok 3: Stav transakcie
void TransactionInquire(String transactionId, IInquireResultListener listener) throws RemoteException
Identifikátor vstupnej transakcie sa vygeneruje v prvom kroku, pozri Krok 1: Registrácia transakcie
Pole / Pole
výsledok
odpoveďová správa
trasanctionID
typ transakcie
merchantID
ID terminálu
kód meny
suma
tipAmount
cashbackAmount
číslo karty
vstup údajov z karty
approvedCode
referenčné číslo
traceNumber
dátum
čas
emvAppLabel
číslo sekvencie
číslo šarže
cardProduct
pinOK
merchantInfo
emvAid
metóda overovania držiteľa karty
externalTransactionID
celková suma
číslo potvrdenia
blikCode
dccData:
stav
suma
kód meny
kurz
značkovací jazyk
regionSchemaIndicator
Typ
Celé číslo
Reťazec
Reťazec
Celé číslo
Reťazec
Reťazec
Reťazec
Reťazec
Reťazec
Reťazec
Reťazec
Reťazec
Reťazec
Reťazec
Reťazec
Reťazec
Reťazec
Reťazec
Reťazec
Reťazec
Reťazec
Reťazec
Reťazec
Reťazec
Reťazec
Celé číslo
Celé číslo
Celé číslo
Celé číslo
Reťazec
Reťazec
Reťazec
Reťazec
Reťazec
Reťazec
Voliteľné / Optional
No
Áno
Áno
Áno
Áno
Áno
Áno
Áno
Áno
Áno
Áno
Áno
Áno
Áno
Áno
Áno
Áno
Áno
Áno
Áno
Áno
Áno
Áno
Áno
Áno
Áno
Áno
Áno
Áno
Áno
Áno
Áno
Áno
Áno
Áno
Áno
Informácie o sume
Akékoľvek sumy sa vždy uvádzajú s presnosťou na 2 desatinné miesta *100, čo znamená, že napr. 50,25 Kč sa vyplní ako 5025 Kč.
Názov / Name
Typ
Voliteľné / Optional
resultCode
Celé číslo
Nie
transactionId
Reťazec
áno
ID klienta
Reťazec
áno
odpoveďová správa
Reťazec
áno
chyba
Entita výsledku chyby
áno
Vysvetlenie polí
Pole
Popis / Popis
výsledok
CZ: Uvádza výsledok transakcie (napr. 0 znamená úspešnú transakciu).
EN: Označuje výsledok transakcie (napr. 0 znamená úspešnú transakciu).
EN: Označuje výsledok transakcie (napr. 0 znamená úspešnú transakciu).
odpoveďová správa
CZ: Zobrazuje výsledok transakcie z autorizácie (napr. 201)
EN: Zobrazuje výsledok transakcie z autorizácie (napr. 201)
EN: Zobrazuje výsledok transakcie z autorizácie (napr. 201)
transactionID
SK: Jedinečné identifikačné číslo vygenerované platobnou aplikáciou počas procesu registrácie transakcie.
EN: Jedinečné identifikačné číslo vygenerované platobnou aplikáciou počas procesu registrácie transakcie.
EN: Jedinečné identifikačné číslo vygenerované platobnou aplikáciou počas procesu registrácie transakcie.
typ transakcie
CZ: Typ transakcie definuje typ transakcie, ktorú chcete začať. K dispozícii sú nasledujúce hodnoty:
1 – Predaj 2 – Storno transakcie 4 – Uzávierka EN: Určuje typ transakcie. K dispozícii sú nasledujúce hodnoty:
1 – Predaj, 2 – Zrušenie transakcie, 4 – Ukončenie dávky / Ukončenie dňa
1 – Predaj 2 – Storno transakcie 4 – Uzávierka EN: Určuje typ transakcie. K dispozícii sú nasledujúce hodnoty:
1 – Predaj, 2 – Zrušenie transakcie, 4 – Ukončenie dávky / Ukončenie dňa
merchantID
SK: Jedinečné ID obchodníka, zvyčajne ide o ID lokality.
EN: Jedinečné identifikačné číslo obchodníka, zvyčajne identifikačné číslo lokality
EN: Jedinečné identifikačné číslo obchodníka, zvyčajne identifikačné číslo lokality
ID terminálu
SK: ID terminálu, na ktorom sa transakcie spracúvajú. Identifikuje terminál v systémoch GP.
EN: Jedinečné identifikačné číslo terminálu, na ktorom sa transakcia spracováva.
EN: Jedinečné identifikačné číslo terminálu, na ktorom sa transakcia spracováva.
kód meny
SK: Trojmiestne kódy mien ISO – zoznam nájdete na stránke Wiki.
EN: Trojznakový kód meny podľa ISO.
EN: Trojznakový kód meny podľa ISO.
suma
SK: Suma určuje objem transakcie. Táto suma sa počíta v domácej mene, ktorú používa terminál. Pri uzávierke zahŕňa všetky kartové transakcie, a to pripísané mínus debetné.
EN: Táto suma určuje objem transakcie. Vypočíta sa v domácej mene, ktorú používa terminál. Na konci dňa zahŕňa všetky transakcie kartou, pričom sa odpočítavajú debetné transakcie od kreditných.
EN: Táto suma určuje objem transakcie. Vypočíta sa v domácej mene, ktorú používa terminál. Na konci dňa zahŕňa všetky transakcie kartou, pričom sa odpočítavajú debetné transakcie od kreditných.
tipAmount
SK: Spropitné. Vyplní sa v prípade, ak bolo zadané.
EN: Tip. Vyplňte v prípade potreby.
EN: Tip. Vyplňte v prípade potreby.
cashbackAmount
CZ: Čiastka cashbacku sa vyplní v prípade, ak sa použije transakcia s cashbackom.
EN: Suma cashbacku sa vyplní pri použití transakcie s cashbackom.
EN: Suma cashbacku sa vyplní pri použití transakcie s cashbackom.
číslo karty
CZ: Číslo karty (PAN). Je uvedené v zakrytej podobe. Príklad: "479608********1859"
EN: Číslo karty (PAN). Je uvedené v maskovanej podobe. Príklad: "479608********1859"
EN: Číslo karty (PAN). Je uvedené v maskovanej podobe. Príklad: "479608********1859"
vstup údajov z karty
CZ: Určuje použitý spôsob čítania karty. Možné hodnoty sú:
MANUAL – ručné zadanie
ICC – čip
CTLS – bezkontaktné
MAG – magnetický prúžok.
EN: Identifikuje použitý spôsob načítania karty. Možné hodnoty:
MANUAL – ručné zadanie
ICC – čip
CTLS – bezkontaktné
MAG – magnetický prúžok.
MANUAL – ručné zadanie
ICC – čip
CTLS – bezkontaktné
MAG – magnetický prúžok.
EN: Identifikuje použitý spôsob načítania karty. Možné hodnoty:
MANUAL – ručné zadanie
ICC – čip
CTLS – bezkontaktné
MAG – magnetický prúžok.
approvedCode
SK: Vyplňuje sa len v prípade, ak transakcia skončí ako schválená.
EN: Je prítomný práve vtedy, ak je transakcia spracovaná.
EN: Je prítomný práve vtedy, ak je transakcia spracovaná.
referenčné číslo
SK: Referenčné číslo uvedené v žiadosti o platbu.
EN: referenčné číslo zadané pri platbe
EN: referenčné číslo zadané pri platbe
traceNumber
CZ:
dátum
CZ: Dátum, kedy bola transakcia spracovaná v autorizačnom systéme.
EN: Dátum spracovania transakcie.
EN: Dátum spracovania transakcie.
čas
CZ: Čas, kedy bola transakcia spracovaná v autorizačnom systéme.
EN: Čas spracovania transakcie.
EN: Čas spracovania transakcie.
emvAid
CZ: Identifikuje aplikáciu EMV použitú na spracovanie transakcie – napr. Visa Debit
EN: Identifikuje aplikáciu EMV používanú na spracovanie transakcií – napríklad Visa Debit
EN: Identifikuje aplikáciu EMV používanú na spracovanie transakcií – napríklad Visa Debit
emvAppLabel
SK: Názov karty EMV, ktorá bola použitá pri platbe.
EN: štítok použitej karty
EN: štítok použitej karty
číslo sekvencie
SK: Používa sa na zrušenie transakcie. Použite hodnotu, ktorú ste dostali a ktorá bola súčasťou transakcie, ktorú chcete zrušiť.
EN: Slúži na zrušenie transakcie. Použite prijatú sumu, ktorá bola súčasťou transakcie, ktorú chcete zrušiť.
EN: Slúži na zrušenie transakcie. Použite prijatú sumu, ktorá bola súčasťou transakcie, ktorú chcete zrušiť.
číslo šarže
SK: Identifikuje číslo uzávierky. Vyplňuje sa v prípade požiadavky na uzávierku.
EN: Určuje číslo šarže. Zadáva sa pri transakcii uzavretia šarže.
EN: Určuje číslo šarže. Zadáva sa pri transakcii uzavretia šarže.
cardProduct
CZ: Možné hodnoty sú:
VISA
MASTER
AMEX
DISCOVERY
EN: Možné hodnoty:
VISA
MASTER
AMEX
DISCOVERY
VISA
MASTER
AMEX
DISCOVERY
EN: Možné hodnoty:
VISA
MASTER
AMEX
DISCOVERY
pinOk
CZ: Ukazuje, či bol zadaný PIN
EN: Ukazuje, či bol zadaný PIN
pravda/nepravda
EN: Ukazuje, či bol zadaný PIN
pravda/nepravda
merchantInfo
CZ: Zobrazí kontaktné údaje o predajcovi.
EN: Zobrazuje adresu predajcu.
EN: Zobrazuje adresu predajcu.
metóda overovania držiteľa karty
CZ: Zobrazí overenie držiteľa platobnej karty, prostredníctvom ktorej sa platilo (PIN, Žiadne).
EN: Zobrazuje spôsob overenia držiteľa karty (PIN, žiadny).
EN: Zobrazuje spôsob overenia držiteľa karty (PIN, žiadny).
externalTransactionID
CZ: Identifikačné číslo transakcie v aplikácii GP tom
EN: Identifikačné číslo transakcie v aplikácii GP tom
EN: Identifikačné číslo transakcie v aplikácii GP tom
celková suma
CZ: Celková suma vrátane spropitného, ktorá bola zaplatená.
EN: Celková suma, ktorá bola zaplatená, zahŕňala aj spropitné.
EN: Celková suma, ktorá bola zaplatená, zahŕňala aj spropitné.
číslo potvrdenia
CZ: Identifikačné číslo účtenky
EN: Identifikačné číslo dokladu
EN: Identifikačné číslo dokladu
blikCode
CZ: Šesťmiestny číselný kód, ktorý sa zadáva pred vykonaním platby.
EN: Šesťmiestny číselný kód, ktorý je potrebné zadať pred vykonaním platby.
EN: Šesťmiestny číselný kód, ktorý je potrebné zadať pred vykonaním platby.
stav (DCC)
SK: Uvádza stav DCC. Ak je stav "ACCEPTED", transakcia prebehla cez DCC a musíte vyplniť údaje DCC na účtenke. Ak je stav "NOT_ACCEPTED", v takom prípade môžete údaje DCC ignorovať.
EN: Uvádza stav DCC. Ak je stav "ACCEPTED", transakcia bola vykonaná prostredníctvom DCC a do potvrdenia je potrebné vyplniť údaje DCC. Ak je stav "NOT_ACCEPTED", údaje DCC môžete ignorovať.
EN: Uvádza stav DCC. Ak je stav "ACCEPTED", transakcia bola vykonaná prostredníctvom DCC a do potvrdenia je potrebné vyplniť údaje DCC. Ak je stav "NOT_ACCEPTED", údaje DCC môžete ignorovať.
suma (DCC)
SK: Suma transakcie v mene DCC – v mene karty zákazníka. Je potrebné ju zobraziť presne tak, ako je uvedená v odpovedi API, vrátane počtu desatinných miest.
EN: Suma transakcie v mene DCC – v mene karty zákazníka. Na potvrdení ju musíte uviesť presne tak, ako ste ju dostali v odpovedi API, vrátane správnych desatinných miest.
EN: Suma transakcie v mene DCC – v mene karty zákazníka. Na potvrdení ju musíte uviesť presne tak, ako ste ju dostali v odpovedi API, vrátane správnych desatinných miest.
kód meny (DCC)
SK: Mena zákazníckej karty.
EN: Mena karty zákazníka.
EN: Mena karty zákazníka.
výmenný kurz (DCC)
SK: Uvádza výmenný kurz. Táto hodnota je v miestnej mene terminálu. Je potrebné ju zobraziť presne tak, ako je uvedená v odpovedi API, vrátane počtu desatinných miest.
EN: Uvádza výmenný kurz. Táto hodnota je vyjadrená v miestnej mene terminálu. Na potvrdení ju musíte uviesť presne tak, ako ste ju dostali v odpovedi API, vrátane správneho počtu desatinných miest.
EN: Uvádza výmenný kurz. Táto hodnota je vyjadrená v miestnej mene terminálu. Na potvrdení ju musíte uviesť presne tak, ako ste ju dostali v odpovedi API, vrátane správneho počtu desatinných miest.
značkovací jazyk (DCC)
SK: Prirážka k konverznému kurzu. Je potrebné ju zobraziť presne tak, ako je uvedená v odpovedi API, vrátane počtu desatinných miest.
EN: Údaj o konverznej sadzbe. Na účtenke ho musíte uviesť presne tak, ako ste ho dostali v odpovedi API, vrátane správnych desatinných miest.
EN: Údaj o konverznej sadzbe. Na účtenke ho musíte uviesť presne tak, ako ste ho dostali v odpovedi API, vrátane správnych desatinných miest.
regionSchemaIndicator (DCC)
CZ: Uvádza, či bola zákaznícka karta vydaná v rámci EÚ alebo mimo nej. Ak je hodnota "0" alebo "1", na účtenke sa musí zobraziť text "Markup". Ak je hodnota "2", na účtenke sa musí zobraziť "Markup over ECB rate“.
EN: Uvádza, či bola karta zákazníka vydaná v rámci EÚ alebo mimo nej. Ak je hodnota "0" alebo "1", na účtenke sa musí zobraziť text "Prirážka". Ak je hodnota "2", na účtenke sa musí zobraziť text "Prirážka nad kurzom ECB".
EN: Uvádza, či bola karta zákazníka vydaná v rámci EÚ alebo mimo nej. Ak je hodnota "0" alebo "1", na účtenke sa musí zobraziť text "Prirážka". Ak je hodnota "2", na účtenke sa musí zobraziť text "Prirážka nad kurzom ECB".