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 › Responses
Success
cardProductVirtualFlagCard Product Virtual Flag
cardProductDigitalFlagCard Product Digital Flag
sourceTabSource Tab - [Optional]
terminalNumberTerminal Number - [Optional]
authorizationNumberAuthorization Number - [Optional]
authorizationMatchStatusAuthorization Match Status - [Optional]
cardRefNumberCard Ref Number - [Optional]
cardSeqNumberCard Seq Number - [Optional]
channelTypeDescriptionChannel Type Description - [Optional]
customerCustomer - [Optional]
customerNumberCustomer Number - [Optional]
digitalSlipValueDigital Slip Value - [Optional]
isChipFlagIs Chip Flag - [Optional]
localAmountLocal Amount - [Optional]
localCurrencyDescriptionLocal Currency Description - [Optional]
mainCustomerNumberMain Customer Number - [Optional]
maskedCardNumberMasked Card Number - [Optional]
matchStatusDescriptionMatch Status Description - [Optional]
mccDescriptionMcc Description - [Optional]
merchantCountryCodeMerchant Country Code - [Optional]
merchantNameMerchant Name - [Optional]
merchantNumberMerchant Number - [Optional]
networkTypeDescriptionNetwork Type Description - [Optional]
offlineFlagOffline Flag - [Optional]
panEntryModePan Entry Mode - [Optional]
pinUsagePin Usage - [Optional]
responseCodeDescriptionResponse Code Description - [Optional]
responseReasonCodeDescriptionResponse Reason Code Description - [Optional]
rrnRrn - [Optional]
settlementAmountSettlement Amount - [Optional]
settlementCurrencyDescriptionSettlement Currency Description - [Optional]
terminalTypeTerminal Type - [Optional]
transactionDateTransaction Date - [Optional]
trnAmountTrn Amount - [Optional]
trnCodeMatrixDescriptionTrn Code Matrix Description - [Optional]
trnCurrencyDescriptionTrn Currency Description - [Optional]
trnStatusCodeTrn Status Code - [Optional]
trnStatusDescriptionTrn Status Description - [Optional]
utidUtid - [Optional]
trnEffectTrn Effect - [Optional]
channelTypeChannel Type - [Optional]
capitalRewardIndicatorCapital Reward Indicator - [Optional]
trnCurrencyCodeTrn Currency Code - [Optional]
transactionDescriptionTransaction Description - [Optional]
Earned Point - [Optional]
trnCodeMatrixIdTrn Code Matrix Id - [Optional]
shadowCardNumberShadow Card Number - [Optional]
mainCardRefNumberMain Card Ref Number - [Optional]
mccMcc - [Optional]
mccGroupCodeMcc Group Code - [Optional]
localCurrencyCodeLocal Currency Code - [Optional]
accountNumberAccount Number - [Optional]
acqInstitutionIdAcq Institution Id - [Optional]
supplementaryCardFlagSupplementary Card Flag
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 › Responses
Success
cardProductVirtualFlagCard Product Virtual Flag
cardProductDigitalFlagCard Product Digital Flag
sourceTabSource Tab - [Optional]
terminalNumberTerminal Number - [Optional]
authorizationNumberAuthorization Number - [Optional]
authorizationMatchStatusAuthorization Match Status - [Optional]
cardRefNumberCard Ref Number - [Optional]
cardSeqNumberCard Seq Number - [Optional]
channelTypeDescriptionChannel Type Description - [Optional]
customerCustomer - [Optional]
customerNumberCustomer Number - [Optional]
digitalSlipValueDigital Slip Value - [Optional]
isChipFlagIs Chip Flag - [Optional]
localAmountLocal Amount - [Optional]
localCurrencyDescriptionLocal Currency Description - [Optional]
mainCustomerNumberMain Customer Number - [Optional]
maskedCardNumberMasked Card Number - [Optional]
matchStatusDescriptionMatch Status Description - [Optional]
mccDescriptionMcc Description - [Optional]
merchantCountryCodeMerchant Country Code - [Optional]
merchantNameMerchant Name - [Optional]
merchantNumberMerchant Number - [Optional]
networkTypeDescriptionNetwork Type Description - [Optional]
offlineFlagOffline Flag - [Optional]
panEntryModePan Entry Mode - [Optional]
pinUsagePin Usage - [Optional]
responseCodeDescriptionResponse Code Description - [Optional]
responseReasonCodeDescriptionResponse Reason Code Description - [Optional]
rrnRrn - [Optional]
settlementAmountSettlement Amount - [Optional]
settlementCurrencyDescriptionSettlement Currency Description - [Optional]
terminalTypeTerminal Type - [Optional]
transactionDateTransaction Date - [Optional]
trnAmountTrn Amount - [Optional]
trnCodeMatrixDescriptionTrn Code Matrix Description - [Optional]
trnCurrencyDescriptionTrn Currency Description - [Optional]
trnStatusCodeTrn Status Code - [Optional]
trnStatusDescriptionTrn Status Description - [Optional]
utidUtid - [Optional]
trnEffectTrn Effect - [Optional]
channelTypeChannel Type - [Optional]
capitalRewardIndicatorCapital Reward Indicator - [Optional]
trnCurrencyCodeTrn Currency Code - [Optional]
transactionDescriptionTransaction Description - [Optional]
Earned Point - [Optional]
trnCodeMatrixIdTrn Code Matrix Id - [Optional]
shadowCardNumberShadow Card Number - [Optional]
mainCardRefNumberMain Card Ref Number - [Optional]
mccMcc - [Optional]
mccGroupCodeMcc Group Code - [Optional]
localCurrencyCodeLocal Currency Code - [Optional]
accountNumberAccount Number - [Optional]
acqInstitutionIdAcq Institution Id - [Optional]
supplementaryCardFlagSupplementary Card Flag
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
shadowCardNumberShadow Card Number - [Optional]
beginDateBegin Date - [Optional]
endDateEnd Date - [Optional]
responseCodeResponse Code - [Optional]
responseReasonCodeResponse Reason Code - [Optional]
networkTypeNetwork Type - [Optional]
trnCodeMatrixIdTrn Code Matrix Id - [Optional]
maxAmountMax Amount - [Optional]
minAmountMin Amount - [Optional]
getDebitTransactionAll › Responses
Success
totalAmountTotal Amount
List Of Transaction - [Optional]
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
utidUtid
installmentCountInstallment Count
installmentParameterInstallment Parameter
installmentProfitRateInstallment Profit Rate
updateTransactionForBNPL › Responses
Success
isSuccessIs Success
errorMessageError Message
getDigitalSlipReceipt
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 channel code. Used for entitlement, limits and the audit trail. See the Channels page (sidebar, or from Get started) for the full code list.
utidUtid - [Optional]
getDigitalSlipReceipt › Responses
Success
utidUtid - [Optional]
refUtidRef Utid - [Optional]
trnCodeMatrixIdTrn Code Matrix Id - [Optional]
shadowCardNumberShadow Card Number - [Optional]
cardRefNumberCard Ref Number - [Optional]
maskedCardNumberMasked Card Number - [Optional]
trnAmountTrn Amount - [Optional]
trnCurrencyCodeTrn Currency Code - [Optional]
responseCodeResponse Code - [Optional]
trnDatetimeTrn Datetime - [Optional]
trnStatusTrn Status - [Optional]
stanStan - [Optional]
rrnRrn - [Optional]
authorizationNumberAuthorization Number - [Optional]
terminalNumberTerminal Number - [Optional]
merchantNumberMerchant Number - [Optional]
merchantNameMerchant Name - [Optional]
panEntryModePan Entry Mode - [Optional]
iccData84Icc Data84 - [Optional]
iccData9f26Icc Data9f26 - [Optional]
cardSeqNumberCard Seq Number - [Optional]
merchantAddressMerchant Address - [Optional]
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
Get Authorization List By Begindate Enddate Param - [Optional]
getAuthorizationListByBegindateEnddate › Responses
Success
Get Authorization List By Begindate Enddate Result - [Optional]
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
Get Dbttransaction By Cardref Customernum Param - [Optional]
getDbttransactionByCardrefCustomernum › Responses
Success
Get Dbttransaction By Cardref Customernum Result - [Optional]