Transactions
Read what happened on a card and correct it — transaction history, pending provisions, reversals and slip receipts.
getAuthorizationListByBegindateEnddate
Retrieves authorization list for a customer between given dates.
Headers
evrst-ptrnidCorrelation id for this request. Echo it in your own logs to trace the call through the platform.
getAuthorizationListByBegindateEnddate › Request Body
The search itself. The request body carries a single object, named after the query behind it, and its fields are the criteria.
getAuthorizationListByBegindateEnddate › Responses
Success
getPddtransactionByCardrefCustomernum
Retrieves PDD transactions by card reference and customer number.
Headers
evrst-ptrnidCorrelation id for this request. Echo it in your own logs to trace the call through the platform.
getPddtransactionByCardrefCustomernum › Request Body
The search itself. The request body carries a single object, named after the query behind it, and its fields are the criteria.
getPddtransactionByCardrefCustomernum › Responses
Success
getPrepaidTransactionAll
Retrieves all prepaid transactions for a card or customer.
Headers
evrst-ptrnidCorrelation id for this request. Echo it in your own logs to trace the call through the platform.
getPrepaidTransactionAll › Request Body
beginDateA date and time as a string, in RFC 3339 form: 2026-10-16T14:30:00Z, or with an offset, 2026-10-16T17:30:00+03:00.
endDateA date and time as a string, in RFC 3339 form: 2026-10-16T14:30:00Z, or with an offset, 2026-10-16T17:30:00+03:00.
shadowCardNumberThe platform's own handle for a card, and the identifier most operations take. It is returned by every operation that creates a card and by the card listings; a caller does not compose one.
responseCodeThe downstream system's own result code, passed through. 00 and 0 are success; anything else is its refusal, and responseReasonCode or the description says which.
Comes back from the transaction services; no column behind this API holds it.
responseReasonCodeWhy the downstream system answered as it did, where it narrows the response code.
Comes back from the transaction services; no column behind this API holds it.
networkTypeResolved by the transaction services. A column of this name exists on the operation limit tables, which this operation does not read, so its five characters are not published here.
Values:
O— on-usD— domestic, through BKMM— MastercardV— Visa
trnCodeMatrixIdWhich row of the transaction-code matrix this transaction was classified by.
Resolved by the transaction services. A column of this name exists on the digital receipt tables, which this operation does not read.
maxAmountThe upper bound on the transaction amount.
minAmountThe lower bound on the transaction amount.
getPrepaidTransactionAll › Responses
Success
totalAmountThe amount of every entry in the list added together.
The transactions the search matched.
getPrepaidTransactionByUtid
Retrieves a prepaid transaction by UTID.
Headers
evrst-ptrnidCorrelation id for this request. Echo it in your own logs to trace the call through the platform.
getPrepaidTransactionByUtid › Request Body
utidThe unique transaction identifier the platform gives a transaction, and the handle every later operation on it takes. Returned by the transaction listings.
getPrepaidTransactionByUtid › Responses
Success
cardProductVirtualFlagWhether the product is a virtual one.
cardProductDigitalFlagWhether the product can be issued digitally.
terminalNumberThe terminal the transaction was made at.
authorizationNumberThe authorisation code the issuer returned when the transaction was approved. Six characters, from the scheme.
authorizationMatchStatusWhether the clearing record was matched to an authorisation.
cardRefNumberThe card reference, which identifies one issued card including its renewals. Returned by the create and listing operations alongside the shadow number.
cardSeqNumberWhich chip on the card was used, where a customer holds more than one card on the same number.
channelTypeDescriptionThe description of channelType, carried alongside it for display. It is not a key: match on the code.
customercustomerNumberThe customer at the bank's core banking system, as a number. The platform stores it rather than issuing it, so it comes from the core.
isChipFlagWhether the card's chip was used rather than the stripe.
localAmountThe amount converted into the bank's own currency.
localCurrencyDescriptionThe description of localCurrencyCode, carried alongside it for display. It is not a key: match on the code.
mainCustomerNumberThe main customer of a corporate relationship, as a number. The employees and supplementary holders under it carry their own customerNumber.
maskedCardNumberThe card number with its middle digits masked, as the platform stores it. It is a display form, not a key.
matchStatusDescriptionmccDescriptionThe description of mcc, carried alongside it for display. It is not a key: match on the code.
merchantCountryCodeWhere the merchant is, as a country code.
merchantNameThe merchant's name as it reached the platform from the scheme.
networkTypeDescriptionofflineFlagWhether the terminal approved the transaction without asking the issuer.
panEntryModeHow the card was read at the terminal — chip, stripe, contactless, keyed, or stored on file. The scheme's own code.
pinUsageWhether the transaction was authorised with a PIN.
responseCodeDescriptionresponseReasonCodeDescriptionrrnThe retrieval reference number — the card scheme's handle for the transaction, and what a bank quotes when asking the scheme about it.
settlementAmountThe amount as it settles between the scheme and the bank.
settlementCurrencyDescriptionterminalTypeWhat kind of terminal that was — POS, ATM, or another.
transactionDateA date and time as a string, in RFC 3339 form: 2026-10-16T14:30:00Z, or with an offset, 2026-10-16T17:30:00+03:00.
trnAmountThe amount of the transaction, in its own currency.
trnCodeMatrixDescriptionThe description of trnCodeMatrixId, carried alongside it for display. It is not a key: match on the code.
trnCurrencyDescriptionThe description of trnCurrencyCode, carried alongside it for display. It is not a key: match on the code.
trnStatusDescriptionutidThe unique transaction identifier the platform gives a transaction, and the handle every later operation on it takes. Returned by the transaction listings.
trnEffectWhether the transaction adds to the balance or takes from it.
channelTypeWhich channel the row applies to.
capitalRewardIndicatorWhether the reward counts towards the capital scheme.
trnCurrencyCodeThe currency the transaction was made in.
transactionDescriptionWhat the transaction earned.
trnCodeMatrixIdWhich row of the transaction-code matrix this transaction was classified by.
shadowCardNumberThe platform's own handle for a card, and the identifier most operations take. It is returned by every operation that creates a card and by the card listings; a caller does not compose one.
mainCardRefNumberThe card reference of the main card. On a supplementary card this is the card it hangs from; on a main card it is the card's own reference.
mccThe merchant category code — the four-digit code the scheme classifies the merchant's trade with.
mccGroupCodeWhich group of merchant categories the merchant falls in.
localCurrencyCodeThe bank's own currency, which localAmount is in.
getDigitalSlipReceipt
Retrieves digital slip receipts for prepaid transactions.
Headers
evrst-ptrnidCorrelation id for this request. Echo it in your own logs to trace the call through the platform.
getDigitalSlipReceipt › Request Body
channelThree-digit code identifying the channel on behalf of which the request is made (e.g. 002 for Internet). Mandatory in every request. Used for entitlement checks, limit enforcement and audit logging. Channel codes are managed through configuration parameters and may change over time. Refer to the Channels page for the current list of valid codes.
utidThe unique transaction identifier the platform gives a transaction, and the handle every later operation on it takes. Returned by the transaction listings.
getDigitalSlipReceipt › Responses
Success
utidThe unique transaction identifier the platform gives a transaction, and the handle every later operation on it takes. Returned by the transaction listings.
refUtidThe transaction this one refers to — the original, for a reversal or a correction.
trnCodeMatrixIdWhich row of the transaction-code matrix this transaction was classified by.
shadowCardNumberThe platform's own handle for a card, and the identifier most operations take. It is returned by every operation that creates a card and by the card listings; a caller does not compose one.
cardRefNumberThe card reference, which identifies one issued card including its renewals. Returned by the create and listing operations alongside the shadow number.
maskedCardNumberThe card number with its middle digits masked, as the platform stores it. It is a display form, not a key.
trnAmountThe amount of the transaction, in its own currency.
trnCurrencyCodeThe currency the transaction was made in.
responseCodeThe downstream system's own result code, passed through. 00 and 0 are success; anything else is its refusal, and responseReasonCode or the description says which.
trnDatetimeA date and time as a string, in RFC 3339 form: 2026-10-16T14:30:00Z, or with an offset, 2026-10-16T17:30:00+03:00.
trnStatusWhere the transaction has got to.
stanThe system trace audit number — the scheme's sequence number for the message, unique within a day and a terminal.
rrnThe retrieval reference number — the card scheme's handle for the transaction, and what a bank quotes when asking the scheme about it.
authorizationNumberThe authorisation code the issuer returned when the transaction was approved. Six characters, from the scheme.
terminalNumberThe terminal the transaction was made at.
merchantNumberThe merchant's number with the acquirer.
merchantNameThe merchant's name as it reached the platform from the scheme.
panEntryModeHow the card was read at the terminal — chip, stripe, contactless, keyed, or stored on file. The scheme's own code.
iccData84iccData9f26cardSeqNumberWhich chip on the card was used, where a customer holds more than one card on the same number.
merchantAddressThe merchant's address as it reached the platform.