Upozornění
Pro získání detailu transakce je nutné doptávat se pouze pomocí Inquiry requestu:
TransactionInquire(String transactionId, IInquireResultListener listener) throws RemoteException
Slouží k získání detailů o provedené transakci. Tuto metodu má smysl používat v případě, že byl dokončen předchozí krok – transakce byla dokončena, viz Krok 3: Stav transakce
void TransactionInquire(String transactionId, IInquireResultListener listener) throws RemoteException
Vstupní transaction ID se vygeneruje během prvního kroku, viz Krok 1: Registrace transakce
Zde najdete detaily odpovědi pro transakci:
Pole / Field
result
responseMessage
trasanctionID
transactionType
merchantID
terminalID
currencyCode
amount
tipAmount
cashbackAmount
cardNumber
cardDataEntry
approvedCode
referenceNumber
traceNumber
date
time
emvAppLabel
sequenceNumber
batchNumber
cardProduct
pinOK
merchantInfo
emvAid
cardHolderVerificationMethod
externalTransactionID
totalamount
receiptNumber
blikCode
dccData:
status
amount
currencyCode
exchangeRate
markup
regionSchemaIndicator
Type
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
Volitelné / Optional
No
Yes
Yes
Yes
Yes
Yes
Yes
Yes
Yes
Yes
Yes
Yes
Yes
Yes
Yes
Yes
Yes
Yes
Yes
Yes
Yes
Yes
Yes
Yes
Yes
Yes
Yes
Yes
Yes
Yes
Yes
Yes
Yes
Yes
Yes
Yes
Informace o částce
Formáty jakékoliv částky jsou vždy na 2 desetinná místa *100, což znamená, že např. 50,25 Kč je vyplněno jako 5025 Kč.
Název / Name
Type
Volitelné / Optional
resultCode
Integer
ne
transactionId
String
ano
clientID
String
ano
responseMessage
String
ano
error
ErrorResultEntity
ano
Vysvětlení polí
Field
Popis / Description
result
CZ: Udává výsledek transakce (např. 0 znaměná úspěšná transakce).
EN: Indicates the result of the transaction (e.g. 0 means successful transaction).
EN: Indicates the result of the transaction (e.g. 0 means successful transaction).
responseMessage
CZ: Zobrazuje výsledek transakce z autorizace (např. 201)
EN: Displays the transaction result from authorization (e.g. 201)
EN: Displays the transaction result from authorization (e.g. 201)
transactionID
CZ: Jedinečné ID generované platební aplikací během procesu registrace transakce.
EN: Unique ID generated by payment app during the transaction registration process.
EN: Unique ID generated by payment app during the transaction registration process.
transactionType
CZ: Typ transakce definuje typ transakce, kterou chcete zahájit. Dostupné hodnoty jsou:
1 - Prodej 2 - Storno transakce 4 - Uzávěrka EN: Defines the transaction type. Available values are:
1 - Sale, 2 - Transaction cancellation, 4 - Close batch / Close day
1 - Prodej 2 - Storno transakce 4 - Uzávěrka EN: Defines the transaction type. Available values are:
1 - Sale, 2 - Transaction cancellation, 4 - Close batch / Close day
merchantID
CZ: Jedinečné ID obchodníka, obvykle představuje ID lokality.
EN: Unique merchant ID, usually location ID
EN: Unique merchant ID, usually location ID
terminalID
CZ: ID terminálu, na kterém jsou transakce zpracovávány. Identifikuje terminál v systémech GP.
EN: Unique terminal ID, on which the transaction is processed.
EN: Unique terminal ID, on which the transaction is processed.
currencyCode
CZ: Třímístné kódy ISO měny – seznam najdete na stránce Wiki.
EN: Three chars currency ISO code.
EN: Three chars currency ISO code.
amount
CZ: Částka určuje objem transakce. Tato částka se počítá v domácí měně, kterou používá terminál. U uzávěrky obsahuje všechny karetní transakce, připsané mínus debetní.
EN: The amount determines the volume of the transaction. This amount is calculated in the domestic currency used by the terminal. At close day, it contains all card transactions, credited minus debit.
EN: The amount determines the volume of the transaction. This amount is calculated in the domestic currency used by the terminal. At close day, it contains all card transactions, credited minus debit.
tipAmount
CZ: Spropitné. Vyplněno v případě, že bylo zadáno.
EN: Tip. Filled in if needed.
EN: Tip. Filled in if needed.
cashbackAmount
CZ: Částka cashbacku se vyplní v případě, když se použije cashback transakce.
EN: The cashback amount is filled in when a cashback transaction is used.
EN: The cashback amount is filled in when a cashback transaction is used.
cardNumber
CZ: Číslo karty (PAN). Je přítomen v maskované formě. Příklad: "479608********1859"
EN: Card Number (PAN). It is present in masked form. Example: "479608********1859"
EN: Card Number (PAN). It is present in masked form. Example: "479608********1859"
cardDataEntry
CZ: Identifikuje použitý způsob načtení karty. Možné hodnoty jsou:
MANUAL - ruční zadání
ICC - čip
CTLS - Bezkontaktní
MAG - magnetický proužek.
EN: Identifies used methodfor card read. Possible values:
MANUAL - manual entry
ICC - chip
CTLS - Contactless
MAG - magstripe.
MANUAL - ruční zadání
ICC - čip
CTLS - Bezkontaktní
MAG - magnetický proužek.
EN: Identifies used methodfor card read. Possible values:
MANUAL - manual entry
ICC - chip
CTLS - Contactless
MAG - magstripe.
approvedCode
CZ: Vyplňuje se pouze v případě, že transakce skončí jako schválená.
EN: Is present just if the transaction is processed.
EN: Is present just if the transaction is processed.
referenceNumber
CZ: Referenční číslo zadané při požadavku na platbu.
EN: reference number entered during the payment
EN: reference number entered during the payment
traceNumber
CZ:
date
CZ: Datum, kdy byla transakce zpracována v autorizačním systému.
EN: Date when transaction was processed.
EN: Date when transaction was processed.
time
CZ: Čas, kdy byla transakce zpracována v autorizačním systému.
EN: Time when transaction was processed.
EN: Time when transaction was processed.
emvAid
CZ: Identifikuje aplikaci EMV používanou pro zpracování transakce - např. Visa Debit
EN: Identifies the EMV app used for transaction processing - for instance Visa Debit
EN: Identifies the EMV app used for transaction processing - for instance Visa Debit
emvAppLabel
CZ: Název EMV, které bylo použito při platbě.
EN: card label of used card
EN: card label of used card
sequenceNumber
CZ: Používá se pro storno transakce. Použijte obdrženou hodnotu která byla součástí transakce, kterou chcete zrušit.
EN: Used for transaction cancellation. Used the received value which was a part of transaction you want to cancel.
EN: Used for transaction cancellation. Used the received value which was a part of transaction you want to cancel.
batchNumber
CZ: Identifikuje číslo uzávěrky. Vyplňuje se v případě požadavku na uzávěrku.
EN: Defines batch number. Present during the close batch transaction.
EN: Defines batch number. Present during the close batch transaction.
cardProduct
CZ: Možné hodnoty jsou:
VISA
MASTER
AMEX
DISCOVERY
EN: Possible values:
VISA
MASTER
AMEX
DISCOVERY
VISA
MASTER
AMEX
DISCOVERY
EN: Possible values:
VISA
MASTER
AMEX
DISCOVERY
pinOk
CZ: Znázorňuje zda byl zadán PIN
EN: Shows whether the PIN was entered
true/false
EN: Shows whether the PIN was entered
true/false
merchantInfo
CZ: Ukáže adresní údaje o obchodníkovi.
EN: Shows address of the merchant.
EN: Shows address of the merchant.
cardHolderVerificationMethod
CZ: Zobrazí ověření držitele platební karty, přes kterou se platilo (Pin, Žádné).
EN: Shows verification method of the card holder (Pin, None).
EN: Shows verification method of the card holder (Pin, None).
externalTransactionID
CZ: Identifikační číslo transakce v aplikaci Genius mobile pay
EN: Transaction identification number in the Genius mobile pay application
EN: Transaction identification number in the Genius mobile pay application
totalAmount
CZ: Celková částka včetně spropitného, která byla zaplacena.
EN: Whole amount which was paid included tip.
EN: Whole amount which was paid included tip.
receiptNumber
CZ: Identifikační číslo účtenky
EN: Receipt identification number
EN: Receipt identification number
blikCode
CZ: Šestimístný číselný kód, který se zadává před provedením platby.
EN: A six-digit numerical code that must be entered before making a payment.
EN: A six-digit numerical code that must be entered before making a payment.
status (DCC)
CZ: Udává status DCC. Pokud "ACCEPTED", tak transakce proběhla přes DCC a musíte naplnit účtenku DCC daty. Pokud "NOT_ACCEPTED", tak v tom případě můžete DCC data ignorovat.
EN: Indicates the DCC status. If "ACCEPTED", the transaction was made via DCC and you must fill in the receipt with DCC data. If "NOT_ACCEPTED", then you can ignore the DCC data.
EN: Indicates the DCC status. If "ACCEPTED", the transaction was made via DCC and you must fill in the receipt with DCC data. If "NOT_ACCEPTED", then you can ignore the DCC data.
amount (DCC)
CZ: Částka transakce v DCC měně - v měně karty zákazníka. Je potřeba ji zobrazit přesně tak jak přijde v API odpovědi včetně počtu desetinných míst.
EN: Transaction amount in DCC currency - in the currency of the customer's card. You must present it on your receipt exactly as received through API response including correct decimal numbers.
EN: Transaction amount in DCC currency - in the currency of the customer's card. You must present it on your receipt exactly as received through API response including correct decimal numbers.
currencyCode (DCC)
CZ: Měna zákaznické karty.
EN: Currency of the customer's card.
EN: Currency of the customer's card.
exchangeRate (DCC)
CZ: Udává směnný kurz. Tato hodnota je v lokální měně terminálu. Je potřeba ji zobrazit přesně tak jak přijde v API odpovědi včetně počtu desetinných míst.
EN: Indicates the exchange rate. This value is in the local terminal currency. You must present it on your receipt exactly as received through API response including correct decimal numbers.
EN: Indicates the exchange rate. This value is in the local terminal currency. You must present it on your receipt exactly as received through API response including correct decimal numbers.
markup (DCC)
CZ: Přirážka ke konverznímu kurzu. Je potřeba ji zobrazit přesně tak jak přijde v API odpovědi včetně počtu desetinných míst.
EN: Markup for the conversion rate. You must present it on your receipt exactly as received through API response including correct decimal numbers.
EN: Markup for the conversion rate. You must present it on your receipt exactly as received through API response including correct decimal numbers.
regionSchemaIndicator (DCC)
CZ: Udává, zda karta zákazníka byla vydaná v rámci EU nebo mimo. Pokud je hodnota "0" nebo 1", je potřeba na účtence zobrazit text "Markup". Pokud je hodnota "2", je potřeba na účtence zobrazit "Markup over ECB rate".
EN: Indicates whether the customer's card was issued within the EU or outside. If the value is "0" or "1", the text "Markup" needs to be displayed on the receipt. If the value is "2", the text "Markup over ECB rate" needs to be displayed on the receipt.
EN: Indicates whether the customer's card was issued within the EU or outside. If the value is "0" or "1", the text "Markup" needs to be displayed on the receipt. If the value is "2", the text "Markup over ECB rate" needs to be displayed on the receipt.
Zde najdete příklad odpovědi pro Inquiry po provedení uzávěrky:
{
"batchDetails": {
"amsBatchNumber": "7576f3de-f4d5-41df-9b93-ff666e18819e",
"batchId": "81",
"communicationId": "BA331935",
"currency": "CZK",
"date": "2026-10-05T18:55:06.003Z",
"firstTransactionDate": "2026-10-05T18:54:14.014Z",
"previousBatchDate": "2026-10-05T14:04:47.304Z",
"saleAmount": 71,
"saleCount": 3,
"subBatches": {
"accountPayment": {
"saleAmount": 0,
"saleCount": 0,
"totalCount": 0,
"voidAmount": 0,
"voidCount": 0
},
"blikPayment": {
"saleAmount": 0,
"saleCount": 0,
"totalCount": 0,
"voidAmount": 0,
"voidCount": 0
},
"card": {
"saleAmount": 10,
"saleCount": 1,
"totalCount": 2,
"voidAmount": 2,
"voidCount": 1
},
"cash": {
"saleAmount": 61,
"saleCount": 2,
"totalCount": 2,
"voidAmount": 0,
"voidCount": 0
},
"paymentGateway": {
"saleAmount": 0,
"saleCount": 0,
"totalCount": 0,
"voidAmount": 0,
"voidCount": 0
}
},
"tipAmount": 1.00,
"tipAverage": 1.00,
"tipCount": 1,
"totalAmount": 69,
"totalCount": 4,
"voidAmount": 2,
"voidCount": 1
},
"currencyCode": "CZK",
"date": "261005",
"merchantID": "000000400900025",
"merchantInfo": {
"city": "Praha 10",
"company": "Global Payments Europe s.r.o.",
"house": "82/626",
"street": "V Olšinách",
"zip": "10000"
},
"responseMessage": "APPROVED",
"result": 0,
"terminalID": "00599617",
"time": "205506",
"transacitonType": 0,
"trasanctionID": "7576f3de-f4d5-41df-9b93-ff666e18819e",
"amount": "69"
}