Instalments
Split a purchase or a cash advance across a repayment schedule, then track, settle early or cancel the plan.
getEarlyCloseCandidateList
Service that lists installment transactions eligible for early closure for the given customer and card.
Headers
evrst-ptrnidCorrelation id for this request. Echo it in your own logs to trace the call through the platform.
getEarlyCloseCandidateList › Request Body
shadowCardNumberShadow Card Number - [Optional]
customerNumberCustomer Number - [Optional]
getEarlyCloseCandidateList › Responses
Success
List Of Early Close Candidate Row - [Optional]
doEarlyClose
Performs early closure of a credit card installment. Returns the early release log record ID and the shadow card number.
Headers
evrst-ptrnidCorrelation id for this request. Echo it in your own logs to trace the call through the platform.
doEarlyClose › Request Body
shadowCardNumberShadow Card Number - [Optional]
utidUtid - [Optional]
feeAmountFee Amount - [Optional]
earlyReleaseTypeEarly Release Type - [Optional]
doEarlyClose › Responses
Success
erLogRecordIdEr Log Record Id
shadowCardNumberShadow Card Number - [Optional]
getInstallmentCountsByUtid
Retrieves the installment counts and limits for a credit card transaction identified by UTID. Returns minimum and maximum installment counts, deferring month limits, MCC-based limits, profile-based limits, and transaction details (amount, date, description). Adjusts MaxInstallmentCount and MaxDeferringMonthCount if the transaction occurs in an emergency city.
Headers
evrst-ptrnidCorrelation id for this request. Echo it in your own logs to trace the call through the platform.
getInstallmentCountsByUtid › Responses
Success
AmountAmount
DateDate
MinInstallmentCountMin Installment Count - [Optional]
MaxInstallmentCountMax Installment Count - [Optional]
MinDeferringMonthCountMin Deferring Month Count - [Optional]
MaxDeferringMonthCountMax Deferring Month Count - [Optional]
InstallmentCountLimitInstallment Count Limit - [Optional]
InstallmentCountMccGroupLimitInstallment Count Mcc Group Limit - [Optional]
InstallmentCountMccLimitInstallment Count Mcc Limit - [Optional]
InstallmentProfileDeferringLimitInstallment Profile Deferring Limit - [Optional]
InstallmentProfileInstallmentLimitInstallment Profile Installment Limit - [Optional]
MccDefinitionInstallmentLimitMcc Definition Installment Limit - [Optional]
DescriptionDescription - [Optional]
getCashInstallmentParameter
Retrieves cash installment parameters for a given shadow card and transaction amount. Returns a list of installment options including minimum and maximum installment counts, transaction amount limits, profit rates, and fees. Requires a valid ShadowCardNumber.
Part of:
-
Journey 03 · Enabling additional capabilities — step 2, Installment cash (IPP)
-
Journey 03 · Enabling additional capabilities — step 2, Same services, debit card
Headers
evrst-ptrnidCorrelation id for this request. Echo it in your own logs to trace the call through the platform.
getCashInstallmentParameter › Request Body
shadowCardNumberShadow Card Number
accountNumberAccount Number - [Optional]
transactionAmountTransaction Amount - [Optional]
channelIdThree-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.
getCashInstallmentParameter › Responses
Success
Cash Installment Parameter List - [Optional]
simulateCashInstallmentForAll
Simulates cash installments for all possible installment counts, providing a detailed breakdown of the total amount, installment amounts, profit, fees, and the remaining balance for each installment count.
Part of:
-
Journey 03 · Enabling additional capabilities — step 2, Installment cash (IPP)
-
Journey 03 · Enabling additional capabilities — step 2, Same services, debit card
Headers
evrst-ptrnidCorrelation id for this request. Echo it in your own logs to trace the call through the platform.
simulateCashInstallmentForAll › Request Body
shadowCardNumberShadow Card Number
accountNumberAccount Number - [Optional]
transactionAmountTransaction Amount - [Optional]
channelIdThree-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.
simulateCashInstallmentForAll › Responses
Success
Cash Installment Simulate List - [Optional]
simulateCashInstallment
Simulates the cash installment process for a given card, calculating the installment amounts, profit, and other associated fees based on the requested installment count and transaction amount.
Headers
evrst-ptrnidCorrelation id for this request. Echo it in your own logs to trace the call through the platform.
simulateCashInstallment › Request Body
shadowCardNumberShadow Card Number
accountNumberAccount Number - [Optional]
transactionAmountTransaction Amount - [Optional]
installmentCountInstallment Count - [Optional]
channelIdThree-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.
simulateCashInstallment › Responses
Success
Cash Installment Simulate Item - [Optional]
doCashInstallment
Processes a cash installment payment (early release). Returns transaction ID, authorization number, UTID, and RRN.
Part of:
-
Journey 03 · Enabling additional capabilities — step 2, Installment cash (IPP)
-
Journey 03 · Enabling additional capabilities — step 2, Same services, debit card
Headers
evrst-ptrnidCorrelation id for this request. Echo it in your own logs to trace the call through the platform.
doCashInstallment › Request Body
shadowCardNumberShadow Card Number
accountNumberAccount Number - [Optional]
referenceNumberReference Number - [Optional]
transactionAmountTransaction Amount - [Optional]
installmentCountInstallment Count - [Optional]
channelIdThree-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.
doCashInstallment › Responses
Success
isSuccessIs Success
feeAmountFee Amount
uTIDU T I D - [Optional]
authCodeAuth Code - [Optional]
responseCodeResponse Code - [Optional]
responseReasonCodeResponse Reason Code - [Optional]
reasonDescriptionReason Description - [Optional]
rrnRrn - [Optional]
reverseCashInstallment
Reverses a cash installment transaction using the provided amount, shadow card number, UTID, and reference number.
Part of:
- Journey 03 · Enabling additional capabilities — step 2, Installment cash (IPP)
Headers
evrst-ptrnidCorrelation id for this request. Echo it in your own logs to trace the call through the platform.
reverseCashInstallment › Request Body
amountAmount - [Optional]
shadowCardNumberShadow Card Number - [Optional]
uTIDU T I D - [Optional]
referenceNumberReference Number - [Optional]
reverseCashInstallment › Responses
Success
isSuccessIs Success
uTIDU T I D - [Optional]
authCodeAuth Code - [Optional]
responseReasonCodeResponse Reason Code - [Optional]
getCancelableCashInstallmentList
Retrieves a list of cancellable cash installments for a given shadow card number, including transaction details and card master information.
Headers
evrst-ptrnidCorrelation id for this request. Echo it in your own logs to trace the call through the platform.
getCancelableCashInstallmentList › Request Body
shadowCardNumberShadow Card Number
getCancelableCashInstallmentList › Responses
Success
List Of Cash Installment - [Optional]
getEarlyReleaseCashInstallments
Retrieves cash installment transactions available for early release for a given ShadowCardNumber. Returns a list of transactions with details including total installment amount, installment count, fees, profit, taxes (Bsmv, Kkdf, interest), remaining installment capital, and a breakdown of each installment in DetailList with dates, amounts, and flags.
Headers
evrst-ptrnidCorrelation id for this request. Echo it in your own logs to trace the call through the platform.
getEarlyReleaseCashInstallments › Responses
Success
Transaction List - [Optional]
getEarlyReleaseCashInstallment
Service that returns early-closed installment cash advance details.
Headers
evrst-ptrnidCorrelation id for this request. Echo it in your own logs to trace the call through the platform.
getEarlyReleaseCashInstallment › Request Body
shadowCardNumberShadow Card Number
utidUtid
getEarlyReleaseCashInstallment › Responses
Success
transactionDateTransaction Date
transactionAmountTransaction Amount
installmentCountInstallment Count
totalFeeAmountTotal Fee Amount
installmentProfitRateInstallment Profit Rate
totalInstallmentAmountTotal Installment Amount
remainingInstallmentCountRemaining Installment Count
remainingInstallmentCapitalAmountRemaining Installment Capital Amount
earlyReleaseTotalAmountEarly Release Total Amount
earlyReleaseInterestAmountEarly Release Interest Amount
earlyReleaseTotalTaxAmountEarly Release Total Tax Amount
earlyReleaseBsmvAmountEarly Release Bsmv Amount
earlyReleaseKkdfAmountEarly Release Kkdf Amount
shadowCardNumberShadow Card Number - [Optional]
mainCardRefNumberMain Card Ref Number - [Optional]
utidUtid - [Optional]
doCashInstallmentEarlyReleasePayment
Processes an early release cash installment payment. Returns UTID, transaction ID, authorization number, and RRN.
Headers
evrst-ptrnidCorrelation id for this request. Echo it in your own logs to trace the call through the platform.
doCashInstallmentEarlyReleasePayment › Request Body
amountEarly-release settlement amount.
clientReferenceNumberCaller business key for the payment.
shadowCardNumberCard the early-release payment is posted against.
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.
currencyCodeISO currency of the payment.
cashInstallmentUtidUTID of the cash-installment plan being settled early.
accountNumberAccepted on the request; not mapped into the payment entity.
doCashInstallmentEarlyReleasePayment › Responses
Success
trnIdTrn Id
utidUtid - [Optional]
rrnRrn - [Optional]
authorizationNumberAuthorization Number - [Optional]
cancelCashInstallEarlyReleasePayment
Cancels an early release cash installment payment for a credit card. Calls the transaction management service to reverse the payment using transaction ID, amount, currency, card reference, and other identifiers. Returns the transaction ID of the cancellation.
Headers
evrst-ptrnidCorrelation id for this request. Echo it in your own logs to trace the call through the platform.
cancelCashInstallEarlyReleasePayment › Request Body
trnIdTransaction id of the early-release payment being reversed.
amountAmount of the original early-release payment.
currencyCodeCurrency of the original payment.
clientReferenceNumberSame client reference used on the payment call.
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.
cashInstallmentUtidUTID of the cash-installment plan the payment belonged to.
cardRefNumberCard reference when needed to locate the original payment.
mainCustomerNumberMain customer number when required by the cancel criteria.
trnDateOriginal transaction date when the cancel needs date scoping.
cancelCashInstallEarlyReleasePayment › Responses
Success
trnIdTrn Id
getAllWaitingInstallments
Retrieves all waiting (pending) credit card installments for a given shadow card number. Returns both summary and detailed installment information grouped by statement date.
Part of:
- Journey 03 · Enabling additional capabilities — step 3, Track waiting installments
Headers
evrst-ptrnidCorrelation id for this request. Echo it in your own logs to trace the call through the platform.
getAllWaitingInstallments › Request Body
shadowCardNumberShadow Card Number - [Optional]
getAllWaitingInstallments › Responses
Success
Result
getWaitingInstallmentDetail
Retrieves the waiting (upcoming) installment details for a credit card. The service first validates the card using the shadow card number, then fetches the list of waiting installments, including transaction details, amounts, dates, MCC info, product info, reward info, and installment attributes. Supports both current and new repository methods for fetching waiting installment details. The response is mapped to CreditCardNextPeriodInstallmentModel, and transactions can also be mapped to CreditCardDetailTransactionItem for client consumption.
Part of:
- Journey 03 · Enabling additional capabilities — step 3, Track waiting installments
Headers
evrst-ptrnidCorrelation id for this request. Echo it in your own logs to trace the call through the platform.
getWaitingInstallmentDetail › Responses
Success
totalAmountTotal Amount
List Of Next Period Installment - [Optional]
currencyCodeCurrency Code - [Optional]
getWaitingInstallmentSummary
Retrieves a summary of waiting (upcoming) installments for a credit card. The service validates the card using the shadow card number, fetches the installment summary from the repository, and aggregates amounts by statement date, including total installment amount, fees, taxes (KKDF, BSMV), profit, and capital. The result is returned as a list of WaitingInstallmentSummaryInfo within GetWaitingInstallmentSummaryResponse.
Part of:
- Journey 03 · Enabling additional capabilities — step 3, Track waiting installments
Headers
evrst-ptrnidCorrelation id for this request. Echo it in your own logs to trace the call through the platform.
getWaitingInstallmentSummary › Request Body
shadowCardNumberShadow Card Number - [Optional]
getWaitingInstallmentSummary › Responses
Success
List Waiting Installment Summary Info - [Optional]
manuelInstallmentOrder
Places a manual installment order for a credit card transaction. It uses the transaction management service to create an installment order based on the shadow card number, transaction ID (UTID), installment count, and deferring month count. The response includes the InstallmentOrderRecordId for tracking.
Part of:
- Journey 03 · Enabling additional capabilities — step 1, Purchase conversion (EPP)
Headers
evrst-ptrnidCorrelation id for this request. Echo it in your own logs to trace the call through the platform.
manuelInstallmentOrder › Request Body
installmentCountInstallment Count - [Optional]
shadowCardNumberShadow Card Number - [Optional]
utidUtid - [Optional]
deferringMonthCountDeferring Month Count - [Optional]
channelTypeChannel Type - [Optional]
manuelInstallmentOrder › Responses
Success
installmentOrderRecordIdInstallment Order Record Id
manuelInstallmentOrderSimulate
Simulates a manual installment order for a credit card transaction. Returns projected installment details including installment amount, total payment amount, profit rate, and a breakdown of total PFT (Profit, BSMV, KKDF, and fees). The response includes a list of simulated installment records with installment number, capital amount, installment date, and remaining total amount.
Part of:
- Journey 03 · Enabling additional capabilities — step 1, Purchase conversion (EPP)
Headers
evrst-ptrnidCorrelation id for this request. Echo it in your own logs to trace the call through the platform.
manuelInstallmentOrderSimulate › Request Body
installmentCountInstallment Count - [Optional]
shadowCardNumberShadow Card Number - [Optional]
utidUtid - [Optional]
deferringMonthCountDeferring Month Count - [Optional]
manuelInstallmentOrderSimulate › Responses
Success
installmentAmountInstallment Amount
profitRateProfit Rate
totalPaymentAmountTotal Payment Amount
totalPFTAmountTotal P F T Amount
installmentCountInstallment Count
deferringMonthCountDeferring Month Count
List Of Installment Record - [Optional]
getInstallmentCountsByUtidNew
Retrieves the installment counts and limits for a credit card transaction identified by UTID using the new DCIC logic. Returns minimum and maximum installment counts, deferring month limits, MCC-based limits, profile-based limits, and transaction details (amount, date, description). Adjusts MaxInstallmentCount and MaxDeferringMonthCount if the transaction occurs in an emergency city. Unlike the previous version, this method fetches the installment info directly from the DCIC new repository without querying the full customer transaction details.
Part of:
- Journey 03 · Enabling additional capabilities — step 1, Purchase conversion (EPP)
Headers
evrst-ptrnidCorrelation id for this request. Echo it in your own logs to trace the call through the platform.
getInstallmentCountsByUtidNew › Responses
Success
AmountAmount
DateDate
MinInstallmentCountMin Installment Count - [Optional]
MaxInstallmentCountMax Installment Count - [Optional]
MinDeferringMonthCountMin Deferring Month Count - [Optional]
MaxDeferringMonthCountMax Deferring Month Count - [Optional]
InstallmentCountLimitInstallment Count Limit - [Optional]
InstallmentCountMccGroupLimitInstallment Count Mcc Group Limit - [Optional]
InstallmentCountMccLimitInstallment Count Mcc Limit - [Optional]
InstallmentProfileDeferringLimitInstallment Profile Deferring Limit - [Optional]
InstallmentProfileInstallmentLimitInstallment Profile Installment Limit - [Optional]
MccDefinitionInstallmentLimitMcc Definition Installment Limit - [Optional]
DescriptionDescription - [Optional]
cancelInstallmentEarlyRelease
Cancels an early release of an installment for a given card identified by ShadowCardNumber and UTID. Returns the number of affected rows as EffectedRowCount.
Headers
evrst-ptrnidCorrelation id for this request. Echo it in your own logs to trace the call through the platform.
cancelInstallmentEarlyRelease › Request Body
shadowCardNumberShadow Card Number - [Optional]
utidUtid - [Optional]
cancelInstallmentEarlyRelease › Responses
Success
effectedRowCountEffected Row Count
getManuelInstallmentCancelRecordsByCardRefNumber
Retrieves the manual installment cancellation records for a given card reference number or shadow card number. Returns details such as installment count, amount, deferring month, fee and profit amounts, transaction source, merchant, processing flags, and relevant dates. Throws an error if both CardRefNumber and ShadowCardNumber are null. This method helps track manually canceled installments for credit card transactions.
Headers
evrst-ptrnidCorrelation id for this request. Echo it in your own logs to trace the call through the platform.
getManuelInstallmentCancelRecordsByCardRefNumber › Request Body
cardRefNumberCard Ref Number - [Optional]
shadowCardNumberShadow Card Number - [Optional]
getManuelInstallmentCancelRecordsByCardRefNumber › Responses
Success
Manuel Installment Cancel Records - [Optional]
getEarlyReleaseAvailableInstallmentsByCriterias
Retrieves available installments for early release based on criteria such as CardRefNumber, MainCardRefNumber, or ShadowCardNumber. Returns detailed installment information including remaining principal, fees, profit, taxes, installment counts, transaction details, merchant information, and totals. Supports subsequent simulation and release of early installments.
Part of:
- Journey 03 · Enabling additional capabilities — step 4, Early settlement
Headers
evrst-ptrnidCorrelation id for this request. Echo it in your own logs to trace the call through the platform.
getEarlyReleaseAvailableInstallmentsByCriterias › Request Body
cardRefNumberCard Ref Number - [Optional]
mainCardRefNumberMain Card Ref Number - [Optional]
shadowCardNumberShadow Card Number - [Optional]
getEarlyReleaseAvailableInstallmentsByCriterias › Responses
Success
Installment Early Release Rows - [Optional]
simulateInstallmentEarlyRelease
Simulates the early release of an installment, providing details of the remaining balance, canceled fees and profit, early payment amount, and the total installment count.
Part of:
- Journey 03 · Enabling additional capabilities — step 4, Early settlement
Headers
evrst-ptrnidCorrelation id for this request. Echo it in your own logs to trace the call through the platform.
simulateInstallmentEarlyRelease › Request Body
shadowCardNumberShadow Card Number - [Optional]
utidUtid - [Optional]
simulateInstallmentEarlyRelease › Responses
Success
CanceledFeeAndProfitAmountCanceled Fee And Profit Amount
ProfitAmountProfit Amount
FeeAmountFee Amount
EarlyReleaseDeferringAmountEarly Release Deferring Amount
TrnDateTrn Date
EarlyPaymentAmountEarly Payment Amount
RemainingInstallmentCountRemaining Installment Count
TotalInstallmentCountTotal Installment Count
AmountOfRemainingInstallmentAmount Of Remaining Installment
SummaryRecordIdSummary Record Id
CanceledProfitAmountCanceled Profit Amount
CanceledKkdfAmountCanceled Kkdf Amount
CanceledBsmvAmountCanceled Bsmv Amount
CanceledFeeAmountCanceled Fee Amount
releasePendingInstallment
Releases a pending installment for a credit card transaction. Accepts a UTID, early release type, and fee amount, and invokes the transaction management service to process the early release. Returns the ER log record ID and the associated ShadowCardNumber.
Part of:
- Journey 03 · Enabling additional capabilities — step 4, Early settlement
Headers
evrst-ptrnidCorrelation id for this request. Echo it in your own logs to trace the call through the platform.
releasePendingInstallment › Request Body
utidUtid - [Optional]
feeAmountFee Amount - [Optional]
earlyReleaseTypeEarly Release Type - [Optional]
releasePendingInstallment › Responses
Success
erLogRecordIdEr Log Record Id
shadowCardNumberShadow Card Number - [Optional]
cancelInstallmentTransactionOrder
Cancels an existing installment transaction order identified by RecordId. Returns InstallmentOrderRecordId and Success flag indicating whether the cancellation succeeded.
Part of:
- Journey 03 · Enabling additional capabilities — step 1, Purchase conversion (EPP)
Headers
evrst-ptrnidCorrelation id for this request. Echo it in your own logs to trace the call through the platform.
cancelInstallmentTransactionOrder › Responses
Success
installmentOrderRecordIdInstallment Order Record Id
successSuccess