Transactions
Read what happened on a card and correct it — transaction history, pending provisions, reversals and slip receipts.
Service that processes payment transactions
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
Service that processes payment transactions › Request Body
amountAmount - [Optional]
feeAmountFee Amount - [Optional]
bsmvAmountBsmv Amount - [Optional]
tranDateTran Date - [Optional]
transactionSourceTransaction Source - [Optional]
transactionTypeTransaction Type - [Optional]
shadowCardNumberShadow Card Number - [Optional]
institutionCodeInstitution Code - [Optional]
referenceNumberReference Number - [Optional]
descriptionDescription - [Optional]
Service that processes payment transactions › Responses
Success
isSuccessIs Success - [Optional]
uTIDU T I D - [Optional]
authCodeAuth Code - [Optional]
rrnRrn - [Optional]
responseCodeResponse Code - [Optional]
responseReasonCodeResponse Reason Code - [Optional]
responseCodeDescriptionResponse Code Description - [Optional]
Payment cancellation service
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
Payment cancellation service › Request Body
amountAmount - [Optional]
uTIDU T I D - [Optional]
referenceNumberReference Number - [Optional]
shadowCardNumberShadow Card Number - [Optional]
authCodeAuth Code - [Optional]
Payment cancellation service › Responses
Success
isSuccessIs Success - [Optional]
uTIDU T I D - [Optional]
authCodeAuth Code - [Optional]
responseCodeResponse Code - [Optional]
responseCodeDescriptionResponse Code Description - [Optional]
responseReasonCodeResponse Reason Code - [Optional]
responseReasonCodeDescriptionResponse Reason Code Description - [Optional]
Service that queries fee information for payment transactions
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
Service that queries fee information for payment transactions › Request Body
amountAmount - [Optional]
tranDateTran Date - [Optional]
transactionSourceTransaction Source - [Optional]
transactionTypeTransaction Type - [Optional]
shadowCardNumberShadow Card Number - [Optional]
institutionCodeInstitution Code - [Optional]
referenceNumberReference Number - [Optional]
descriptionDescription - [Optional]
Service that queries fee information for payment transactions › Responses
Success
feeAmountFee Amount - [Optional]
bsmvAmountBsmv Amount - [Optional]
totalCommissionAmountTotal Commission Amount - [Optional]
uTIDU T I D - [Optional]
authCodeAuth Code - [Optional]
rrnRrn - [Optional]
responseCodeResponse Code - [Optional]
responseReasonCodeResponse Reason Code - [Optional]
responseCodeDescriptionResponse Code Description - [Optional]
Service that returns transaction details by given UTID
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
Service that returns transaction details by given UTID › Request Body
utidUtid - [Optional]
Service that returns transaction details by given UTID › Responses
Success
Transactions - [Optional]
Service that lists all successful/unsuccessful customer transactions
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.
Service that lists all successful/unsuccessful customer transactions › Request Body
pageNumberPage Number - [Optional]
rowCountRow Count - [Optional]
channelChannel - [Optional]
shadowCardNumberShadow Card Number - [Optional]
addWaitingInstallmentsAdd Waiting Installments - [Optional]
Service that lists all successful/unsuccessful customer transactions › Responses
Success
lastStatementTotalDebtLast Statement Total Debt - [Optional]
lastStatementUsedPointLast Statement Used Point - [Optional]
totalCurrentPointTotal Current Point - [Optional]
statementDateStatement Date - [Optional]
nextStatementDateNext Statement Date - [Optional]
remaingStatementDebtRemaing Statement Debt - [Optional]
nextNext - [Optional]
List Of Interm Transactions - [Optional]
Mcc Amount Summary - [Optional]
Mcc Reward Summary - [Optional]
Service that lists authorization transactions
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.
Service that lists authorization transactions › Request Body
channelChannel - [Optional]
shadowCardNumberShadow Card Number - [Optional]
Service that lists authorization transactions › Responses
Success
List Of Pending Provision Info - [Optional]
Service that lists credit card period, authorization, and pending installment transactions
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
Service that lists credit card period, authorization, and pending installment transactions › Request Body
onlySuccessFlagOnly Success Flag - [Optional]
channelChannel - [Optional]
shadowCardNumberShadow Card Number - [Optional]
mainCardRefNumberMain Card Ref Number - [Optional]
beginDateBegin Date - [Optional]
endDateEnd Date - [Optional]
Service that lists credit card period, authorization, and pending installment transactions › Responses
Success
Credit Card Next Period Installments - [Optional]
Credit Card Current Period Transactions - [Optional]
Service that lists in-period (current cycle) transactions
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
Service that lists in-period (current cycle) transactions › Request Body
shadowCardNumberShadow Card Number - [Optional]
mainCardRefNumberMain Card Ref Number - [Optional]
Service that lists in-period (current cycle) transactions › Responses
Success
Credit Card Current Period Transactions - [Optional]
Service that lists in-period card transactions and due installments
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.
Service that lists in-period card transactions and due installments › Request Body
onlySuccessFlagOnly Success Flag - [Optional]
channelChannel - [Optional]
shadowCardNumberShadow Card Number - [Optional]
mainCardRefNumberMain Card Ref Number - [Optional]
beginDateBegin Date - [Optional]
endDateEnd Date - [Optional]
Service that lists in-period card transactions and due installments › Responses
Success
Credit Card Next Period Installments - [Optional]
Credit Card Current Period Transactions - [Optional]
Service that lists authorization transactions.
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.
Service that lists authorization transactions. › Request Body
channelChannel - [Optional]
shadowCardNumberShadow Card Number - [Optional]
Service that lists authorization transactions. › Responses
Success
List Of Pending Provision Info - [Optional]
Service that lists Digital Slip preferences by given UTID
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.
Service that lists Digital Slip preferences by given UTID › Request Body
channelChannel - [Optional]
utidUtid - [Optional]
Service that lists Digital Slip preferences by given UTID › 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]