Transactions
Read what happened on a card and correct it — transaction history, pending provisions, reversals and slip receipts.
getDebitCardTransactionByUtid
Retrieves a debit card transaction by UTID. Resolves shadow card number and transaction date using UTID, queries debit transactions within a date range around the transaction date, and returns the matching transaction record. Includes an alternative implementation that directly fetches transactions by UTID.
Headers
evrst-ptrnidCorrelation id for this request. Echo it in your own logs to trace the call through the platform.
getDebitCardTransactionByUtid › 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.
getDebitCardTransactionByUtid › Responses
Success
cardProductVirtualFlagWhether the product is a virtual one.
cardProductDigitalFlagWhether the product can be issued digitally.
sourceTabterminalNumberThe 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.
digitalSlipValueThe digital receipt itself.
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: operations take the shadow number.
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.
merchantNumberThe merchant's number with the acquirer.
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.
trnStatusCodeWhere the transaction has got to, as a code.
trnStatusDescriptionThe description of trnStatusCode, carried alongside it for display. It is not a key: match on the code.
utidThe 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.
accountNumberThe account at the bank's core banking system that the card draws on. It must already exist, belong to the card's customer, and be neither shared nor a foreign-currency account.
acqInstitutionIdsupplementaryCardFlagWhether this is a supplementary card rather than a main one.
getDebitCardTransactionByUtidNew
Retrieves a debit card transaction by UTID using the new transaction flow. Directly queries debit transactions by UTID and returns the matching transaction record.
Headers
evrst-ptrnidCorrelation id for this request. Echo it in your own logs to trace the call through the platform.
getDebitCardTransactionByUtidNew › 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.
getDebitCardTransactionByUtidNew › Responses
Success
cardProductVirtualFlagWhether the product is a virtual one.
cardProductDigitalFlagWhether the product can be issued digitally.
sourceTabterminalNumberThe 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.
digitalSlipValueThe digital receipt itself.
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: operations take the shadow number.
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.
merchantNumberThe merchant's number with the acquirer.
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.
trnStatusCodeWhere the transaction has got to, as a code.
trnStatusDescriptionThe description of trnStatusCode, carried alongside it for display. It is not a key: match on the code.
utidThe 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.
accountNumberThe account at the bank's core banking system that the card draws on. It must already exist, belong to the card's customer, and be neither shared nor a foreign-currency account.
acqInstitutionIdsupplementaryCardFlagWhether this is a supplementary card rather than a main one.
getDebitTransactionAll
Retrieves all debit card transactions for a given ShadowCardNumber and date range. Combines authorization and posted transaction records, merges unmatched authorizations, filters reward transactions, calculates total amount, and returns ordered transaction details including amounts, merchant info, status, rewards, and digital slip data. Also supports UTID-based retrieval via an alternative method.
Part of:
- Journey 01 · Launching a new card product — step 4, Activate, PIN, transact
Headers
evrst-ptrnidCorrelation id for this request. Echo it in your own logs to trace the call through the platform.
getDebitTransactionAll › Request Body
shadowCardNumberThe card whose transactions are listed. The only checked field, and a card that matches no master is an empty answer rather than a refusal — the operation returns before it queries anything.
beginDateStart of the window. Not checked, and not checked against endDate either.
A 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.
endDateEnd of the window.
A 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.
responseCodeNarrows the authorisations to one response code. Not applied to the settled transactions, which are queried without it.
Comes back from the transaction services; no column behind this API holds it.
responseReasonCodeNarrows the authorisations to one response reason code. Not applied to the settled transactions either.
Comes back from the transaction services; no column behind this API holds it.
networkTypeNarrows both halves of the answer to one network.
Resolved 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
trnCodeMatrixIdNarrows both halves to one transaction-code matrix entry.
maxAmountUpper bound on the amount, applied to both halves.
minAmountLower bound on the amount, applied to both halves.
getDebitTransactionAll › Responses
Success
totalAmountThe amount of every entry in the list added together.
The transactions the search matched.
updateTransactionForBNPL
Updates installment information for BNPL (Buy Now Pay Later) transactions. Updates corresponding transaction records for Installment Count, Installment Parameter, and Installment Profit Rate to synchronize with core banking system.
Headers
evrst-ptrnidCorrelation id for this request. Echo it in your own logs to trace the call through the platform.
updateTransactionForBNPL › 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.
installmentCountHow many instalments to split the amount across. The available counts for a card and amount come from the simulation operations.
installmentParameterWhich instalment rule the transaction is split by.
installmentProfitRateThe rate applied across the instalments.
updateTransactionForBNPL › Responses
Success
isSuccessWhether the operation did what it was asked to. A false here arrives with HTTP 200, so it has to be read rather than inferred from the status.
errorMessagegetDigitalSlipReceipt
Retrieves the digital slip (receipt) for a debit card transaction using UTID. Returns transaction details including amounts, currency, card info, authorization, terminal and merchant information, ICC data, and reference UTID if available.
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: operations take the shadow number.
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.
getAuthorizationListByBegindateEnddate
Retrieves the list of debit card authorizations for a given period. Requires start date and end date as input and returns the authorization transactions that occurred within that date range.
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
getDbttransactionByCardrefCustomernum
Retrieves debit card transaction records based on card reference number and customer number. Calls DCID repository to fetch transaction data and returns the result without additional filtering or transformation.
Headers
evrst-ptrnidCorrelation id for this request. Echo it in your own logs to trace the call through the platform.
getDbttransactionByCardrefCustomernum › Request Body
The search itself. The request body carries a single object, named after the query behind it, and its fields are the criteria.
getDbttransactionByCardrefCustomernum › Responses
Success