Skip to main content

Method transaction-info

URL: GET - /partner/transaction

The method allows you to get information about a transaction by the transaction ID or by the partner request ID.

Header parameters

ParameterTypeDescription
client-id *authorizationUnique Partner ID
client-secret *authorizationUnique authentication key for VIA API

Request parameters

ParameterTypeDescription
transactionIdstringTransaction ID
externalIdstringUnique Partner Request ID

Request sample

curl GET '/partner/transaction?transactionId=trx_2TEt8TonK6VhrewD78Wv0QXuZEQ' \
--header 'client-id: system' \
--header 'client-secret: system123'

Response parameters

ParameterTypeDescription
dataobjectResponse data object
transactionIdobjectTransaction ID
notestringNotes, remarks, etc.
externalIdstringUnique Partner Request ID
processPayerTransactionIdstringSender's processing system transaction identifier
processReceiverTransactionIdstringReceiver's processing system transaction ID
merchantIdstringVIA Merchant ID
statusstringTransaction status:
«SUCCESS» - Successful
«ERROR» - Error
«REJECT» - Refused
«PENDING» - Pending
«NEW» - New
«DRAFT» - Draft
amountintegerTransfer amount in cents (1/100 part of the base currency unit)
feeintegerCommission amount in cents (1/100 part of the base currency unit)
feePercentlongCommission amount as a percentage
currencystringCurrency:
«UZS» - Uzbek sum
errorCodestringError code
errorMessagestringDescription of the error
refundedAmountintegerRefund amount in cents (1/100 part of the base currency unit)
modifiedAtintegerTransaction update date and time in Unix Timestamp format
createdAtintegerDate and time the transaction was created in Unix Timestamp format
payedAtintegerPayment date and time in Unix Timestamp format
processstringProcessing type
«UZCARD»
«HUMO»
eposobjectEPOS system data object
epos.merchantIdstringMerchant ID
epos.terminalIdstringTerminal ID

Example response if successful

{
"data": {
"transactionId": "trx_2TEt8TonK6VhrewD78Wv0QXuZEQ",
"note": «sample request»,
"externalId": "trx_2TEt8TonK6VhrewD78Wv0QXuZEQ",
"processPayerTransactionId": "bw_2TEt8UFOloG4VZevOGT4OQThhuF",
"processReceiverTransactionId": "trx_2isdflkUHuh98237KJhw87",
"merchantId": "terrx_2TEt8TonK6VhrewD78Wv0QXu",
"status": "SUCCESS",
"amount": 100000,
"fee": 0,
"feePercent": 0,
"currency": "UZS",
"errorCode": "",
"errorMessage": "",
"refundedAmount": 0,
"modifiedAt": 0,
"createdAt": 0,
"payedAt": 0,
"process": "UZCARD",
"epos": {
"merchantId": "trx_2TEt8TonK6VhrewD78Wv0QXuZEQ",
"terminalId": "trx_2TEt8TonK6VhrewD78Wv0QXuZEQ"
}
}
}

Example response in case of error

{
"status": {
"code": "1234",
"message": "Error while executing the request"
},
"error": {
"path": "URL Path",
"message": {
"uz": "Error message in Uzbek",
"ru": "Error message in Russian",
"en": "Error message in English"
}
}
}