Transactions
Read what happened on a card and correct it — transaction history, pending provisions, reversals and slip receipts.
doPaymentTransaction
Performs a credit card payment transaction. Returns transaction identifiers (UTID, RRN, AuthCode), response codes, and success status.
Part of:
-
Journey 01 · Launching a new card product — step 6, Post the first transaction
-
Journey 02 · Managing a card product — step 1, Post and quote payments
Headers
evrst-ptrnidCorrelation id for this request. Echo it in your own logs to trace the call through the platform.
doPaymentTransaction › Request Body
transactionSourceChannel the payment comes from, forwarded as ChannelID to online. Prefer the three-digit channel code; see the Channels page.
transactionTypePayment kind online expects — INV, HGS, REL, SGK, TAX (and related institution types such as RINV).
amountPayment amount. Must be greater than zero.
tranDateBusiness date of the payment.
shadowCardNumberThe platform's card reference the payment is posted against.
institutionCodeInstitution / biller code the payment is for.
referenceNumberCaller reference for the payment; used for reconciliation and reverse.
feeAmountFee when calculated by the caller (IsFeeCalculatedExternally).
bsmvAmountBSMV portion of the fee when calculated by the caller.
descriptionFree-text description stored with the online payment.
doPaymentTransaction › Responses
Success
isSuccessIs Success
uTIDU T I D - [Optional]
authCodeAuth Code - [Optional]
rrnRrn - [Optional]
responseCodeResponse Code - [Optional]
responseReasonCodeResponse Reason Code - [Optional]
responseCodeDescriptionResponse Code Description - [Optional]
reversePaymentTransaction
Reverses a payment transaction using the provided shadow card number, UTID, reference number, and authorization code.
Part of:
- Journey 02 · Managing a card product — step 4, Reversals
Headers
evrst-ptrnidCorrelation id for this request. Echo it in your own logs to trace the call through the platform.
reversePaymentTransaction › Request Body
uTIDUTID returned by the original doPaymentTransaction.
referenceNumberSame reference number as the original payment.
shadowCardNumberCard the original payment was posted on.
authCodeAuthorisation code from the original payment response.
amountPresent on the contract but not forwarded to online by the digital-channels layer; reverse is keyed by UTID / reference / auth.
reversePaymentTransaction › Responses
Success
isSuccessIs Success
uTIDU T I D - [Optional]
authCodeAuth Code - [Optional]
responseCodeResponse Code - [Optional]
responseCodeDescriptionResponse Code Description - [Optional]
responseReasonCodeResponse Reason Code - [Optional]
responseReasonCodeDescriptionResponse Reason Code Description - [Optional]
doPaymentFeeInquiry
Inquires the payment fee for a credit card transaction. Returns fee, BSMV, total commission, and transaction identifiers like UTID, RRN, and authorization code.
Part of:
-
Journey 01 · Launching a new card product — step 6, Post the first transaction
-
Journey 02 · Managing a card product — step 1, Post and quote payments
Headers
evrst-ptrnidCorrelation id for this request. Echo it in your own logs to trace the call through the platform.
doPaymentFeeInquiry › Request Body
transactionSourceChannel of the would-be payment; see the Channels page.
transactionTypeSame transaction type codes as doPaymentTransaction.
amountPrincipal amount the fee is calculated against.
tranDateBusiness date used for the fee calculation.
shadowCardNumberThe card the fee is calculated for.
institutionCodeInstitution / biller code.
referenceNumberCaller reference for the inquiry.
descriptionOptional description passed through to online.
doPaymentFeeInquiry › Responses
Success
feeAmountFee Amount
bsmvAmountBsmv Amount
totalCommissionAmountTotal Commission Amount
uTIDU T I D - [Optional]
authCodeAuth Code - [Optional]
rrnRrn - [Optional]
responseCodeResponse Code - [Optional]
responseReasonCodeResponse Reason Code - [Optional]
responseCodeDescriptionResponse Code Description - [Optional]
getCustomerTransactionDetail
Retrieves detailed information about a customer transaction based on the provided UTID (Unique Transaction ID). The method fetches the transaction and associated credit card information, calculates installment limits, and adjusts them if the transaction occurs in an emergency city, applying the appropriate multiplier. The response includes transaction amount, date, description, and the calculated installment counts and limits.
Part of:
- Journey 02 · Managing a card product — step 3, History and detail
Headers
evrst-ptrnidCorrelation id for this request. Echo it in your own logs to trace the call through the platform.
getCustomerTransactionDetail › Responses
Success
Transactions - [Optional]
getCardIntermTransactionInfo
Retrieves all intermediate transactions for a card, including detailed transaction info, rewards, installment info, MCC summaries, statement summary, and digital slip details. Supports pagination and optional inclusion of waiting installments.
Headers
evrst-ptrnidCorrelation id for this request. Echo it in your own logs to trace the call through the platform.
getCardIntermTransactionInfo › Request Body
channelThree-digit channel code (for example "002", not "Internet"). Used for entitlement, limits and the audit trail. See the Channels page (sidebar, or from Get started) for the full code list.
shadowCardNumberShadow Card Number - [Optional]
addWaitingInstallmentsAdd Waiting Installments - [Optional]
pageNumberPage Number - [Optional]
rowCountRow Count - [Optional]
getCardIntermTransactionInfo › Responses
Success
lastStatementTotalDebtLast Statement Total Debt
lastStatementUsedPointLast Statement Used Point
totalCurrentPointTotal Current Point
statementDateStatement Date
nextStatementDateNext Statement Date
remaingStatementDebtRemaing Statement Debt
nextNext
List Of Interm Transactions - [Optional]
Mcc Amount Summary - [Optional]
Mcc Reward Summary - [Optional]
getPendingProvisionList
Retrieves a list of pending provisions (pending transactions) for a given ShadowCardNumber. The service aggregates transaction details including amounts, currency, transaction date and description, earned rewards, installment eligibility, MCC and product info, transaction type, merchant details, and authorization/response info. Transactions are enriched with MCC definitions, card product info, and transaction code matrices. Special handling is applied for refunded transactions and certain channels (e.g., GetirFinans). Returns the mapped list of CreditCardPendingTransactionItem objects for integration purposes.
Headers
evrst-ptrnidCorrelation id for this request. Echo it in your own logs to trace the call through the platform.
getPendingProvisionList › Request Body
channelThree-digit channel code (for example "002", not "Internet"). Used for entitlement, limits and the audit trail. See the Channels page (sidebar, or from Get started) for the full code list.
shadowCardNumberShadow Card Number - [Optional]
getPendingProvisionList › Responses
Success
List Of Pending Provision Info - [Optional]
getCreditCardTransactionAll
Retrieves all credit card transaction data using ShadowCardNumber or MainCardRefNumber. Validates card information, fetches current period transactions, pending provisions, installment transactions, and next period installments. Calculates total amounts, debts, estimated statement debt, remaining statement debt, and returns detailed transaction, installment, provision, and statement-related information.
Part of:
- Journey 02 · Managing a card product — step 3, History and detail
Headers
evrst-ptrnidCorrelation id for this request. Echo it in your own logs to trace the call through the platform.
getCreditCardTransactionAll › Request Body
channelThree-digit channel code (for example "002", not "Internet"). Used for entitlement, limits and the audit trail. See the Channels page (sidebar, or from Get started) for the full code list.
shadowCardNumberShadow Card Number - [Optional]
mainCardRefNumberMain Card Ref Number - [Optional]
beginDateBegin Date - [Optional]
endDateEnd Date - [Optional]
onlySuccessFlagOnly Success Flag - [Optional]
getCreditCardTransactionAll › Responses
Success
Credit Card Next Period Installments - [Optional]
Credit Card Current Period Transactions - [Optional]
getCreditCardCurrentTransactionList
Retrieves the current period credit card transaction list using ShadowCardNumber or MainCardRefNumber. Fetches all transactions for the current statement period, separates installment and non-installment transactions, and enriches transaction data with transaction code descriptions and channel descriptions. Returns summary financial information such as current debt, estimated statement debt, remaining statement debt, total amount, and detailed transaction lists including amounts, dates, merchant info, rewards, installment details, and channel information.
Part of:
-
Journey 01 · Launching a new card product — step 6, Post the first transaction
-
Journey 02 · Managing a card product — step 3, History and detail
Headers
evrst-ptrnidCorrelation id for this request. Echo it in your own logs to trace the call through the platform.
getCreditCardCurrentTransactionList › Request Body
shadowCardNumberShadow Card Number - [Optional]
mainCardRefNumberMain Card Ref Number - [Optional]
getCreditCardCurrentTransactionList › Responses
Success
Credit Card Current Period Transactions - [Optional]
getTransactionAll
Retrieves all credit card transactions for a given card, including current period transactions, next period installments, and reward transactions. The service validates the card, fetches current and upcoming installments, filters reward transactions, and maps them into response models. The response includes CreditCardCurrentPeriodTransactions (current period transactions and pending provisions) and CreditCardNextPeriodInstallments (installments for the next period), with details on amounts, dates, descriptions, rewards, installments, and card product attributes.
Headers
evrst-ptrnidCorrelation id for this request. Echo it in your own logs to trace the call through the platform.
getTransactionAll › Request Body
channelThree-digit channel code (for example "002", not "Internet"). Used for entitlement, limits and the audit trail. See the Channels page (sidebar, or from Get started) for the full code list.
shadowCardNumberShadow Card Number - [Optional]
mainCardRefNumberMain Card Ref Number - [Optional]
beginDateBegin Date - [Optional]
endDateEnd Date - [Optional]
onlySuccessFlagOnly Success Flag - [Optional]
getTransactionAll › Responses
Success
Credit Card Next Period Installments - [Optional]
Credit Card Current Period Transactions - [Optional]
getPendingProvisionListNew
Retrieves a list of pending provisions (pending transactions) for a given ShadowCardNumber. The service aggregates transaction details including amounts, currency, transaction date and description, earned rewards, installment eligibility, MCC and product info, transaction type, merchant details, and authorization/response info. Transactions are enriched with MCC definitions, card product info, and transaction code matrices. Special handling is applied for refunded transactions and certain channels (e.g., GetirFinans). Returns the mapped list of CreditCardPendingTransactionItem objects for integration purposes.
Headers
evrst-ptrnidCorrelation id for this request. Echo it in your own logs to trace the call through the platform.
getPendingProvisionListNew › Request Body
channelThree-digit channel code (for example "002", not "Internet"). Used for entitlement, limits and the audit trail. See the Channels page (sidebar, or from Get started) for the full code list.
shadowCardNumberShadow Card Number - [Optional]
getPendingProvisionListNew › Responses
Success
List Of Pending Provision Info - [Optional]
getDigitalSlipReceipt
Retrieves the digital slip (transaction receipt) for a given UTID (Unique Transaction ID) and channel. The method returns detailed transaction information including card numbers (masked and shadow), transaction amount and currency, merchant details, authorization and response codes, terminal and transaction identifiers, ICC data, and transaction status.
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 (for example "002", not "Internet"). 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]