Notice
To get the details of a transaction, you only need to query using an Inquiry request:
TransactionInquire(String transactionId, IInquireResultListener listener) throws RemoteException
It is used to get details about the transaction. It makes sense to use this method if the previous step has been completed - the transaction has been completed, see Step 3: Transaction status
void TransactionInquire(String transactionId, IInquireResultListener listener) throws RemoteException
The input transaction ID is generated during the first step, see Step 1: Register the transaction
Field / 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
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
Optional
From
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
Information about the amount
Formats of any amount are always to 2 decimal places *100, which means that e.g. 50,25 CZK is filled as 5025 CZK.
Name / Name
Type
Optional
resultCode
Integer
No
transactionId
String
Yes
clientID
String
Yes
responseMessage
String
Yes
error
ErrorResultEntity
Yes
Explanation of fields
Field
Description / Description
result
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).
EN: Indicates the result of the transaction (e.g. 0 means successful transaction).
responseMessage
CZ: Displays the transaction result from the authorization (e.g. 201)
EN: Displays the transaction result from authorization (e.g. 201)
EN: Displays the transaction result from authorization (e.g. 201)
transactionID
CZ: Unique ID generated by the payment application during the transaction registration process.
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
EN: Transaction type defines the type of transaction you want to initiate. The available values are:
1 - Sale 2 - Cancel transaction 4 - Closing EN: Defines the transaction type. Available values are:
1 - Sale, 2 - Transaction cancellation, 4 - Close batch / Close day
1 - Sale 2 - Cancel transaction 4 - Closing EN: Defines the transaction type. Available values are:
1 - Sale, 2 - Transaction cancellation, 4 - Close batch / Close day
merchantID
CZ: Unique merchant ID, usually representing a location ID.
EN: Unique merchant ID, usually location ID
EN: Unique merchant ID, usually location ID
terminalID
CZ: ID of the terminal on which the transactions are processed. Identifies the terminal in GP systems.
EN: Unique terminal ID, on which the transaction is processed.
EN: Unique terminal ID, on which the transaction is processed.
currencyCode
CZ: Three-digit ISO currency codes - see the Wiki page for a list.
EN: Three chars currency ISO code.
EN: Three chars currency ISO code.
amount
CZ: The amount determines the volume of the transaction. This amount is calculated in the domestic currency used by the terminal. For a closing, it includes all card transactions, credited minus debited.
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: Tips. Filled in if it has been entered.
EN: Tip. Filled in if needed.
EN: Tip. Filled in if needed.
cashbackAmount
CZ: 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.
EN: The cashback amount is filled in when a cashback transaction is used.
cardNumber
CZ: 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"
EN: Card Number (PAN). It is present in masked form. Example: "479608********1859"
cardDataEntry
CZ: Identifies the method used to load the card. Possible values are:
MANUAL - manual input
ICC - chip
CTLS - Contactless
MAG - magnetic strip.
EN: Identifies used methodfor card read. Possible values:
MANUAL - manual entry
ICC - chip
CTLS - Contactless
MAG - magstripe.
MANUAL - manual input
ICC - chip
CTLS - Contactless
MAG - magnetic strip.
EN: Identifies used methodfor card read. Possible values:
MANUAL - manual entry
ICC - chip
CTLS - Contactless
MAG - magstripe.
approvedCode
CZ: To be filled in only if the transaction ends up being approved.
EN: Is present just if the transaction is processed.
EN: Is present just if the transaction is processed.
referenceNumber
CZ: Reference number entered when requesting payment.
EN: reference number entered during the payment
EN: reference number entered during the payment
traceNumber
CZ:
date
CZ: The date on which the transaction was processed in the authorisation system.
EN: Date when transaction was processed.
EN: Date when transaction was processed.
time
CZ: Time when the transaction was processed in the authorization system.
EN: Time when transaction was processed.
EN: Time when transaction was processed.
emvAid
CZ: Identifies the EMV application used to process the transaction - e.g. 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: The name of the EMV that was used in the payment.
EN: card label of used card
EN: card label of used card
sequenceNumber
CZ: Used for cancellation transactions. Use the received value that was part of the transaction you want to cancel.
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: Identifies the closing number. To be filled in if a deadline is requested.
EN: Defines batch number. Present during the close batch transaction.
EN: Defines batch number. Present during the close batch transaction.
cardProduct
CZ: Possible values are:
VISA
MASTER
AMEX
DISCOVERY
EN: Possible values:
VISA
MASTER
AMEX
DISCOVERY
VISA
MASTER
AMEX
DISCOVERY
EN: Possible values:
VISA
MASTER
AMEX
DISCOVERY
pinOk
CZ: Shows whether a PIN has been entered
EN: Shows whether the PIN was entered
true/false
EN: Shows whether the PIN was entered
true/false
MerchantInfo
CZ: Shows the address details of the merchant.
EN: Shows address of the merchant.
EN: Shows address of the merchant.
cardHolderVerificationMethod
CZ: Displays the verification of the cardholder of the payment card used to make the payment (Pin, None).
EN: Shows verification method of the card holder (Pin, None).
EN: Shows verification method of the card holder (Pin, None).
externalTransactionID
CZ: Transaction identification number in GP tom
EN: Transaction identification number in the GP tom application
EN: Transaction identification number in the GP tom application
totalAmount
CZ: The total amount, including tip, that has been paid.
EN: Whole amount which was paid included tip.
EN: Whole amount which was paid included tip.
receiptNumber
CZ: Receipt identification number
EN: Receipt identification number
EN: Receipt identification number
blikCode
CZ: A six-digit numeric code that is entered before payment is made.
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.