ActivateNoNameCardRequest
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.
customerNumberThe 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.
lastFourDigitThe last four digits of the card, which pick which of the customer's cards is activated. Matched against the end of the masked card number rather than a stored field of its own, and no length is checked: a shorter value matches more than one card and the operation refuses rather than choosing, while anything longer than the masked number matches nothing.
barcodeThe delivery barcode the consignment is tracked by.
Not read by the service. activateNoNameCard matches the card on customerNumber and lastFourDigit alone — the facade forwards this field and ActivateNoNameCard does not mention it, on credit, debit or prepaid. It is accepted and ignored.
AddDocumentByCaseNumberRequest
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.
CaseNumberRequired — Case the documents are attached to. The contract holds a non-nullable integer, so leaving the field out sends 0.
ExternalCaseIdThe case identifier in the external dispute system. Only the integration route reads it; the local route attaches by CaseNumber alone.
ExternalDocumentIdThe document identifier in the external dispute system. Only the integration route reads it.
Documents to attach. Only the identifier of each entry is forwarded, and a null entry in the array is forwarded as a reference with no identifier rather than skipped.
ApplicableProductFilter
productGroupCodeWhich group of products this one belongs to.
ApplicableProductFilters
productGroupCodeDemanded and then not read. The service refuses the request when this is absent and never consults it afterwards — the control it runs is about the main customer, not about a product group. Send any group code the column accepts; it does not narrow what is checked and it does not appear in the answer.
AttachCardAccountRequest
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.
accountNumberThe account being linked to the card. It must exist, belong to the card's customer, and be neither shared nor a foreign-currency account — each is its own refusal.
fecCodeThe foreign-currency code of the account, where the card draws on one.
accountBranchIdThe branch that holds the account, as core banking numbers it.
accountTypeValues:
A— main accountV— virement
accountSuffixThe suffix that distinguishes one account from another under the same number at core banking.
shadowCardNumberRequired in practice — The card the operation acts on. Not validated as a field — a request that names no card, or names one that does not exist, is refused as a business failure with no card found rather than as a missing field.
accountAliasA name for the account, shown to the cardholder where the account is listed. The platform stores it and does not interpret it.
ibanThe account's IBAN, stored alongside the account number.
accountOrderFlagNot read when sent. Attaching an account has the line commented out, and card creation writes false whatever is sent. The account listings return the stored value.
AttachCardAccountResponse
recordIdThe identifier of the row the operation created or acted on. Returned rather than sent in most operations that carry it.
CancelCardEmbossByShadowCardNumberRequest
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.
shadowCardNumberShadow card number of the card whose pending emboss request is cancelled. Checked by the facade and checked again by the issuing service, with the same rule on both sides.
CancelCashInstallEarlyReleasePaymentRequest
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.
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.
cashInstallmentUtidUTID of the cash-installment plan the payment belonged to.
The installment's own transaction identifier, carried through to the services that hold it.
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.
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.
CancelCashInstallEarlyReleasePaymentResponse
trnIdThe platform's identifier for the transaction row.
CancelCreditCardDebtPaymentRequest
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.
trnIdTransaction id of the debt payment being reversed.
amountAmount of the original payment.
currencyCodeCurrency of the original payment.
clientReferenceNumberSame client reference used on doCreditCardDebtPayment.
cardRefNumberCard reference when cancelling by card rather than shadow alone.
mainCustomerNumberMain customer number when required by the cancel criteria.
trnDateOriginal transaction date when the cancel needs date scoping.
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.
CancelCreditCardDebtPaymentResponse
trnIdThe platform's identifier for the transaction row.
CancelDisputeCaseRequest
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.
CaseNumberRequired — Case being withdrawn. The contract holds a non-nullable integer, so leaving the field out sends 0, and the local route refuses that.
DisputeTransactionIdDispute transaction within the case that is being withdrawn. Either this or UTID identifies the line: the local route matches on DISPUTE_TRANSACTION_ID = :id OR UTID = :utid and refuses the request only when both are absent. The contract holds a non-nullable integer, so leaving it out sends 0.
UTIDUnique transaction identifier of the disputed transaction, as an alternative to DisputeTransactionId.
DescriptionFree-text reason for the withdrawal, written to the case history. It is truncated rather than refused: the local route stores SUBSTR(:CUSTOMER_EXPLANATION, 1, 200), so anything past 200 characters is dropped silently.
CancelDisputeCaseResponse
isSuccessfulWhether 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.
CancelInstallmentEarlyReleaseRequest
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.
utidThe unique transaction identifier the platform gives a transaction, and the handle every later operation on it takes. Returned by the transaction listings.
CancelInstallmentTransactionOrderRequest
recordIdThe identifier of the row the operation created or acted on. Returned rather than sent in most operations that carry it.
CancelInstallmentTransactionOrderResponse
installmentOrderRecordIdsuccessWhether 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.
CancelNoNameCardApplicationRequest
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.
applicationIdThe card application this request belongs to. Returned when an application is created, and carried through the card that comes out of it.
cancelReasonCodeWhy the application is being cancelled.
cancelReasonTextFree text alongside the cancellation reason.
CardAccount
fecCodeThe foreign-currency code of the account, where the card draws on one.
accountBranchIdThe branch that holds the account, as core banking numbers it.
accountSuffixThe suffix that distinguishes one account from another under the same number at core banking.
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.
recordIdThe identifier of the row the operation created or acted on. Returned rather than sent in most operations that carry it.
validFlagWhether the row is live. The platform sets it; a value sent here is replaced.
insertDateWhen the row was created.
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.
accountTypeValues:
A— main accountV— virement
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.
accountAliasA name for the account, shown to the cardholder where the account is listed. The platform stores it and does not interpret it.
updateUserIdAn audit column the platform fills in. It is on the request because the contract was generated from the table, and a value sent here is replaced.
updateDateWhen the row was last changed.
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.
insertTokenIdAn audit column the platform fills in. It is on the request because the contract was generated from the table, and a value sent here is replaced.
insertUserIdAn audit column the platform fills in. It is on the request because the contract was generated from the table, and a value sent here is replaced.
updateTokenIdAn audit column the platform fills in. It is on the request because the contract was generated from the table, and a value sent here is replaced.
ibanThe account's IBAN, stored alongside the account number.
accountOrderFlagNot read when sent. Attaching an account has the line commented out, and card creation writes false whatever is sent. The account listings return the stored value.
currencyCodeThe currency of the amount, as its three-letter code.
CardAccountInfo
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.
accountBranchIdThe branch that holds the account, as core banking numbers it.
fecCodeThe foreign-currency code of the account, where the card draws on one.
balanceusableBalanceThe balance available to spend.
cardAccountTypeaccountTypeValues:
A— main accountV— virement
accountSubTypeaccountOrderFlagNot read when sent. Attaching an account has the line commented out, and card creation writes false whatever is sent. The account listings return the stored value.
currencyCodeThe currency of the amount, as its three-letter code.
iBANerrorDescriptionThe error in words. errorCode is the part to match on.
CardAutoPaymentOrderEntity
paymentAccountNumbermainCustomerNumberThe main customer of a corporate relationship, as a number. The employees and supplementary holders under it carry their own customerNumber.
paymentAccountOwnerNamemainCardRefNumberThe 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.
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.
paymentTypeWhat kind of payment this is.
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.
CardFinancialInfoByCardRefNumberItem
authorizationAmountavailableLimitHow much of the limit is left.
cardLimitThe card's own spending limit.
cardOpeningDateA 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.
cardRefNumberThe card reference, which identifies one issued card including its renewals. Returned by the create and listing operations alongside the shadow number.
cardStatusCodeValues:
A— validB— pendingC— stolenD— cancelled by the bankF— fraudG— temporarily blockedI— cancelledL— lostM— cancelled by the customerT— corporate dummy
cardStatusDescriptionThe description of cardStatusCode, carried alongside it for display. It is not a key: match on the code.
currentAmountcustomerNumberThe 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.
customerRoofLimitcustomerTypeValues:
1— corporate2— individual3— employee4— sole proprietorship
Not set is N.
customerTypeDescriptionThe description of customerType, carried alongside it for display. It is not a key: match on the code.
delayDayCountdelayProfitBsmvRatedelayProfitKkdfRatedelayProfitRatedelinquencyPeriodHow many periods the account has been in arrears.
delinquencyStatusCodedelinquencyStatusDescriptionThe description of delinquencyStatusCode, carried alongside it for display. It is not a key: match on the code.
firstDelayDateA 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.
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.
nextStatementDateA 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.
nextStatementDueDateA 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.
nextStatementDueOptionDateA 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.
pendingInstallmentAmountproductNameThe card product's full name.
productNumberThe card product the card is issued on. Defined in the parameter tables; getCardProductList returns the ones a tenant may use.
rediscountProfitAmountrediscountTaxAmountrediscountTax1AmountrediscountTax2AmountremainingStatementAmountremainingStatementMinAmountshadowCardNumberThe 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.
statementAmountstatementDateA 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.
statementDueDateA 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.
statementDueOptionDateA 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.
statementMinAmountThe least that may be paid against the statement.
totalDebttotalDebtWithRediscounttotalDebtWithRediscountAuthorizationtotalDebtWithDailyPaymentcurrentPeriodDebtcurrentPeriodRediscountProfitcustomerCurrentDebtWithRediscountcustomerCurrentDebtWithoutRediscounttotalDebtIfCardCancelledCardInfo
maskedCustomerNameshadowCardNumberThe 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.
tenantIdWhich tenant's records to read. Omitting it reads the rows that belong to no tenant rather than all of them.
CardIntermTransactionInfo
lastStatementTotalDebtlastStatementUsedPointtotalCurrentPointstatementDateA 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.
nextStatementDateA 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.
remaingStatementDebtWhat is left of the statement's debt.
nextCardLimitationParameterData
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.
customerLimitationFlagWhether the card draws against the customer's limit rather than having one of its own.
profileCodeWhich profile the card's limits come from.
profileDescriptionThe description of profileCode, carried alongside it for display. It is not a key: match on the code.
Which limit row this is: the transaction group, the network and the channel together identify one. The descriptions beside each code are returned for display and are not part of the key.
perTrnAmountThe most the card may spend in one transaction.
perTrnAmountLimitRatioThe same cap as a share of the card's limit rather than an amount.
dailyTrnCountThe most transactions the card may make in a day.
dailyTrnAmountThe most the card may spend in a day.
weeklyTrnCountThe most transactions the card may make in a week.
weeklyTrnAmountThe most the card may spend in a week.
monthlyTrnCountThe most transactions the card may make in a month.
monthlyTrnAmountThe most the card may spend in a month.
yearlyTrnCountThe most transactions the card may make in a year.
yearlyTrnAmountThe most the card may spend in a year.
CardMccAmountSummary
amountThe amount.
mccGroupCodeWhich group of merchant categories the merchant falls in.
currencyCodeThe currency of the amount, as its three-letter code.
CardMccRewardSummary
pointmccGroupCodeWhich group of merchant categories the merchant falls in.
CardMiscOptionData
customerNumberThe 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.
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.
cardRefNumberThe card reference, which identifies one issued card including its renewals. Returned by the create and listing operations alongside the shadow number.
optionTypeValues:
DS— digital slip — whether the cardholder's slip is printedDC— dynamic CVV — whether the card's CVV is generated per period
optionValueValues:
HardCopy— a printed slip — the valueDStakesDigitalSlip— a digital slip — the valueDStakestrue— dynamic CVV on — the valueDCtakes, compared as this exact string
CardStatementInfo
amountThe amount.
minAmountdateA 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.
dueDateA 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.
nextDueDateA 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.
nextStatementDateA 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.
statementCodecurrencyCodeThe currency of the amount, as its three-letter code.
documentIDCashInstallmentEarlyReleaseDetailEntity
installmentNumberWhich instalment this is.
installmentDateA 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.
installmentAmountWhat each instalment comes to.
installmentCapitalAmountThe capital part of the instalment, without interest.
installmentProfitAmountThe interest charged across the instalments.
installmentBsmvAmountinstallmentKkdfAmountstatementFlagWhether the transaction has reached a statement.
moveCurrentFlagCashInstallmentEarlyReleaseSummaryEntity
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.
transactionAmountThe amount of the transaction.
installmentCountHow many instalments to split the amount across. The available counts for a card and amount come from the simulation operations.
totalFeeAmountinstallmentProfitRatetotalInstallmentAmountWhat the instalments come to together.
remainingInstallmentCountHow many instalments are still to run.
remainingInstallmentCapitalAmountearlyReleaseTotalAmountearlyReleaseInterestAmountearlyReleaseTotalTaxAmountearlyReleaseBsmvAmountearlyReleaseKkdfAmountshadowCardNumberThe 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.
utidThe unique transaction identifier the platform gives a transaction, and the handle every later operation on it takes. Returned by the transaction listings.
ChangeAndReplaceCardRequest
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.
shadowCardNumberThe card being closed and replaced. One call does both, so this is the card the status change lands on and the card the replacement is issued against.
How the replacement card is issued. The object itself is required, and two of its fields are checked with it.
cardStatusCodeValues:
A— validB— pendingC— stolenD— cancelled by the bankF— fraudG— temporarily blockedI— cancelledL— lostM— cancelled by the customerT— corporate dummy
cardStatusReasonCodeWhy the status is being set. The valid reasons depend on the status: getAvailableCardStatusList returns the pairs a card may move to.
closeRequestDateA 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.
ChangeAndReplaceCardResponse
toStatusActiveWhether the card ends this operation in an active status.
resetCustomerLimitlistOfShadowCardNumberForClosedCardThe cards the operation closed.
listOfCardRefNumberForResetLimitWhat the replacement produced.
ChangeAndReplaceNoNameCardReplaceModel
replaceReasonCodeWhy the card is being replaced. It decides what the replacement inherits and whether the card number changes.
enrollMasterpassWhether to enrol the new card with Masterpass. Forwarded to the issuing service, which does the enrolment; the card is created either way.
What the card may do: e-commerce, international purchases and mail order. Each is optional, and one left unset takes the platform's own default rather than being refused — for e-commerce that default follows digitalCardFlag.
ChangeAndReplaceNoNameCardRequest
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.
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.
cardStatusCodeValues:
A— validB— pendingC— stolenD— cancelled by the bankF— fraudG— temporarily blockedI— cancelledL— lostM— cancelled by the customerT— corporate dummy
cardStatusReasonCodeWhy the status is being set. The valid reasons depend on the status: getAvailableCardStatusList returns the pairs a card may move to.
What the replacement card should carry — delivery, address and emboss details. Left out, the replacement inherits the card's own.
closeRequestDateA 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.
ChangeAndReplaceNoNameCardResponse
toStatusActiveWhether the card ends this operation in an active status.
applicationIdThe card application this request belongs to. Returned when an application is created, and carried through the card that comes out of it.
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.
newCardGeneratedWhether the change produced a new card.
productChangedWhether the change moved the card to another product.
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.
cardRefNumberThe card reference, which identifies one issued card including its renewals. Returned by the create and listing operations alongside the shadow number.
ChangeCardAutoLimitIncreaseRequest
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.
cardRefNumberRequired in practice — The card the operation acts on. Not validated as a field — a request that names no card, or names one that does not exist, is refused as a business failure with no card found rather than as a missing field.
autoLimitIncreaseFlagWhether the card takes part in automatic limit increases.
shadowCardNumberRequired in practice — The card the operation acts on. Not validated as a field — a request that names no card, or names one that does not exist, is refused as a business failure with no card found rather than as a missing field.
ChangeCardAutoLimitIncreaseResponse
isChangedcardRefNumberThe card reference, which identifies one issued card including its renewals. Returned by the create and listing operations alongside the shadow number.
autoLimitIncreaseFlagWhether the card takes part in automatic limit increases.
ChangeCardBranchRequest
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.
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.
targetBranchCodeThe branch to move the card or customer to.
ChangeCardBranchResponse
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.
oldBranchThe branch before the move.
newBranchThe branch after it.
ChangeCardLimitDecreaseRequest
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.
limitThe limit the card is lowered to — an absolute figure, not a difference.
shadowCardNumberOne-of — The card whose limit changes — send this or the other card identifier. Neither is validated as a field. The service's checks on them are commented out, so a request carrying neither is refused as a business failure with no card found, rather than as a missing field.
cardRefNumberOne-of — The card whose limit changes — send this or the other card identifier. Neither is validated as a field. The service's checks on them are commented out, so a request carrying neither is refused as a business failure with no card found, rather than as a missing field.
limitRatioThe limit as a share of another limit rather than an amount.
cashLimitRatioHow much of the card's limit may be drawn as cash, as a share.
changeCustomerLimitWhether the customer's limit moves with the card's.
cardProfileSetCodeWhich profile set the card's limits come from. Defined in the parameter tables.
applicationNoThe credit application the limit notification is filed under. It is forwarded to core banking, which files the notification and answers; the platform stores nothing of what is sent, so its format is the bank's rather than this API's.
Only read when the customer's limit is being lowered too, and then only for an individual product: the notification step runs under changeCustomerLimit, and a corporate product never reaches it.
Leaving it out is not the same as having none. The service falls back to the application id of the customer's current card — a supplementary one first — and files the notification under that, so omitting the field chooses a value rather than omitting one.
skipReverseWhenLksFailedWhether to leave the payment in place when the core banking leg fails rather than reversing it.
ChangeCardLimitDecreaseResponse
listOfCardLimitChangeLogIdThe limit changes to reverse, by the log id each change returned.
listOfCustomerLimitChangeLogIdThe customer limit changes to reverse, by the log id each change returned.
ChangeCardLimitRequest
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.
limitThe limit the card is raised to — an absolute figure, not a difference. A value equal to or below the card's current limit is refused by the increase rules rather than accepted as a no-op.
shadowCardNumberOne-of — The card whose limit changes — send this or the other card identifier. Neither is validated as a field. The service's checks on them are commented out, so a request carrying neither is refused as a business failure with no card found, rather than as a missing field.
cardRefNumberOne-of — The card whose limit changes — send this or the other card identifier. Neither is validated as a field. The service's checks on them are commented out, so a request carrying neither is refused as a business failure with no card found, rather than as a missing field.
limitRatioThe limit as a share of another limit rather than an amount.
cashLimitRatioHow much of the card's limit may be drawn as cash, as a share.
changeCustomerLimitWhether the customer's limit moves with the card's.
cardProfileSetCodeWhich profile set the card's limits come from. Defined in the parameter tables.
ChangeCardLimitResponse
listOfCardLimitChangeLogIdThe limit changes to reverse, by the log id each change returned.
listOfCustomerLimitChangeLogIdThe customer limit changes to reverse, by the log id each change returned.
ChangeCardLimitReverseRequest
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.
listOfCardLimitChangeLogIdListHasNoItem — The card limit changes to undo. Each entry is one cardLimitChangeLogId — a whole number, the record id of a row in the card limit change log — and they are the ids changeCardLimitDecrease, changeCardLimitIncrease and the other limit changes hand back in their own listOfCardLimitChangeLogId. A caller does not compose one.
Mandatory: an absent list and an empty one are refused alike. An id that matches no log row stops the whole request rather than being skipped.
listOfCustomerLimitChangeLogIdThe customer limit changes to undo, in the same form: each entry is the record id of a row in the customer limit change log, as returned in listOfCustomerLimitChangeLogId. Left out or empty, no customer limit is touched and only the card limits above are reversed. An id that matches no log row stops the request.
ChangeCardMiscOptionRequest
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.
optionTypeValues:
DS— digital slip — whether the cardholder's slip is printedDC— dynamic CVV — whether the card's CVV is generated per period
optionValueValues:
HardCopy— a printed slip — the valueDStakesDigitalSlip— a digital slip — the valueDStakestrue— dynamic CVV on — the valueDCtakes, compared as this exact string
customerNumberThe 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.
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.
cardRefNumberThe card reference, which identifies one issued card including its renewals. Returned by the create and listing operations alongside the shadow number.
allMainCardFlagWhether every main card of the customer is included.
allCardFlagWhether every card of the customer is included.
ChangeCardPinRequest
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.
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.
currentCardPinChecked against the platform's Pin parameter rather than a fixed length, so it follows the tenant's configuration and can change without a release.
newCardPinChecked against the platform's Pin parameter rather than a fixed length, so it follows the tenant's configuration and can change without a release.
ChangeCardPinResponse
successWhether 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.
verifiedWhether the value presented matched the one held.
changedencryptedPinThe PIN block as the key management service produced it. The PIN itself never travels.
ChangeCardStatusRequest
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.
shadowCardNumberThe card whose status changes.
cardStatusCodeThe status to move to. Must be a status the platform defines.
Values:
A— validB— pendingC— stolenD— cancelled by the bankF— fraudG— temporarily blockedI— cancelledL— lostM— cancelled by the customerT— corporate dummy
cardStatusReasonCodeDependent — The reason for the new status. Must be a reason defined for cardStatusCode.
transactionIdThe caller's own id. Echoed back in the error body.
reissueCardDefault false — Reissue the card with the status change.
closeRequestDateThe date the closure was requested.
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.
changeMeOnlyDefault false — Change only this card, not the cards that would follow it.
ChangeCardStatusResponse
toStatusActiveWhether the card ends this operation in an active status.
resetCustomerLimitlistOfShadowCardNumberForClosedCardThe cards the operation closed.
listOfCardRefNumberForResetLimitnewShadowCardNumberChangeCorporateCardLimitDecreaseRequest
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.
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.
limitThe limit to set.
cardRefNumberThe card reference, which identifies one issued card including its renewals. Returned by the create and listing operations alongside the shadow number.
limitRatioThe limit as a share of another limit rather than an amount.
cashLimitRatioHow much of the card's limit may be drawn as cash, as a share.
changeCustomerLimitWhether the customer's limit moves with the card's.
cardProfileSetCodeWhich profile set the card's limits come from. Defined in the parameter tables.
applicationNoNot read by the service. The credit application a limit notification would be filed under, which this operation never files: the notification runs only for an individual product and this one refuses anything that is not corporate. The facade forwards the field and nothing behind it looks at it.
changeCardLimitDecrease is where it is read.
ChangeCorporateCardLimitIncreaseRequest
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.
limitThe limit the card is raised to — an absolute figure, not a difference. This is the one field the facade checks itself: an absent value is refused with 60008 before the limit service is reached.
shadowCardNumberOne-of — The card whose limit changes — send this or the other card identifier. Neither is validated as a field. The service's checks on them are commented out, so a request carrying neither is refused as a business failure with no card found, rather than as a missing field.
cardRefNumberOne-of — The card whose limit changes — send this or the other card identifier. Neither is validated as a field. The service's checks on them are commented out, so a request carrying neither is refused as a business failure with no card found, rather than as a missing field.
limitRatioThe limit as a share of another limit rather than an amount.
cashLimitRatioHow much of the card's limit may be drawn as cash, as a share.
changeCustomerLimitDefault false — Raise the company's limit along with the card's. True returns a second list of log ids, listOfCustomerLimitChangeLogId; false leaves it empty and the card limit may then not exceed the company's.
cardProfileSetCodeThe profile set the raised limit is applied under. Forwarded to the limit service, which decides what it means; nothing in this API reads it.
ChangeCorporateCardLimitResponse
listOfCardLimitChangeLogIdThe limit changes to reverse, by the log id each change returned.
listOfCustomerLimitChangeLogIdThe customer limit changes to reverse, by the log id each change returned.
ChangeCreditCardStatementPeriodRequest
statementPeriodWhich statement period the card is billed on. The periods a product allows come from the reference data.
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.
ChangeCreditCardStatementSendPreferenceRequest
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.
emailSendFlagWhether the statement is sent by e-mail.
postingFlagWhether the statement is posted on paper.
smsSendFlagWhether the statement is announced by SMS.
postingAddressTypeWhich kind of address the statement is posted to.
ChangeCustomerBranchRequest
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.
customerNumberThe 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.
targetBranchCodeThe branch to move the card or customer to.
ChangeCustomerBranchResponse
oldBranchThe branch before the move.
newBranchThe branch after it.
changedCardCountHow many cards the operation changed.
listOfShadowCardNumbersThe cards the operation acted on.
ChangeCustomerCreditCardStatusRequest
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.
customerNumberCustomer whose cards are moved. Rejected by the facade when absent, and by the service again when zero.
cardStatusCodeValues:
A— validB— pendingC— stolenD— cancelled by the bankF— fraudG— temporarily blockedI— cancelledL— lostM— cancelled by the customerT— corporate dummy
cardStatusReasonCodeWhy the status is being set. The valid reasons depend on the status: getAvailableCardStatusList returns the pairs a card may move to.
activateCardWhether to activate the card as it is created.
ChangeCustomerCreditCardStatusResponse
listOfShadowCardNumberForClosedCardThe cards the operation closed.
ChangeIndividualCardLimitRequest
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.
customerNumberThe 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.
cardRefNumberThe card reference, which identifies one issued card including its renewals. Returned by the create and listing operations alongside the shadow number.
newCustomerLimitThe limit to set on the customer.
newCardLimitThe limit to set on the card.
increaseAllMainCardsLimitFlagWhether the increase applies to every main card of the customer.
ChangeIndividualCardLimitResponse
listOfCardLimitChangeLogIdThe limit changes to reverse, by the log id each change returned.
listOfCustomerLimitChangeLogIdThe customer limit changes to reverse, by the log id each change returned.
ChangeRsaPinRequest
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.
shadowCardNumberThe card the operation acts on, by its shadow card number — the platform's own reference, not the PAN.
currentEPBThe encrypted PIN block holding the cardholder's current PIN.
Its size follows the block format and the key it was built with rather than a column.
newEPBThe encrypted PIN block holding the PIN being set.
Its size follows the block format and the key it was built with rather than a column.
operationDateOfCurrentThe date the current PIN block was produced under. It belongs with currentEPB — the pair is what the key management service verifies.
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.
operationDateOfNewThe date the new PIN block was produced under, paired with newEPB the same way.
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.
ChangeRsaPinResponse
successWhether 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.
encryptedPinThe PIN block as the key management service produced it. The PIN itself never travels.
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.
responseDescriptionThe description of responseCode, carried alongside it for display. It is not a key: match on the code.
ChangeVirtualCardLimitRequest
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.
cardRefNumberRequired in practice — The virtual card whose limit is set. Not validated here — the facade forwards every field untouched, so an absent or unknown value is refused by the limit service in its own vocabulary. The card's product must be a virtual one; this operation is not a general limit change.
limitTypeRequired in practice — Whether the limit expires. A fixed limit is time-boxed and makes endOfDayFlag meaningful; anything else is open-ended. Not validated here, and the limit service refuses a value meaning none.
Values:
S— fixed — the limit stays as setH— decreasing — each transaction reduces it
Not set is N.
newDemandedAvailableLimitRequired in practice — The available limit to set. Bounded by three pools at once — the related card's available limit, the main card's and the customer's — and exceeding any one of the three refuses the request. Not validated here.
endOfDayFlagConditional — When a fixed limit ends: at the end of the day, or otherwise on the related card's next statement date. This is what makes a single-use card possible. Read only for a fixed limit.
ChangeVirtualCardLimitResponse
newLimitlistOfCardLimitChangeLogIdThe limit changes to reverse, by the log id each change returned.
CheckCreditCardForDebtPaymentRequest
channelCodeThree-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.
panClear PAN used to resolve BIN and card type. Missing or ineligible PANs return soft errors in the 200 body (99000–99002), not HTTP 400.
A card number is not stored by these services; the platform keeps a shadow card number instead.
CheckCreditCardForDebtPaymentResponse
isRipperresultThe outcome, as the downstream system words it.
errorCodeThe platform's own code for the error, and what to match on.
errorMessageerrorServiceprocessorBinbankCodebankNameisSuplemantaryThe card the operation is answering about.
CreateCardMiscOption
optionTypeValues:
DS— digital slip — whether the cardholder's slip is printedDC— dynamic CVV — whether the card's CVV is generated per period
optionValueValues:
HardCopy— a printed slip — the valueDStakesDigitalSlip— a digital slip — the valueDStakestrue— dynamic CVV on — the valueDCtakes, compared as this exact string
CreateCardPermissions
eCommercePermittedWhether the card may be used online.
mailOrderPermittedWhether the card may be used for mail and telephone order.
internationalPurchasePermittedWhether the card may be used abroad.
CreateCorporateCardRequest
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.
productNumberProduct the corporate card is issued on. Rejected when absent and when it matches no card product. Its segment must then be Corporate: an individual product is refused on this field, although the message that comes back reads Product Not Individual, which is the service's own copy of the individual operation's wording. A product that issues virtual cards is refused outright — this operation does not create them. Unlike the individual operations, nothing here consults the applicable-product list.
customerNumberCustomer the card belongs to. Rejected when absent, when zero, and when the number has no personal-information record.
shadowCardNumberThe main card's shadow number. Its master must carry a main customer, that customer's firm information, a limit and a financial record; each missing one is its own refusal.
branchCodeBranch the application is made at. Rejected when absent and again when it matches no branch.
digitalCardFlagAsk for the card to be issued as digital. Refused when the product has no digital card ability.
nameOnCardThe name embossed on the card. The services truncate to 26 characters before writing rather than refusing a longer one, so a name that matters should be checked at 26.
secondNameOnCardThe second embossed line, used for the company name on a corporate card.
cardDeliveryTypeValues:
P— by postS— to the branch
Not set is "".
cardSendAddressTypeWhich address the card is sent to. Only checked when supplied, and then it may not resolve to None.
Values:
RA— homeAL— businessEA— employerOO— alternativeWA— previousSW— SWIFTSS— SWIFT name and addressMR— Mernis, registeredMS— Mernis, stated
Not set is --.
cardSendAddressIdWhich of the customer's addresses to send the card to. The identifier of an address already held for that customer, not an address.
cardDeliveryBranchCodeConditional · NotNull — Branch the card is delivered to. Required when cardDeliveryType is the branch delivery type, and the branch it names must then exist. Not read otherwise.
enrollMasterpassWhether to enrol the new card with Masterpass. Forwarded to the issuing service, which does the enrolment; the card is created either way.
What the card may do: e-commerce, international purchases and mail order. Each is optional, and one left unset takes the platform's own default rather than being refused — for e-commerce that default follows digitalCardFlag.
The accounts to attach to the card as it is created. Each entry carries the account's own identifiers; attaching one later is attachCardAccount.
contractTypeWhich cardholder contract the customer accepted. The pair with contractVersionNumber records what was agreed to and when.
contractVersionNumberWhich version of that contract the customer accepted.
cardLimitValueThe spending limit to open the card with.
authorizationSmsSendFlagWhether an SMS is sent for each authorisation on the card.
authorizationSmsSendMinimumAmountThe amount an authorisation has to reach before that SMS is sent.
applicationIdThe card application this request belongs to. Returned when an application is created, and carried through the card that comes out of it.
applicationDateA 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.
applicationContractIdThe contract record in the application system that this card comes from.
CreateCorporateCardResponse
recordIdThe identifier of the row the operation created or acted on. Returned rather than sent in most operations that carry it.
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.
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.
mainShadowCardNumbercardRefNumberThe card reference, which identifies one issued card including its renewals. Returned by the create and listing operations alongside the shadow number.
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.
What the operation wants to say about work it did anyway. A warning does not mean the operation failed.
The card number, expiry and verification value, returned only where the operation and the channel are entitled to them.
CreateDisputeCaseDetail
DisputeAmountAmount disputed for this transaction. The contract holds a non-nullable number, so leaving the field out sends 0.
UTIDRequired in practice — Unique transaction identifier of the transaction being disputed, and the only thing the local route matches a transaction on: it refuses the case with TransactionNotFound when no transaction carries this identifier.
CurrencyCodeCurrency of the disputed amount. Used only when DisputeAmountCurrencyCode is absent — the two are read as DisputeAmountCurrencyCode ?? CurrencyCode — and the integration route ignores it entirely, so prefer the other field.
DisputeAmountCurrencyCodeCurrency of the disputed amount, and the field both routes read first.
ClearingChannelWith ClearingTableName and ClearingNumber, which clearing record is being disputed. Only the integration route reads the three; the local route matches on UTID alone and drops them. The four characters are the width of what it has to match — the column on the 33 clearing transaction tables. The dispute case detail stores it in a wider column, ten characters, but a longer value would be stored and match nothing.
ClearingTableNameWhich clearing table the disputed record is in. Only the integration route reads it.
ClearingNumberWhich record within that table. The contract holds a non-nullable number, so leaving the field out sends 0, and only the integration route reads it.
AcquirerRefNumberThe acquirer's reference for the disputed transaction. Only the integration route reads it.
ExternalCaseIdRequired in practice — The case identifier in the external dispute system. The integration route refuses a blank one on any entry; the local route drops it. Used to match the case rather than stored by this platform.
ExternalDocumentIdRequired in practice — The document identifier in the external dispute system. The integration route refuses a blank one on any entry; the local route drops it.
SpecialFollowupWhether the case needs special follow-up, Y or N. The integration service substitutes N for a blank, which is what makes it a one-character flag; the local route drops it.
VipFlagWhether the cardholder is a VIP, Y or N. The integration service substitutes N for a blank; the local route drops it.
Document references for this entry. Only the integration route reads them — on the local route, attach documents through the request's own DmsReference instead.
CreateDisputeCaseRequest
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.
ShadowCardNumberShadow number of the disputed card. One of four ways to name the disputed card, and at least one of them is needed: the local route refuses the request with CardInformationRequired when all four are absent. Both routes forward it, but the integration service does not pass it on to the dispute management service, so on that route it narrows nothing.
CardRefNumberCard reference number of the disputed card. One of four ways to name the disputed card, and at least one of them is needed: the local route refuses the request with CardInformationRequired when all four are absent. Only the local route forwards it; the integration route drops it.
EncryptedCardNumberEncrypted card number of the disputed card. One of four ways to name the disputed card, and at least one of them is needed: the local route refuses the request with CardInformationRequired when all four are absent. A key rather than stored data: the local route looks the card up with it and then replaces the value with the one the card service returns, and the integration route drops it.
CardNumberPlain card number of the disputed card. One of four ways to name the disputed card, and at least one of them is needed: the local route refuses the request with CardInformationRequired when all four are absent. The number itself is never stored — the case tables hold a masked form and a hash. The integration route refuses a blank one.
CaseTypeWhich side of the dispute the case is opened on. The local route accepts only the two values below and answers "Undefined Case Type" to anything else; it is stored in CMS_DIS.CASE_MAIN.IA_INDICATOR.
Values:
I— issuer sideA— acquirer side
DisputeDateRequired — Date the dispute is raised. The contract holds a non-nullable date, so leaving the field out forwards 0001-01-01 rather than today, and the local route refuses that.
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.
DisputeReasonCodeDispute reason. Use a code returned by Get Dispute Reason Def List: the local route looks the value up in that same definition table and refuses an unknown one. The codes are rows rather than constants, so they can change without a release and are not published as a fixed list.
DisputeExplanationRequired in practice — Free-text explanation of the dispute. Both routes refuse a blank one, and neither declares the field required.
ExternalCaseIdNot read on either route. The local route does not forward it, and the integration route forwards it to a service that then drops it. Set it on each entry of CreateDisputeCaseDetail instead, which is where the integration route reads it and refuses a blank.
SpecialFollowupNot read on either route, for the same reason as ExternalCaseId. The per-detail copy is the one that reaches the service, where a blank becomes N.
VipFlagNot read on either route, for the same reason as ExternalCaseId. The per-detail copy is the one that reaches the service, where a blank becomes N.
Transactions covered by the case. The integration route refuses an empty or missing list; the local route accepts the request and then fails on the first entry, because it reads the list without a null check. The local route also forwards only three fields of each entry — see the entry's own fields.
Document references to attach to the new case. Only the identifier of each entry is forwarded, on both routes.
CreateDisputeCaseResponse
CaseNumberThe dispute case this belongs to.
The transactions the case covers.
CreateDummyCorporateCardRequest
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.
productNumberProduct the dummy corporate card is issued on. Rejected when absent and when it matches no card product. Its segment must then be Corporate: an individual product is refused on this field, although the message that comes back reads Product Not Individual, which is the service's own copy of the individual operation's wording. Nothing here consults the applicable-product list.
customerNumberCustomer the card belongs to. Rejected when absent and again when zero.
branchCodeBranch the application is made at. Rejected when absent and again when it matches no branch.
digitalCardFlagAsk for the card to be issued as digital. Refused when the product has no digital card ability.
nameOnCardThe name embossed on the card. The services truncate to 26 characters before writing rather than refusing a longer one, so a name that matters should be checked at 26.
statementPeriodWhich statement period the card is billed on. The periods a product allows come from the reference data.
statementCurrencyCodeThe currency the statement is produced in.
statementPostFlagWhether the statement is posted on paper.
statementSmsSendFlagWhether the statement is announced by SMS.
statementEmailSendFlagWhether the statement is sent by e-mail.
statementSendingAddressTypeWhich address the statement is sent to. Only checked when supplied, and then it may not resolve to None.
statementSendAddressIdWhich of the customer's addresses the statement is posted to.
cardLimitValueThe spending limit to open the card with.
customerLimitValueThe limit for the customer behind the card, which the card's own limit draws against.
autoInstallmentCountHow many instalments a purchase is split into automatically, where the product allows it.
autoDeferringMonthCountHow many months a purchase is deferred automatically, where the product allows it.
autoLimitIncreaseFlagWhether the card takes part in automatic limit increases.
autoPaymentFlagWhether the card's debt is paid automatically. The account it is paid from is autoPaymentAccount, which is only read when this is true.
The account automatic payment draws on. Read only when autoPaymentFlag is true; otherwise no payment order is created.
applicationIdThe card application this request belongs to. Returned when an application is created, and carried through the card that comes out of it.
applicationDateApplication Date
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.
applicationContractIdThe contract record in the application system that this card comes from.
CreateDummyCorporateCardResponse
cardMasterRecordIdsecureCardMasterRecordIdcardRefNumberThe card reference, which identifies one issued card including its renewals. Returned by the create and listing operations alongside the shadow number.
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.
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.
What the operation wants to say about work it did anyway. A warning does not mean the operation failed.
CreateIndividualCardAccount
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.
accountTypeValues:
A— main accountV— virement
accountOrderFlagNot read when sent. Attaching an account has the line commented out, and card creation writes false whatever is sent. The account listings return the stored value.
currencyCodeThe currency of the amount, as its three-letter code.
CreateIndividualCardAutoPaymentAccount
accountBranchIdThe branch that holds the account, as core banking numbers it.
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.
paymentTypeWhat kind of payment this is.
accountSuffixThe suffix that distinguishes one account from another under the same number at core banking.
CreateIndividualCardRequest
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.
productNumberThe product the card is issued on. Must be defined, applicable, and have at least one applicable channel.
customerNumberThe customer the card is issued to.
branchCodeThe branch the card is issued from. Must be a defined branch.
digitalCardFlagWhether to issue the card as a digital one. It also decides the default e-commerce permission where permissions leaves that unset.
nameOnCardThe name embossed on the card. The services truncate to 26 characters before writing rather than refusing a longer one, so a name that matters should be checked at 26.
secondNameOnCardThe second embossed line, used for the company name on a corporate card.
cardDeliveryTypeHow the card reaches the cardholder. Branch makes cardDeliveryBranchCode mandatory.
Values:
P— by postS— to the branch
Not set is "".
cardSendAddressTypeValues:
RA— homeAL— businessEA— employerOO— alternativeWA— previousSW— SWIFTSS— SWIFT name and addressMR— Mernis, registeredMS— Mernis, stated
Not set is --.
cardDeliveryBranchCodeConditional · NotNull — The branch the card is delivered to. Mandatory when cardDeliveryType is Branch.
cardSendAddressIdWhich of the customer's addresses to send the card to. The identifier of an address already held for that customer, not an address.
What the card may do: e-commerce, international purchases and mail order. Each is optional, and one left unset takes the platform's own default rather than being refused — for e-commerce that default follows digitalCardFlag.
The accounts to attach to the card as it is created. Each entry carries the account's own identifiers; attaching one later is attachCardAccount.
A miscellaneous option to set on the card, as a type-and-value pair. Only one may be sent at creation; changeCardMiscOption sets more.
Leaving it out does not leave the option unset. No row is written, but getCardMiscOption answers for a card that has none by returning the first value configured for that option type — so the card behaves as if it had been given that value. Which value that is comes from the option-type definition rather than from this API.
Replacing a card carries the option across. Where the replaced card had none, the platform writes DS / HardCopy onto the new one.
enrollMasterpassWhether to enrol the new card with Masterpass. Forwarded to the issuing service, which does the enrolment; the card is created either way.
contractTypeWhich cardholder contract the customer accepted. The pair with contractVersionNumber records what was agreed to and when.
contractVersionNumberWhich version of that contract the customer accepted.
statementPeriodWhich statement period the card is billed on. The periods a product allows come from the reference data.
statementCurrencyCodeThe currency the statement is produced in.
statementSendingAddressTypeWhich kind of address that is.
statementPostFlagWhether the statement is posted on paper.
statementSmsSendFlagWhether the statement is announced by SMS.
statementEmailSendFlagWhether the statement is sent by e-mail.
statementSendAddressIdWhich of the customer's addresses the statement is posted to.
cardLimitValueThe spending limit to open the card with.
customerLimitValueThe limit for the customer behind the card, which the card's own limit draws against.
authorizationSmsSendFlagWhether an SMS is sent for each authorisation on the card.
authorizationSmsSendMinimumAmountThe amount an authorisation has to reach before that SMS is sent.
autoInstallmentCountHow many instalments a purchase is split into automatically, where the product allows it.
autoDeferringMonthCountHow many months a purchase is deferred automatically, where the product allows it.
autoLimitIncreaseFlagWhether the card takes part in automatic limit increases.
autoPaymentFlagWhether the card's debt is paid automatically. The account it is paid from is autoPaymentAccount, which is only read when this is true.
The account automatic payment draws on. Read only when autoPaymentFlag is true; otherwise no payment order is created.
applicationIdThe card application this request belongs to. Returned when an application is created, and carried through the card that comes out of it.
applicationDateA 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.
applicationContractIdThe contract record in the application system that this card comes from.
CreateIndividualCardResponse
recordIdThe identifier of the row the operation created or acted on. Returned rather than sent in most operations that carry it.
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.
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.
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.
What the operation wants to say about work it did anyway. A warning does not mean the operation failed.
The card number, expiry and verification value, returned only where the operation and the channel are entitled to them.
CreateIndividualCreditCardPermissions
eCommercePermittedWhether the card may be used online.
mailOrderPermittedWhether the card may be used for mail and telephone order.
internationalPurchasePermittedWhether the card may be used abroad.
CreateIndividualSupplementaryCardRequest
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.
productNumberProduct the supplementary card is issued on. Rejected when absent and when it matches no card product. It must then be on the platform's applicable-product list, that entry must name at least one channel, and it must name the channel this request is made from — the last two are refused against applicableProduct.ListOfApplicableChannel rather than against this field. Its segment must be Individual: a corporate product is refused here.
customerNumberCustomer the supplementary card belongs to. Rejected when absent and rejected again when it is zero, which is a separate check and a separate code from the null one.
shadowCardNumberThe main card's shadow number, not the supplementary card's — the supplementary card does not exist yet. The card it names must be a card master, and that master must carry a main customer, a limit, a product and a financial record; each is a separate refusal.
branchCodeBranch the application is made at. Rejected when absent and rejected again when it matches no branch.
digitalCardFlagAsk for the card to be issued as digital. Refused when the product has no digital card ability. A customer who has already reached the product's digital card allowance for the year is refused separately, as a business failure rather than on this field.
nameOnCardThe name embossed on the card. The services truncate to 26 characters before writing rather than refusing a longer one, so a name that matters should be checked at 26.
secondNameOnCardThe second embossed line, used for the company name on a corporate card.
cardDeliveryTypeConditional · NotNull — Where the card is delivered. Required when the product issues a physical card, and then it may not resolve to None. Not read for a card issued as digital only.
Values:
P— by postS— to the branch
Not set is "".
cardSendAddressTypeWhich of the customer's addresses the card is sent to. Only checked when a value is supplied, and then it may not resolve to None.
Values:
RA— homeAL— businessEA— employerOO— alternativeWA— previousSW— SWIFTSS— SWIFT name and addressMR— Mernis, registeredMS— Mernis, stated
Not set is --.
cardDeliveryBranchCodeConditional · NotNull — Branch the card is delivered to. Required when cardDeliveryType is the branch delivery type, and the branch it names must exist. Ignored otherwise.
cardSendAddressIdWhich of the customer's addresses to send the card to. The identifier of an address already held for that customer, not an address.
What the card may do: e-commerce, international purchases and mail order. Each is optional, and one left unset takes the platform's own default rather than being refused — for e-commerce that default follows digitalCardFlag.
The accounts to attach to the card as it is created. Each entry carries the account's own identifiers; attaching one later is attachCardAccount.
A miscellaneous option to set on the card, as a type-and-value pair. Only one may be sent at creation; changeCardMiscOption sets more.
Leaving it out does not leave the option unset. No row is written, but getCardMiscOption answers for a card that has none by returning the first value configured for that option type — so the card behaves as if it had been given that value. Which value that is comes from the option-type definition rather than from this API.
Replacing a card carries the option across. Where the replaced card had none, the platform writes DS / HardCopy onto the new one.
enrollMasterpassWhether to enrol the new card with Masterpass. Forwarded to the issuing service, which does the enrolment; the card is created either way.
contractTypeWhich cardholder contract the customer accepted. The pair with contractVersionNumber records what was agreed to and when.
contractVersionNumberWhich version of that contract the customer accepted.
cardLimitValueThe spending limit to open the card with.
authorizationSmsSendFlagWhether an SMS is sent for each authorisation on the card.
authorizationSmsSendMinimumAmountThe amount an authorisation has to reach before that SMS is sent.
autoInstallmentCountHow many instalments a purchase is split into automatically, where the product allows it.
autoDeferringMonthCountHow many months a purchase is deferred automatically, where the product allows it.
applicationIdThe card application this request belongs to. Returned when an application is created, and carried through the card that comes out of it.
applicationDateApplication Date
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.
applicationContractIdThe contract record in the application system that this card comes from.
CreateIndividualSupplementaryCardResponse
recordIdThe identifier of the row the operation created or acted on. Returned rather than sent in most operations that carry it.
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.
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.
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.
What the operation wants to say about work it did anyway. A warning does not mean the operation failed.
The card number, expiry and verification value, returned only where the operation and the channel are entitled to them.
CreateNoNameCardAccount
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.
accountTypeValues:
A— main accountV— virement
accountOrderFlagNot read when sent. Attaching an account has the line commented out, and card creation writes false whatever is sent. The account listings return the stored value.
currencyCodeThe currency of the amount, as its three-letter code.
CreateNoNameCardPermissions
eCommercePermittedWhether the card may be used online.
mailorderPermittedinternationalPurchasePermittedWhether the card may be used abroad.
CreateNoNameCardRequest
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.
productNumberThe card product the card is issued on. Defined in the parameter tables; getCardProductList returns the ones a tenant may use.
barcodeThe delivery barcode the consignment is tracked by.
customerNumberThe 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.
mainCustomerNumberThe main customer of a corporate relationship, as a number. The employees and supplementary holders under it carry their own customerNumber.
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.
branchCodeThe branch the card is opened at, as a number. Held as a number rather than text throughout.
cardSendAddressTypeValues:
RA— homeAL— businessEA— employerOO— alternativeWA— previousSW— SWIFTSS— SWIFT name and addressMR— Mernis, registeredMS— Mernis, stated
Not set is --.
enrollMasterpassWhether to enrol the new card with Masterpass. Forwarded to the issuing service, which does the enrolment; the card is created either way.
What the card may do: e-commerce, international purchases and mail order. Each is optional, and one left unset takes the platform's own default rather than being refused — for e-commerce that default follows digitalCardFlag.
The accounts to attach to the card as it is created. Each entry carries the account's own identifiers; attaching one later is attachCardAccount.
contractTypeWhich cardholder contract the customer accepted. The pair with contractVersionNumber records what was agreed to and when.
statementPeriodWhich statement period the card is billed on. The periods a product allows come from the reference data.
statementCurrencyCodeThe currency the statement is produced in.
cardLimitValueThe spending limit to open the card with.
customerLimitValueThe limit for the customer behind the card, which the card's own limit draws against.
autoLimitIncreaseFlagWhether the card takes part in automatic limit increases.
applicationIdThe card application this request belongs to. Returned when an application is created, and carried through the card that comes out of it.
applicationDateA 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.
applicationContractIdThe contract record in the application system that this card comes from.
CreateNoNameCardResponse
recordIdThe identifier of the row the operation created or acted on. Returned rather than sent in most operations that carry it.
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.
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.
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.
What the operation wants to say about work it did anyway. A warning does not mean the operation failed.
The card number, expiry and verification value, returned only where the operation and the channel are entitled to them.
CreateVirtualCardRequest
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.
shadowCardNumberThe related card's shadow number — the card the virtual card draws on. Its status must allow a virtual card, and it must carry a financial record and an available limit.
limitTypeHow the virtual card's limit behaves. Rejected when blank, and rejected when it resolves to None — that second refusal carries the code InvalidLimitType, which the service builds by hand rather than taking from ValidationErrorCodes.
Values:
S— fixed — the limit stays as setH— decreasing — each transaction reduces it
Not set is N.
endOfDayFlagConditional · NotNull — Whether the limit is released at end of day. Required when limitType is the fixed type, and checked in a second pass after the other fields have passed — so a request missing both this and limitType is refused for limitType first.
limitDefault — Defaults to 0. The virtual card's limit. It may not exceed the related card's available limit.
enrollMasterpassWhether to enrol the new card with Masterpass. Forwarded to the issuing service, which does the enrolment; the card is created either way.
CreateVirtualCardResponse
recordIdThe identifier of the row the operation created or acted on. Returned rather than sent in most operations that carry it.
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.
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.
relatedCardRefNumberThe card this one is related to, where it is.
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.
What the operation wants to say about work it did anyway. A warning does not mean the operation failed.
The card number, expiry and verification value, returned only where the operation and the channel are entitled to them.
CreditCardCollectionInfo
delayDayCountlastStatementMinAmountlastPaymentAmountlastPaymentDateA 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.
statementDateA 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.
totalDebitstatementTotalAmountWhat the statement comes to.
remainingMinimumPaymentAmountstatementDueDateA 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.
totalAmountThe amount of every entry in the list added together.
totalAmountForCreditTransactionstotalAmountForDebitTransactionscustomerLimitThe limit of the customer behind the card.
cardOpeningDateA 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.
statementRemainAmountWhat is left of the statement.
cardLimitThe card's own spending limit.
cardAvailableLimitHow much of the card's limit is left.
nextStatementDateA 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.
minimumPaymentAmountThe least that may be paid this period.
supplementaryCardFlagWhether this is a supplementary card rather than a main one.
currentCardFlaghasCardAutoPaymentautoPaymentAccountNumbercustomerNumberThe 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.
remainingDebtWhat is still owed.
branchCodeThe branch the card is opened at, as a number. Held as a number rather than text throughout.
branchNameThe branch's name.
productNumberThe card product the card is issued on. Defined in the parameter tables; getCardProductList returns the ones a tenant may use.
productSegmentValues:
B— individualT— corporate
Not set is "".
productNameThe card product's full name.
subProductTypemaskedCardNumberThe 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.
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.
guarantorstatementCurrencyCodeThe currency the statement is produced in.
transferedCardNumberTextcardStatusDescriptiondelinquencyStatusValues:
N— normalD— delinquent for the periodG— delinquent
delinquencyStartDateA 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.
reconstructAmountCreditCardCollectionTransactionItem
customerNumberThe 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.
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.
transactionNumbertransactionTypedebitCreditIndicatoramountThe amount.
CreditCardCurrentPeriodTransactionModel
totalAmountThe amount of every entry in the list added together.
currentDebtWhat is owed as of now.
remaingStatementDebtWhat is left of the statement's debt.
estimatedStatementDebtcurrencyCodeThe currency of the amount, as its three-letter code.
CreditCardCurrentPeriodTransactionModels
totalAmountThe amount of every entry in the list added together.
currentDebtWhat is owed as of now.
remaingStatementDebtWhat is left of the statement's debt.
estimatedStatementDebtcurrencyCodeThe currency of the amount, as its three-letter code.
CreditCardDetailTransactionItem
amountThe amount.
trnAmountThe amount of the transaction, in its own currency.
dateA 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.
isDeferrableWhether the transaction may be deferred.
isSplittableIntoInstallmentsWhether the transaction may be split into instalments.
totalInstallmentCountHow many instalments the plan has in all.
currentInstallmentNumberWhich instalment the plan has reached.
cardProductVirtualFlagWhether the product is a virtual one.
cardProductDigitalFlagWhether the product can be issued digitally.
supplementaryCardFlagWhether this is a supplementary card rather than a main one.
installOrderedFlagWhether an instalment plan has been asked for.
orderedInstallCountHow many instalments were asked for.
orderedDeferCountHow many months of deferral were asked for.
recordIdThe identifier of the row the operation created or acted on. Returned rather than sent in most operations that carry it.
earlyReleaseOrderedFlagWhether early settlement has been asked for.
statementFlagWhether the transaction has reached a statement.
digitalSlipFlagWhether a digital receipt was produced.
remainingInstallAmountutidThe unique transaction identifier the platform gives a transaction, and the handle every later operation on it takes. Returned by the transaction listings.
authorizationNumberThe authorisation code the issuer returned when the transaction was approved. Six characters, from the scheme.
panEntryModeHow the card was read at the terminal — chip, stripe, contactless, keyed, or stored on file. The scheme's own code.
panEntryModeDescriptionThe description of panEntryMode, carried alongside it for display. It is not a key: match on the code.
rrnThe retrieval reference number — the card scheme's handle for the transaction, and what a bank quotes when asking the scheme about it.
currencyCodeThe currency of the amount, as its three-letter code.
trnCurrencyCodeThe currency the transaction was made in.
descriptionThe error in words. errorCode is the part to match on; this is for a log or a screen.
What the transaction earned.
trnCodeMatrixIdWhich row of the transaction-code matrix this transaction was classified by.
trnCodeMatrixDescriptionThe description of trnCodeMatrixId, carried alongside it for display. It is not a key: match on the code.
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.
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.
capitalRewardIndicatorWhether the reward counts towards the capital scheme.
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.
mCCGroupDescriptionThe description of mccGroupCode, carried alongside it for display. It is not a key: match on the code.
mccDescriptionThe description of mcc, carried alongside it for display. It is not a key: match on the code.
trnEffectWhether the transaction adds to the balance or takes from it.
channelTypeThe channel a limit row applies to, which is not the channel the request is made on.
channelTypeDescriptionThe description of channelType, carried alongside it for display. It is not a key: match on the code.
sourceNetworkWhich network the transaction arrived over.
networkTypeDescriptionbkmUniqueMerchantIdThe merchant's identifier at BKM, the domestic switch.
digitalSlipValueThe digital receipt itself.
currentEodDateA 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.
feeAmountThe fee charged on the transaction.
bsmvAmountThe BSMV levy on the transaction.
kkdfAmountThe KKDF levy on the transaction.
installmentFeeAmountThe fee charged for splitting into instalments.
installmentProfitAmountThe interest charged across the instalments.
merchantNameThe merchant's name as it reached the platform from the scheme.
merchantNumberThe merchant's number with the acquirer.
nextStatementDateA 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.
nextDueDateA 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.
CreditCardDetailTransactionItems
amountThe amount.
trnAmountThe amount of the transaction, in its own currency.
dateA 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.
isDeferrableWhether the transaction may be deferred.
isSplittableIntoInstallmentsWhether the transaction may be split into instalments.
totalInstallmentCountHow many instalments the plan has in all.
currentInstallmentNumberWhich instalment the plan has reached.
cardProductVirtualFlagWhether the product is a virtual one.
cardProductDigitalFlagWhether the product can be issued digitally.
supplementaryCardFlagWhether this is a supplementary card rather than a main one.
remainingInstallAmountutidThe unique transaction identifier the platform gives a transaction, and the handle every later operation on it takes. Returned by the transaction listings.
currencyCodeThe currency of the amount, as its three-letter code.
trnCurrencyCodeThe currency the transaction was made in.
trnCodeMatrixIdWhich row of the transaction-code matrix this transaction was classified by.
descriptionThe error in words. errorCode is the part to match on; this is for a log or a screen.
What the transaction earned.
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.
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.
capitalRewardIndicatorWhether the reward counts towards the capital scheme.
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.
trnEffectWhether the transaction adds to the balance or takes from it.
bkmUniqueMerchantIdThe merchant's identifier at BKM, the domestic switch.
trnCodeWhat kind of transaction this is, as the platform's own code.
trnCodeDescriptionThe description of trnCode, carried alongside it for display. It is not a key: match on the code.
channelTypeThe channel a limit row applies to, which is not the channel the request is made on.
channelDescriptionThe description of channelType, carried alongside it for display. It is not a key: match on the code.
CreditCardIntermTransactionItem
pageNumberWhich page of results to return, counting from 1.
rowCountHow many rows a page holds.
amountThe amount.
trnAmountThe amount of the transaction, in its own currency.
dateA 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.
isDeferrableWhether the transaction may be deferred.
isSplittableIntoInstallmentsWhether the transaction may be split into instalments.
totalInstallmentCountHow many instalments the plan has in all.
currentInstallmentNumberWhich instalment the plan has reached.
cardProductVirtualFlagWhether the product is a virtual one.
cardProductDigitalFlagWhether the product can be issued digitally.
supplementaryCardFlagWhether this is a supplementary card rather than a main one.
installOrderedFlagWhether an instalment plan has been asked for.
orderedInstallCountHow many instalments were asked for.
orderedDeferCountHow many months of deferral were asked for.
recordIdThe identifier of the row the operation created or acted on. Returned rather than sent in most operations that carry it.
earlyReleaseOrderedFlagWhether early settlement has been asked for.
statementFlagWhether the transaction has reached a statement.
digitalSlipFlagWhether a digital receipt was produced.
utidThe unique transaction identifier the platform gives a transaction, and the handle every later operation on it takes. Returned by the transaction listings.
authorizationNumberThe authorisation code the issuer returned when the transaction was approved. Six characters, from the scheme.
panEntryModeHow the card was read at the terminal — chip, stripe, contactless, keyed, or stored on file. The scheme's own code.
panEntryModeDescriptionThe description of panEntryMode, carried alongside it for display. It is not a key: match on the code.
rrnThe retrieval reference number — the card scheme's handle for the transaction, and what a bank quotes when asking the scheme about it.
currencyCodeThe currency of the amount, as its three-letter code.
trnCurrencyCodeThe currency the transaction was made in.
descriptionThe error in words. errorCode is the part to match on; this is for a log or a screen.
What the transaction earned.
trnCodeMatrixIdWhich row of the transaction-code matrix this transaction was classified by.
trnCodeMatrixDescriptionThe description of trnCodeMatrixId, carried alongside it for display. It is not a key: match on the code.
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.
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.
capitalRewardIndicatorWhether the reward counts towards the capital scheme.
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.
mCCGroupDescriptionThe description of mccGroupCode, carried alongside it for display. It is not a key: match on the code.
mccDescriptionThe description of mcc, carried alongside it for display. It is not a key: match on the code.
trnEffectWhether the transaction adds to the balance or takes from it.
channelTypeThe channel a limit row applies to, which is not the channel the request is made on.
channelTypeDescriptionThe description of channelType, carried alongside it for display. It is not a key: match on the code.
sourceNetworkWhich network the transaction arrived over.
networkTypeDescriptionbkmUniqueMerchantIdThe merchant's identifier at BKM, the domestic switch.
digitalSlipValueThe digital receipt itself.
currentEodDateA 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.
feeAmountThe fee charged on the transaction.
bsmvAmountThe BSMV levy on the transaction.
kkdfAmountThe KKDF levy on the transaction.
installmentFeeAmountThe fee charged for splitting into instalments.
installmentProfitAmountThe interest charged across the instalments.
merchantNameThe merchant's name as it reached the platform from the scheme.
merchantNumberThe merchant's number with the acquirer.
nextStatementDateA 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.
nextDueDateA 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.
CreditCardModel
supplementaryCardFlagWhether this is a supplementary card rather than a main one.
cardRefCurrentCardFlagWhether this is the card currently in force under its reference, as opposed to one it replaced.
branchCodeThe branch the card is opened at, as a number. Held as a number rather than text throughout.
mainCardLimitcardLimitThe card's own spending limit.
customerLimitThe limit of the customer behind the card.
cardCashLimitcardAvailableLimitHow much of the card's limit is left.
cardAvailableCashLimitcustomerAvailableLimitHow much of the customer's limit is left.
customerAvailableCashLimitstatementTotalAmountWhat the statement comes to.
statementMinAmountThe least that may be paid against the statement.
statementTotalCurrentstatementTotalDueDatevirtualFlagWhether the card is a virtual one.
emvFlagWhether the card carries a chip.
magneticStripeFlagWhether the card carries a magnetic stripe.
contactlessFlagWhether the card can be used contactlessly.
rewardEarningFlagWhether the transaction earned a reward.
cvv2RetryCountHow many verification-value attempts are left before the card blocks.
pinRetryCountHow many PIN attempts are left before the card blocks.
remainingInstallmentAmounttotalDebtAmountcurrentDebtWhat is owed as of now.
cardAnnualFeeAmountThe annual fee the product carries.
limitUsedHow much of the limit has been used.
pendingReplaceApplicationExistsWhether a replacement has been asked for and not yet produced.
isDeliveredWhether the consignment reached the cardholder.
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.
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.
cardRefNumberThe card reference, which identifies one issued card including its renewals. Returned by the create and listing operations alongside the shadow number.
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.
customerNumberThe 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.
mainCustomerNumberThe main customer of a corporate relationship, as a number. The employees and supplementary holders under it carry their own customerNumber.
relatedCardRefNumberThe card this one is related to, where it is.
ownerNameThe cardholder's first name, as the customer record holds it.
ownerSecondNameThe cardholder's middle name, where there is one.
ownerSurnameThe cardholder's surname, as the customer record holds it.
embossNameThe name embossed on the card.
expireDatelimitTypeValues:
S— fixed — the limit stays as setH— decreasing — each transaction reduces it
Not set is N.
limitStartDateA 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.
limitEndDateA 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.
autoLimitIncreaseFlagWhether the card takes part in automatic limit increases.
mainMaskedCardNumberproductNumberThe card product the card is issued on. Defined in the parameter tables; getCardProductList returns the ones a tenant may use.
cardStatusCodeValues:
A— validB— pendingC— stolenD— cancelled by the bankF— fraudG— temporarily blockedI— cancelledL— lostM— cancelled by the customerT— corporate dummy
cardStatusCodeDescriptionThe description of cardStatusCode, carried alongside it for display. It is not a key: match on the code.
cardStatusReasonCodeWhy the status is being set. The valid reasons depend on the status: getAvailableCardStatusList returns the pairs a card may move to.
cardStatusReasonCodeDescriptionThe description of cardStatusReasonCode, carried alongside it for display. It is not a key: match on the code.
statementDateA 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.
dueDateA 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.
nextStatementDateA 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.
nextDueDateA 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.
productNameThe card product's full name.
productShortNameThe card product's short name, for a list or a statement line.
tenantIdWhich tenant's records to read. Omitting it reads the rows that belong to no tenant rather than all of them.
cardClosedDateA 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.
cardCloseReasonCodedelaydigitalCardFlagWhether to issue the card as a digital one. It also decides the default e-commerce permission where permissions leaves that unset.
cardBrandWhich scheme the card is issued on.
cardBrandDescriptionThe description of cardBrand, carried alongside it for display. It is not a key: match on the code.
statementCurrencyCodeThe currency the statement is produced in.
fromShadowCardNumberThe card this one replaced. Empty where the card is the first of its reference.
statementEurAmountstatementUsdAmountcardDeliveryTypeValues:
P— by postS— to the branch
Not set is "".
applicationDateA 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.
applicationChannelCodeapplicationChannelDescriptionThe description of applicationChannelCode, carried alongside it for display. It is not a key: match on the code.
barcodeThe delivery barcode the consignment is tracked by.
toShadowCardNumberThe card this one was replaced by, where it has been. Empty while it is still the current card.
embossReasonCodeValues:
N— new cardY— renewal
embossReasonDescriptionThe description of embossReasonCode, carried alongside it for display. It is not a key: match on the code.
embossReasonSubCodeValues:
BRK— broken cardCHF— damaged chipEXP— renewal at maturityFRD— fraudMGF— magnetic stripe errorNSU— name updateOTH— otherEXO— bulk renewal at maturityLST— lost cardSTL— stolen card
Not set is ---.
embossReasonSubDescThe description of embossReasonSubCode, carried alongside it for display. It is not a key: match on the code.
cardStatusChangeDateA 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.
lastTrnDateA 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.
firstPinSetDateA 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.
lastPinSetDateA 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.
lastPinChangeDateA 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.
isFirstPinSetWhether the cardholder has set a PIN yet.
deliveryAddressWhere the card is to be delivered, as written.
sendingBranchCodeThe branch the card is sent from.
sendingAddressTypeValues:
RA— homeAL— businessEA— employerOO— alternativeWA— previousSW— SWIFTSS— SWIFT name and addressMR— Mernis, registeredMS— Mernis, stated
Not set is --.
productGroupCodeWhich group of products this one belongs to.
productGroupDescriptionThe description of productGroupCode, carried alongside it for display. It is not a key: match on the code.
fromMaskedCardNumbertoMaskedCardNumberThe replacing card, in its masked form.
customerTypeValues:
1— corporate2— individual3— employee4— sole proprietorship
Not set is N.
The accounts the card draws on.
Filled only for a digital or virtual card. On a physical card it is null.
totalDebtAmountUSDtotalDebtAmountEURstatementCurrencyThe currency the statement is produced in.
statementPeriodWhich statement period the card is billed on. The periods a product allows come from the reference data.
cardStatusChangeChannelWhich channel last changed the card's status.
securityFlagWhether the card is under a security restriction.
currentAmountcurrentAmountWithDailyPaymentCreditCardNextPeriodInstallmentModel
totalAmountThe amount of every entry in the list added together.
currencyCodeThe currency of the amount, as its three-letter code.
CreditCardPendingTransactionItem
amountThe amount.
trnAmountThe amount of the transaction, in its own currency.
dateA 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.
isDeferrableWhether the transaction may be deferred.
isSplittableIntoInstallmentsWhether the transaction may be split into instalments.
totalInstallmentCountHow many instalments the plan has in all.
currentInstallmentNumberWhich instalment the plan has reached.
cardProductVirtualFlagWhether the product is a virtual one.
cardProductDigitalFlagWhether the product can be issued digitally.
supplementaryCardFlagWhether this is a supplementary card rather than a main one.
installOrderedFlagWhether an instalment plan has been asked for.
orderedInstallCountHow many instalments were asked for.
orderedDeferCountHow many months of deferral were asked for.
recordIdThe identifier of the row the operation created or acted on. Returned rather than sent in most operations that carry it.
earlyReleaseOrderedFlagWhether early settlement has been asked for.
statementFlagWhether the transaction has reached a statement.
digitalSlipFlagWhether a digital receipt was produced.
approvedAuthorizationFlagresponseCodeThe 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.
responseCodeDescriptionThe description of responseCode, carried alongside it for display. It is not a key: match on the code.
responseReasonCodeWhy the downstream system answered as it did, where it narrows the response code.
responseReasonCodeDescriptionThe description of responseReasonCode, 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.
authorizationNumberThe authorisation code the issuer returned when the transaction was approved. Six characters, from the scheme.
panEntryModeHow the card was read at the terminal — chip, stripe, contactless, keyed, or stored on file. The scheme's own code.
panEntryModeDescriptionThe description of panEntryMode, carried alongside it for display. It is not a key: match on the code.
rrnThe retrieval reference number — the card scheme's handle for the transaction, and what a bank quotes when asking the scheme about it.
currencyCodeThe currency of the amount, as its three-letter code.
trnCurrencyCodeThe currency the transaction was made in.
descriptionThe error in words. errorCode is the part to match on; this is for a log or a screen.
What the transaction earned.
trnCodeMatrixIdWhich row of the transaction-code matrix this transaction was classified by.
trnCodeMatrixDescriptionThe description of trnCodeMatrixId, carried alongside it for display. It is not a key: match on the code.
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.
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.
capitalRewardIndicatorWhether the reward counts towards the capital scheme.
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.
mCCGroupDescriptionThe description of mccGroupCode, carried alongside it for display. It is not a key: match on the code.
mccDescriptionThe description of mcc, carried alongside it for display. It is not a key: match on the code.
trnEffectWhether the transaction adds to the balance or takes from it.
channelTypeThe channel a limit row applies to, which is not the channel the request is made on.
channelTypeDescriptionThe description of channelType, carried alongside it for display. It is not a key: match on the code.
sourceNetworkWhich network the transaction arrived over.
networkTypeDescriptionbkmUniqueMerchantIdThe merchant's identifier at BKM, the domestic switch.
digitalSlipValueThe digital receipt itself.
currentEodDateA 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.
feeAmountThe fee charged on the transaction.
bsmvAmountThe BSMV levy on the transaction.
kkdfAmountThe KKDF levy on the transaction.
installmentFeeAmountThe fee charged for splitting into instalments.
installmentProfitAmountThe interest charged across the instalments.
merchantNameThe merchant's name as it reached the platform from the scheme.
merchantNumberThe merchant's number with the acquirer.
nextStatementDateA 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.
nextDueDateA 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.
CreditCardPermissions
restrictionCodeValues:
SA— purchaseNA— cashDN— domestic cashYD— international saleYN— international cashAT— ATMMO— mail orderEC— e-commerce, fully secureEN— e-commerce, half secureEX— e-commerce, not secureCLS— contactlessTA— instalmentPTH— pre-authorisationQC— quasi cashCB— POS cashbackCSB— cashbackTCS— POS cash advanceFA— bill paymentVG— tax paymentCEK— chequeFF— FastFundPPP— project sharing programme
restrictionCodeDescriptionThe description of restrictionCode, carried alongside it for display. It is not a key: match on the code.
restrictionPermissionIndicatorWhether the entry grants the capability or withholds it.
restrictionPermissionIndicatorDescriptionThe description of restrictionPermissionIndicator, carried alongside it for display. It is not a key: match on the code.
channelWhich channel this restriction covers, not the channel reading it. Empty where the restriction applies to every channel.
securityFlagWhether the card is under a security restriction.
CreditCardStatementItem
recordIdThe identifier of the row the operation created or acted on. Returned rather than sent in most operations that carry it.
statementDebtWhat the statement says is owed.
minimumPaymentAmountThe least that may be paid this period.
remainingDebtWhat is still owed.
prevTotalAmountWhat the total came to before this change.
statementDateA 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.
dueDateA 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.
nextStatementDateA 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.
nextDueDateA 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.
remainingMinimumPaymentDebtWhat is left of the minimum payment.
currencyCodeThe currency of the amount, as its three-letter code.
The transactions the search matched.
CreditCardStatementSendPreference
statementEMailSendFlagstatementPostingFlagWhether the statement is posted on paper.
statementSmsSendFlagWhether the statement is announced by SMS.
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.
postingAddressTypeWhich kind of address the statement is posted to.
CreditCardTransactionItem
amountThe amount.
trnAmountThe amount of the transaction, in its own currency.
dateA 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.
isDeferrableWhether the transaction may be deferred.
isSplittableIntoInstallmentsWhether the transaction may be split into instalments.
totalInstallmentCountHow many instalments the plan has in all.
currentInstallmentNumberWhich instalment the plan has reached.
cardProductVirtualFlagWhether the product is a virtual one.
cardProductDigitalFlagWhether the product can be issued digitally.
supplementaryCardFlagWhether this is a supplementary card rather than a main one.
installOrderedFlagWhether an instalment plan has been asked for.
orderedInstallCountHow many instalments were asked for.
orderedDeferCountHow many months of deferral were asked for.
recordIdThe identifier of the row the operation created or acted on. Returned rather than sent in most operations that carry it.
earlyReleaseOrderedFlagWhether early settlement has been asked for.
statementFlagWhether the transaction has reached a statement.
digitalSlipFlagWhether a digital receipt was produced.
utidThe unique transaction identifier the platform gives a transaction, and the handle every later operation on it takes. Returned by the transaction listings.
authorizationNumberThe authorisation code the issuer returned when the transaction was approved. Six characters, from the scheme.
panEntryModeHow the card was read at the terminal — chip, stripe, contactless, keyed, or stored on file. The scheme's own code.
panEntryModeDescriptionThe description of panEntryMode, carried alongside it for display. It is not a key: match on the code.
rrnThe retrieval reference number — the card scheme's handle for the transaction, and what a bank quotes when asking the scheme about it.
currencyCodeThe currency of the amount, as its three-letter code.
trnCurrencyCodeThe currency the transaction was made in.
descriptionThe error in words. errorCode is the part to match on; this is for a log or a screen.
What the transaction earned.
trnCodeMatrixIdWhich row of the transaction-code matrix this transaction was classified by.
trnCodeMatrixDescriptionThe description of trnCodeMatrixId, carried alongside it for display. It is not a key: match on the code.
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.
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.
capitalRewardIndicatorWhether the reward counts towards the capital scheme.
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.
mCCGroupDescriptionThe description of mccGroupCode, carried alongside it for display. It is not a key: match on the code.
mccDescriptionThe description of mcc, carried alongside it for display. It is not a key: match on the code.
trnEffectWhether the transaction adds to the balance or takes from it.
channelTypeThe channel a limit row applies to, which is not the channel the request is made on.
channelTypeDescriptionThe description of channelType, carried alongside it for display. It is not a key: match on the code.
sourceNetworkWhich network the transaction arrived over.
networkTypeDescriptionbkmUniqueMerchantIdThe merchant's identifier at BKM, the domestic switch.
digitalSlipValueThe digital receipt itself.
currentEodDateA 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.
feeAmountThe fee charged on the transaction.
bsmvAmountThe BSMV levy on the transaction.
kkdfAmountThe KKDF levy on the transaction.
installmentFeeAmountThe fee charged for splitting into instalments.
installmentProfitAmountThe interest charged across the instalments.
merchantNameThe merchant's name as it reached the platform from the scheme.
merchantNumberThe merchant's number with the acquirer.
nextStatementDateA 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.
nextDueDateA 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.
CreditCardTransactionItems
amountThe amount.
trnAmountThe amount of the transaction, in its own currency.
dateA 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.
isDeferrableWhether the transaction may be deferred.
isSplittableIntoInstallmentsWhether the transaction may be split into instalments.
totalInstallmentCountHow many instalments the plan has in all.
currentInstallmentNumberWhich instalment the plan has reached.
cardProductVirtualFlagWhether the product is a virtual one.
cardProductDigitalFlagWhether the product can be issued digitally.
supplementaryCardFlagWhether this is a supplementary card rather than a main one.
utidThe unique transaction identifier the platform gives a transaction, and the handle every later operation on it takes. Returned by the transaction listings.
currencyCodeThe currency of the amount, as its three-letter code.
trnCurrencyCodeThe currency the transaction was made in.
trnCodeMatrixIdWhich row of the transaction-code matrix this transaction was classified by.
descriptionThe error in words. errorCode is the part to match on; this is for a log or a screen.
What the transaction earned.
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.
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.
capitalRewardIndicatorWhether the reward counts towards the capital scheme.
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.
trnEffectWhether the transaction adds to the balance or takes from it.
bkmUniqueMerchantIdThe merchant's identifier at BKM, the domestic switch.
trnCodeWhat kind of transaction this is, as the platform's own code.
trnCodeDescriptionThe description of trnCode, carried alongside it for display. It is not a key: match on the code.
channelTypeThe channel a limit row applies to, which is not the channel the request is made on.
channelDescriptionThe description of channelType, carried alongside it for display. It is not a key: match on the code.
CreditCorporateCustomerInfo
mainCustomerNumberThe main customer of a corporate relationship, as a number. The employees and supplementary holders under it carry their own customerNumber.
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.
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.
CustomerAssetInfo
currentCardcustomerNumberThe 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.
digitalCardmainCustomerNumberThe main customer of a corporate relationship, as a number. The employees and supplementary holders under it carry their own customerNumber.
supplementaryCardWhether this is a supplementary card rather than a main one.
cardRefNumberThe card reference, which identifies one issued card including its renewals. Returned by the create and listing operations alongside the shadow number.
cardStatusCodeValues:
A— validB— pendingC— stolenD— cancelled by the bankF— fraudG— temporarily blockedI— cancelledL— lostM— cancelled by the customerT— corporate dummy
cardStatusReasonCodeWhy the status is being set. The valid reasons depend on the status: getAvailableCardStatusList returns the pairs a card may move to.
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.
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.
productNumberThe card product the card is issued on. Defined in the parameter tables; getCardProductList returns the ones a tenant may use.
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.
statementCurrencyCodeThe currency the statement is produced in.
statementPeriodWhich statement period the card is billed on. The periods a product allows come from the reference data.
statementPeriodDescriptionThe description of statementPeriod, carried alongside it for display. It is not a key: match on the code.
nextStatementDateCustomerLimitationParameterData
customerNumberThe 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.
customerLimitationFlagWhether the card draws against the customer's limit rather than having one of its own.
profileCodeWhich profile the card's limits come from.
profileDescriptionThe description of profileCode, carried alongside it for display. It is not a key: match on the code.
Which limit row this is: the transaction group, the network and the channel together identify one. The descriptions beside each code are returned for display and are not part of the key.
perTrnAmountThe most the card may spend in one transaction.
perTrnAmountLimitRatioThe same cap as a share of the card's limit rather than an amount.
dailyTrnCountThe most transactions the card may make in a day.
dailyTrnAmountThe most the card may spend in a day.
weeklyTrnCountThe most transactions the card may make in a week.
weeklyTrnAmountThe most the card may spend in a week.
monthlyTrnCountThe most transactions the card may make in a month.
monthlyTrnAmountThe most the card may spend in a month.
yearlyTrnCountThe most transactions the card may make in a year.
yearlyTrnAmountThe most the card may spend in a year.
cardTypeWhich kind of card, as the one-letter code the account type carries: C credit, D debit, P prepaid.
DecreaseCustomerLimitRequest
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.
customerNumberCustomer whose limit is decreased. Negative and zero are refused separately, both with the message CustomerNumber Is Invalid. Omitting the field is the same as sending zero and arrives as the zero failure; the null check beside those two is dead.
newCustomerLimitRequired in practice — The limit to decrease to. Not validated here — the facade's null check on it cannot fail, and there is no range check, so zero passes. Whether the value is an acceptable new limit is the credit limit service's decision, and that service was not read for this path.
skipReverseWhenLksFailedDefault false — Whether to keep the decrease when the LKS call fails instead of reversing it. Null is read as false.
DecreaseCustomerLimitResponse
listOfCustomerLimitChangeLogIdThe customer limit changes to reverse, by the log id each change returned.
listOfCardLimitChangeLogIdThe limit changes to reverse, by the log id each change returned.
DetachCardAccountByAccountNumberRequest
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.
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.
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.
accountSuffixThe suffix that distinguishes one account from another under the same number at core banking.
DetachCardAccountRequest
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.
recordIdThe card-to-account link being removed, by its record id — not the account number. A sibling operation detaches by account number instead, and it is a different request.
shadowCardNumberThe card the account is unlinked from.
DetachCardAccountResponse
recordIdThe identifier of the row the operation created or acted on. Returned rather than sent in most operations that carry it.
DisputeList
CaseNumberThe dispute case this belongs to.
CustomerNumberThe 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.
DisputeAmountDisputeCurrencyCodeDisputeDateA 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.
DisputeReasonCodeWhy the case was raised.
DisputeTransactionIdThe disputed transaction within the case.
InsertUserIdAn audit column the platform fills in. It is on the request because the contract was generated from the table, and a value sent here is replaced.
MaskedCardNumberThe card number with its middle digits masked, as the platform stores it. It is a display form, not a key.
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.
MerchantNameThe merchant's name as it reached the platform from the scheme.
TrnAmountThe amount of the transaction, in its own currency.
TrnCurrencyCodeThe currency the transaction was made in.
TrnDateA 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.
TrnStatusDescriptionThe transaction's state in words.
AuthorizationNumberThe authorisation code the issuer returned when the transaction was approved. Six characters, from the scheme.
MccThe merchant category code — the four-digit code the scheme classifies the merchant's trade with.
SourceNetworkWhich network the transaction arrived over.
UtidThe unique transaction identifier the platform gives a transaction, and the handle every later operation on it takes. Returned by the transaction listings.
DisputeReasonDefinitions
DisputeReasonCodeWhy the case was raised.
DisputeReasonDescriptionThe description of DisputeReasonCode, carried alongside it for display. It is not a key: match on the code.
DisputeTransactionDetail
DisputeTransactionIdThe disputed transaction within the case.
UTIDThe unique transaction identifier the platform gives a transaction, and the handle every later operation on it takes. Returned by the transaction listings.
DmsReference
DmsReferenceIdIdentifier of a document held in the document management system, and the only part of the entry that is forwarded. The local route inserts it into CMS_DIS.CASE_DOCUMENT, which is the one table in that schema with no generated entity, so no length for it is declared anywhere in the code.
DmsReferences
DmsReferenceIdIdentifier of a document held in the document management system, and the only part of the entry that is forwarded.
DoCashAdvanceRequest
channelIdThree-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.
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.
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.
An account at the bank's core banking system rather than a column here, so its format is the core's: no table behind these APIs holds an account number as text, and most of this platform's own requests type it as a number. The platform stores iban and accountAlias instead, and publishes a width for both.
referenceNumberThe caller's own reference for the withdrawal, forwarded to the authorisation service. It is the value reverseCashAdvance takes to undo this one.
cashAdvanceAmountRequired in practice — The amount to withdraw. Not validated here; forwarded unchanged. No quote has to have been taken first and nothing here compares the two.
DoCashAdvanceResponse
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.
feeAmountThe fee charged on the transaction.
uTIDThe unique transaction identifier the platform gives a transaction, and the handle every later operation on it takes. Returned by the transaction listings.
authCodeThe authorisation code the issuer returned when the transaction was approved. Six characters, from the scheme.
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.
responseReasonCodeWhy the downstream system answered as it did, where it narrows the response code.
rrnThe retrieval reference number — the card scheme's handle for the transaction, and what a bank quotes when asking the scheme about it.
DoCashInstallmentEarlyReleasePaymentRequest
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.
amountEarly-release settlement amount.
clientReferenceNumberCaller business key for the payment.
shadowCardNumberCard the early-release payment is posted against.
currencyCodeISO currency of the payment.
cashInstallmentUtidUTID of the cash-installment plan being settled early.
The installment's own transaction identifier, carried through to the services that hold it.
accountNumberAccepted on the request; not mapped into the payment entity.
DoCashInstallmentEarlyReleasePaymentResponse
trnIdThe platform's identifier for the transaction row.
utidThe unique transaction identifier the platform gives a transaction, and the handle every later operation on it takes. Returned by the transaction listings.
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.
DoCashInstallmentRequest
channelIdThree-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.
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.
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.
An account at the bank's core banking system rather than a column here, so its format is the core's: no table behind these APIs holds an account number as text, and most of this platform's own requests type it as a number. The platform stores iban and accountAlias instead, and publishes a width for both.
referenceNumberThe caller's own reference for the transaction, carried into the institution transaction record. It is truncated to 50 characters rather than refused.
transactionAmountThe amount of the transaction.
installmentCountHow many instalments to split the amount across. The available counts for a card and amount come from the simulation operations.
DoCashInstallmentResponse
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.
feeAmountThe fee charged on the transaction.
uTIDThe unique transaction identifier the platform gives a transaction, and the handle every later operation on it takes. Returned by the transaction listings.
authCodeThe authorisation code the issuer returned when the transaction was approved. Six characters, from the scheme.
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.
responseReasonCodeWhy the downstream system answered as it did, where it narrows the response code.
reasonDescriptionThe downstream system's own wording for the refusal, passed through.
rrnThe retrieval reference number — the card scheme's handle for the transaction, and what a bank quotes when asking the scheme about it.
DoCreditCardDebtPaymentRequest
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.
amountDebt payment amount posted to the card.
clientReferenceNumberOptional — The caller's own reference for the payment, forwarded to transaction management.
shadowCardNumberOne-of — The card being paid. Send this or clearCardNumber: when this is empty the PAN is resolved to a shadow card number through the customer service first. The schema marks this field non-nullable, which is a C# value-type artefact rather than a rule — the code path for an empty one is live.
currencyCodeISO currency of the payment amount.
accountNumberAccepted on the request but not forwarded into the payment entity.
clearCardNumberOne-of — The card's PAN, used only when shadowCardNumber is empty. It is resolved to a shadow card number and the payment is written against that.
A card number is not stored by these services; the platform keeps a shadow card number instead.
descriptionFree-text description on the payment.
resourceCodeWhich row of the channel's payment matrix the transaction code comes from. An unrecognised value does not fail — it falls through. Only 0, 1, 2 and 3 select a row by code; anything else, including an absent value, selects the row whose own resource code is empty, then the channel's first row, then a built-in default. Four steps, no refusal at any of them.
earlyReleaseLogFlagForwarded to transaction management, which decides what it means. Nothing in this API reads it.
DoCreditCardDebtPaymentResponse
trnIdThe platform's identifier for the transaction row.
utidThe unique transaction identifier the platform gives a transaction, and the handle every later operation on it takes. Returned by the transaction listings.
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.
DoEarlyCloseRequest
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.
utidThe unique transaction identifier the platform gives a transaction, and the handle every later operation on it takes. Returned by the transaction listings.
feeAmountThe fee charged on the transaction.
earlyReleaseTypeWhich kind of early settlement is being asked for.
DoEarlyCloseResponse
erLogRecordIdshadowCardNumberThe 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.
DoPaymentFeeInquiryRequest
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.
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.
shadowCardNumberThe card the fee is calculated for.
institutionCodeInstitution / biller code.
referenceNumberCaller reference for the inquiry.
descriptionOptional description passed through to online.
DoPaymentFeeInquiryResponse
feeAmountThe fee charged on the transaction.
bsmvAmountThe BSMV levy on the transaction.
totalCommissionAmountuTIDThe unique transaction identifier the platform gives a transaction, and the handle every later operation on it takes. Returned by the transaction listings.
authCodeThe authorisation code the issuer returned when the transaction was approved. Six characters, from the scheme.
rrnThe retrieval reference number — the card scheme's handle for the transaction, and what a bank quotes when asking the scheme about it.
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.
responseReasonCodeWhy the downstream system answered as it did, where it narrows the response code.
responseCodeDescriptionThe description of responseCode, carried alongside it for display. It is not a key: match on the code.
DoPaymentTransactionRequest
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.
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.
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.
DoPaymentTransactionResponse
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.
uTIDThe unique transaction identifier the platform gives a transaction, and the handle every later operation on it takes. Returned by the transaction listings.
authCodeThe authorisation code the issuer returned when the transaction was approved. Six characters, from the scheme.
rrnThe retrieval reference number — the card scheme's handle for the transaction, and what a bank quotes when asking the scheme about it.
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.
responseReasonCodeWhy the downstream system answered as it did, where it narrows the response code.
responseCodeDescriptionThe description of responseCode, carried alongside it for display. It is not a key: match on the code.
EarlyCloseCandidateRow
customerNumberThe 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.
trnDateA 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.
totalInstallmentAmountWhat the instalments come to together.
totalCapitalAmounttotalInstallmentProfitAmounttotalTaxAmountinstallmentCountHow many instalments to split the amount across. The available counts for a card and amount come from the simulation operations.
deferringMonthCountHow many months the purchase is deferred by.
remainingInstallmentAmountremainingCapitalAmountremainingInstallmentProfitAmountremainingTaxAmountremainingInstallmentCountHow many instalments are still to run.
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.
authorizationNumberThe authorisation code the issuer returned when the transaction was approved. Six characters, from the scheme.
utidThe unique transaction identifier the platform gives a transaction, and the handle every later operation on it takes. Returned by the transaction listings.
Error
transactionIdThe platform's identifier for this call, for tracing it in the logs.
errorCodeThe platform's own code for the error, and what to match on.
descriptionThe error in words. errorCode is the part to match on; this is for a log or a screen.
messageThe error in words. errorCode is the part to match on.
messageFormatThe message before its arguments were substituted in, which is what groups two errors that differ only by their values.
argumentsThe values substituted into messageFormat.
propertyNameWhich field of the request the error is about.
detailMore about the error than message carries, where there is more.
The individual problems, where one error stands for several.
isTechnicalErrorWhether the failure is the platform's rather than the request's. A technical error is worth retrying; a business one is not.
exceptionTypeThe platform's internal exception class. Useful in a support conversation and not something to match on.
GenerateCardVVRequest
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.
shadowCardNumberThe card to generate a verification value for.
keyDerivationIndexWhich key the card's encrypted values were produced under. Returned with the card; a caller does not choose it.
binThe bank identification number — the leading digits of the card number that name the issuer and the product range.
expiryDateStrThe card's expiry as MMYY.
clearPanA card number is not stored by these services; the platform keeps a shadow card number instead.
GenerateCardVVResponse
hasErrorTrue when the generator could not produce a value. It reports several of its own failures this way — a key it cannot use, a value it cannot derive — and the call still returns 200, so read this before verificationValue. It is also true when the generator answers nothing at all.
errorTextThe error in words, for a log or a screen rather than for matching.
verificationValueThe card verification value. Computed and compared rather than stored, and returned only where the operation is entitled to it.
GetAllWaitingInstallmentsRequest
shadowCardNumberRequired in practice — The card to read. It is resolved to a card record before anything is read, and three separate failures of that resolution all answer with the same code — see the 400 table. It is not declared required because an absent value is refused as a business failure rather than as a missing field. The card's status is not checked, so a closed card still answers.
GetApplicableProductsByCustomerNumberRequest
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.
customerNumberCustomer whose applicable products are read. Three separate refusals: absent, zero, and negative each raise their own code.
mainCustomerNumberMain customer to read against. Not required, but when supplied it may be neither zero nor negative.
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.
Which rows to return. Left out, the operation returns them all.
GetApplicableProductsByCustomerNumberResponse
The products the search matched.
GetApplicableProductsByMainCustomerRequest
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.
mainCustomerNumberThe main customer the control is run for. Refused when absent, and when supplied it may be neither zero nor negative. The control is about this customer alone — no card or product is named anywhere in the request.
Mandatory here, unlike on getApplicableProductsByCustomerNumber where the same filter may be left out: the service refuses a request whose filter.productGroupCode is absent.
GetApplicableProductsByMainCustomerResponse
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.
GetApplicableProductsItem
digitalAbilityWhether the product can be issued as a digital card.
supplementaryCardWhether this is a supplementary card rather than a main one.
productNumberThe card product the card is issued on. Defined in the parameter tables; getCardProductList returns the ones a tenant may use.
productNameThe card product's full name.
productShortNameThe card product's short name, for a list or a statement line.
brandWhich scheme the card is issued on.
tenantIdWhich tenant's records to read. Omitting it reads the rows that belong to no tenant rather than all of them.
cardAnnualFeeAmountThe annual fee the product carries.
GetAvailableCardStatusListRequest
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.
shadowCardNumberThe card whose reachable statuses are listed. Which statuses come back depends on the card's current status and on the channel, so both fields change the answer.
GetAvailableCardStatusListResponseItem
statusCodeValues:
A— validB— pendingC— stolenD— cancelled by the bankF— fraudG— temporarily blockedI— cancelledL— lostM— cancelled by the customerT— corporate dummy
statusDescriptionThe description of statusCode, carried alongside it for display. It is not a key: match on the code.
reasonCodereasonDescriptionThe description of reasonCode, carried alongside it for display. It is not a key: match on the code.
GetCalculatedStatementPeriodRequest
newStatementCodeThe statement period to move the card to.
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.
GetCalculatedStatementPeriodResponse
firstStatementDateA 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.
nextStatementDateA 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.
GetCancelableCashAdvanceListRequest
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.
GetCancelableCashAdvanceModel
customerNumberThe 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.
mainCustomerNumberThe main customer of a corporate relationship, as a number. The employees and supplementary holders under it carry their own customerNumber.
trnAmountThe amount of the transaction, in its own currency.
trnDateA 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.
cardRefNumberThe card reference, which identifies one issued card including its renewals. Returned by the create and listing operations alongside the shadow number.
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.
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.
trnDescriptionThe transaction in words, as it reached the platform.
utidThe unique transaction identifier the platform gives a transaction, and the handle every later operation on it takes. Returned by the transaction listings.
GetCancelableCashInstallmentListRequest
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.
GetCancelableCashInstallmentModel
customerNumberThe 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.
mainCustomerNumberThe main customer of a corporate relationship, as a number. The employees and supplementary holders under it carry their own customerNumber.
trnAmountThe amount of the transaction, in its own currency.
trnDateA 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.
cardRefNumberThe card reference, which identifies one issued card including its renewals. Returned by the create and listing operations alongside the shadow number.
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.
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.
trnDescriptionThe transaction in words, as it reached the platform.
utidThe unique transaction identifier the platform gives a transaction, and the handle every later operation on it takes. Returned by the transaction listings.
GetCancelableCreditCardDebtPaymentListRequest
shadowCardNumberCard whose cancelable debt payments are listed. Empty throws 60002.
GetCancelablePaymentModel
customerNumberThe 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.
mainCustomerNumberThe main customer of a corporate relationship, as a number. The employees and supplementary holders under it carry their own customerNumber.
trnAmountThe amount of the transaction, in its own currency.
trnIdThe platform's identifier for the transaction row.
trnDateA 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.
cardRefNumberThe card reference, which identifies one issued card including its renewals. Returned by the create and listing operations alongside the shadow number.
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.
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.
trnCurrencyCodeThe currency the transaction was made in.
trnDescriptionThe description of trnId, 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.
GetCardAvailableLimitRequest
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.
cardRefNumberThe card reference, which identifies one issued card including its renewals. Returned by the create and listing operations alongside the shadow number.
GetCardAvailableLimitResponse
availableLimitHow much of the limit is left.
customerAvailableLimitHow much of the customer's limit is left.
availableCashLimitcustomerAvailableCashLimitlimitThe limit to set.
customerLimitThe limit of the customer behind the card.
cashLimitcustomerCashLimitlimitUsedHow much of the limit has been used.
customerLimitUsedcashLimitUsedcustomerCashLimitUsedsupplementaryCardWhether this is a supplementary card rather than a main one.
mainCardAvailableLimitmainCardAvailableCashLimitmainCardLimitmainCardCashLimitmainLimitUsedmainCashLimitUsedGetCardDelinquencyInfoByCustomerNumberRequest
mainCustomerNumberThe main customer of a corporate relationship, as a number. The employees and supplementary holders under it carry their own customerNumber.
GetCardDelinquencyInfoByCustomerNumberResponse
digitalCardLimitcustomerLimitThe limit of the customer behind the card.
delinquencyDayCountstatementRemainAmountWhat is left of the statement.
delinquencyPeriodHow many periods the account has been in arrears.
newDeficientPaymentCounterdayCoutAfterLimitIncreasedayCoutAfterLimitDecreasedelinquencyStatusValues:
N— normalD— delinquent for the periodG— delinquent
GetCardFinancialInfoByCardRefNumberRequest
cardRefNumberThe card reference, which identifies one issued card including its renewals. Returned by the create and listing operations alongside the shadow number.
customerNumberThe 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.
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.
GetCardIntermTransactionInfoRequest
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.
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.
addWaitingInstallmentsWhether instalments not yet billed are included.
pageNumberWhich page of results to return, counting from 1.
rowCountHow many rows a page holds.
GetCardLimitationParametersRequest
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.
GetCardListNewRequest
channelCodeThree-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.
customerNumberThe 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.
mainCustomerNumberThe main customer of a corporate relationship, as a number. The employees and supplementary holders under it carry their own customerNumber.
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.
barcodeThe delivery barcode the consignment is tracked by.
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.
cardNumberpurposecardStatusCodeValues:
A— validB— pendingC— stolenD— cancelled by the bankF— fraudG— temporarily blockedI— cancelledL— lostM— cancelled by the customerT— corporate dummy
cardStatusReasonCodeWhy the status is being set. The valid reasons depend on the status: getAvailableCardStatusList returns the pairs a card may move to.
isCorporateAllCardListWhether to return every card of the corporate relationship rather than the customer's own.
tenantIdWhich tenant's records to read. Omitting it reads the rows that belong to no tenant rather than all of them.
GetCardListRequest
channelCodeThree-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.
customerNumberThe 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.
mainCustomerNumberThe main customer of a corporate relationship, as a number. The employees and supplementary holders under it carry their own customerNumber.
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.
barcodeThe delivery barcode the consignment is tracked by.
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.
cardNumberThe card number, which this API neither stores nor searches on. The facade resolves it through the customer service's getCardByCardNumber and searches on the shadowCardNumber that comes back; when the lookup finds nothing the search runs without it rather than refusing.
purposeNarrows the list by what the cards are wanted for. One letter, compared in the query itself; anything that is not one of the five below filters nothing rather than being refused.
B— cards in a valid statusC— open cards, statusAD— usable cards, and cards in statusGE— closed cards other thanGF— cards that may be reissued
cardStatusCodeValues:
A— validB— pendingC— stolenD— cancelled by the bankF— fraudG— temporarily blockedI— cancelledL— lostM— cancelled by the customerT— corporate dummy
cardStatusReasonCodeWhy the status is being set. The valid reasons depend on the status: getAvailableCardStatusList returns the pairs a card may move to.
branchCodeThe branch the card is opened at, as a number. Held as a number rather than text throughout.
customerNameSurnameMatches part of the cardholder's name. The query compares it with CARD_MASTER.OWNER_SEARCH_NAME — the normalised copy of the name, not the name on the card — as LIKE '%…%' over an uppercased, accent-folded form, so case and Turkish characters do not have to match and a fragment is enough.
identificationNumberMatches the customer's tax number or national identity number. The query compares it with the first ten characters of one and the first eleven of the other, so eleven is the longest value that can match anything: a longer one is not refused, it simply finds nothing.
courierStatusNarrows the list to cards whose consignment is at this courier status, matched against the delivery integration record.
corpCardFlagWhether to return corporate cards.
onlyLastCardFlagWhether only the most recent card is included.
virtualCardFlagWhether the card is a virtual one.
GetCardMemo
cardRefNumberThe card reference, which identifies one issued card including its renewals. Returned by the create and listing operations alongside the shadow number.
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.
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.
customerNumberThe 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.
logCodeWhat kind of log entry this is.
logCodeDescriptionThe description of logCode, carried alongside it for display. It is not a key: match on the code.
oldValueThe value before the change, as the log recorded it.
newValueThe value after the change, as the log recorded it.
cardLogDetailinsertChannelIdWhich channel created the row.
insertChannelDescriptionThe description of insertChannelId, carried alongside it for display. It is not a key: match on the code.
insertUserIdAn audit column the platform fills in. It is on the request because the contract was generated from the table, and a value sent here is replaced.
insertDateWhen the row was created.
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.
GetCardMemoRequest
startDateCanNotBeNullOrLessThanSqlMinValue — Start of the window the log is read over. Refused when absent, and refused under a second code when it is below the minimum date the platform's store accepts — so a zero or default date is not treated as open-ended.
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.
endDateCanNotBeNullOrLessThanSqlMinValue — End of the window, under the same two rules as startDate.
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.
shadowCardNumberOne-of — The card whose memo log is read. Send this or customerNumber. The two are checked only when both are missing — supply either and neither is validated further.
customerNumberOne-of — The customer whose memo log is read, as the alternative to shadowCardNumber. Zero counts as absent here, so zero with no card number is the case that is refused.
logCodeWhat kind of log entry this is.
GetCardMiscOptionRequest
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.
optionTypeValues:
DS— digital slip — whether the cardholder's slip is printedDC— dynamic CVV — whether the card's CVV is generated per period
customerNumberThe 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.
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.
cardRefNumberThe card reference, which identifies one issued card including its renewals. Returned by the create and listing operations alongside the shadow number.
onlyMainCardFlagWhether only main cards are included.
GetCardOperationLimitRequest
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.
cardRefNumberThe card whose limits are read.
GetCardOperationLimitResponseItem
Which limit row this is: the transaction group, the network and the channel together identify one. The descriptions beside each code are returned for display and are not part of the key.
perTrnAmountThe most the card may spend in one transaction.
perTrnAmountLimitRatioThe same cap as a share of the card's limit rather than an amount.
dailyTrnCountThe most transactions the card may make in a day.
dailyTrnAmountThe most the card may spend in a day.
weeklyTrnCountThe most transactions the card may make in a week.
weeklyTrnAmountThe most the card may spend in a week.
monthlyTrnCountThe most transactions the card may make in a month.
monthlyTrnAmountThe most the card may spend in a month.
yearlyTrnCountThe most transactions the card may make in a year.
yearlyTrnAmountThe most the card may spend in a year.
GetCardPermissionsRequest
shadowCardNumberThe card whose permissions are read.
GetCardStatementAddressInformationRequest
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.
GetCardStatementAddressInformationResponse
statementPostingFlagWhether the statement is posted on paper.
statementSmsSendFlagWhether the statement is announced by SMS.
statementEMailSendFlagaddressIdaddressTypeValues:
RA— homeAL— businessEA— employerOO— alternativeWA— previousSW— SWIFTSS— SWIFT name and addressMR— Mernis, registeredMS— Mernis, stated
Not set is --.
statementSendAddressTypeemailGetCardStatementDetailRequest
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.
mainCardRefNumberThe main card's reference, and nothing else will do. A supplementary card's own reference fetches no statement — its spending appears as rows on the main card's. This is the one field any operation on this side checks itself.
statementDateRequired in practice — The statement to read. The schema marks it nullable and the code does not treat it as optional: the header totals are read with this date before the branch for an absent one can take effect, so a request without it does not succeed. Send it.
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.
minStatementDateHow far back the detail rows may reach. Ignored when statementDate is sent, and when neither is sent it defaults to the first of the month seven months back — which is the window, and why an older period cannot be reached by widening this field alone.
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.
GetCardStatementDetailResponse
prevTotalAmountWhat the total came to before this change.
totalAmountThe amount of every entry in the list added together.
totalDebittotalCredittotalCashtotalProfitFeeTaxtotalProfittotalFeetotalTax1totalTax2GetCardStatementDetailSummaryRequest
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.
statementDateA 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.
GetCardStatementDetailSummaryResponse
minimumPaymentAmountThe least that may be paid this period.
prevTotalAmountWhat the total came to before this change.
remainingDebtWhat is still owed.
statementDateA 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.
earnedPointAmountdueDateA 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.
nextStatementDateA 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.
nextDueDateA 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.
statementDebtWhat the statement says is owed.
totalEarnedPointAmountremainingMinimumPaymentDebtWhat is left of the minimum payment.
currencyCodeThe currency of the amount, as its three-letter code.
GetCardStatementListRequest
shadowCardNumberOne-of — The card whose statements are listed. Send this or mainCardRefNumber; sending neither is refused as a business failure rather than a field one, so no propertyName arrives with it. When this is the one sent, the facade looks the card master up to find the main card reference.
mainCardRefNumberOne-of — The main card reference the statements hang off. Send this or shadowCardNumber; when both are sent this one is used and no card lookup is done.
GetCardStatementSummaryRequest
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.
statementDateA 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.
GetCardStatementSummaryResponse
minimumPaymentAmountThe least that may be paid this period.
prevTotalAmountWhat the total came to before this change.
remainingDebtWhat is still owed.
statementDateA 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.
earnedPointAmountdueDateA 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.
nextStatementDateA 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.
nextDueDateA 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.
statementDebtWhat the statement says is owed.
totalEarnedPointAmountremainingMinimumPaymentDebtWhat is left of the minimum payment.
currencyCodeThe currency of the amount, as its three-letter code.
GetCashAdvanceInfoRequest
channelIdThree-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.
shadowCardNumberRequired in practice — The card to quote against. Not validated here, and it is read twice over: forwarded to the authorisation service, and used to find the card's product, which is what decides the tax rates. A value that matches no card is not refused; see the 200 description.
accountNumberThe account the advance would be drawn against. Forwarded untouched; this API neither reads it nor checks it.
An account at the bank's core banking system rather than a column here, so its format is the core's: no table behind these APIs holds an account number as text, and most of this platform's own requests type it as a number. The platform stores iban and accountAlias instead, and publishes a width for both.
cashAdvanceAmountRequired in practice — The amount to quote for. Not validated here — it is forwarded to the authorisation service, and it is also the amount the taxed total below is computed from.
GetCashAdvanceInfoResponse
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.
cashAdvanceFeeAmountcashAdvanceInterestRatecashAdvanceAmountThe amount to draw as cash.
totalAmountThe amount of every entry in the list added together.
calculateCashProfitcalculatedTotalAmountauthCodeThe authorisation code the issuer returned when the transaction was approved. Six characters, from the scheme.
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.
responseReasonCodeWhy the downstream system answered as it did, where it narrows the response code.
GetCashInstallmentParameterItem
minInstallmentCountmaxInstallmentCountminTrnAmountmaxTrnAmountprofitRatefeeAmountThe fee charged on the transaction.
GetCashInstallmentParameterRequest
channelIdThree-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.
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.
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.
An account at the bank's core banking system rather than a column here, so its format is the core's: no table behind these APIs holds an account number as text, and most of this platform's own requests type it as a number. The platform stores iban and accountAlias instead, and publishes a width for both.
transactionAmountThe amount of the transaction.
GetCorporateCustomerInfoByIndividualCustomerRequest
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.
customerNumberThe individual customer whose corporate relationships are read.
GetCreditApplicationIdByFromShadowCardNumberRequest
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.
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.
GetCreditApplicationIdByFromShadowCardNumberResponse
applicationIdThe card application this request belongs to. Returned when an application is created, and carried through the card that comes out of it.
applicationDateA 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.
GetCreditCardAutoPaymentOrderRequest
mainCustomerNumberLists auto-payment orders for every card under the customer.
mainCardRefNumberAlternative card key when the shadow number is not held.
shadowCardNumberOne of shadowCardNumber, mainCardRefNumber or mainCustomerNumber is required. All three empty throws 60002.
GetCreditCardCollectionInfoByCardRefNumberRequest
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.
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.
GetCreditCardCollectionInfoByMainCustomerNumberRequest
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.
mainCustomerNumberThe main customer of a corporate relationship, as a number. The employees and supplementary holders under it carry their own customerNumber.
branchCodeThe branch the card is opened at, as a number. Held as a number rather than text throughout.
Held as a number rather than text, so a character limit would say nothing about it.
GetCreditCardCollectionTransactionListByDateRequest
dateDate
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.
GetCreditCardCurrentTransactionListRequest
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.
GetCreditCardDateRangeForRewardByCustomerNumberReqSourceRequest
CustomerNumberThe 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.
StatementDateA 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.
RequestSourceRead inside the query that answers this operation and stored nowhere, so no column stands behind it. Two values do something: C asks for the current period, S for the last statement period. Anything else returns both dates empty rather than an error.
GetCreditCardDateRangeForRewardByCustomerNumberReqSourceResponse
BeginDateA 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.
EndDateA 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.
GetCreditCardInfoRequest
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.
shadowCardNumberOne-of — The card to read. Send this or cardNumber; sending neither is refused.
cardNumberOne-of — The card's PAN. Resolved to a shadow card number first, and refused if it matches none. When both are sent this one is used.
GetCreditCardInfoResponse
The card the operation is answering about.
GetCreditCardLastStatementRequest
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.
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.
GetCreditCardLastStatementResponse
existingPointGetCreditCardLimitRequest
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.
shadowCardNumberThe card whose limit is read. Checked by the facade, which resolves it to a card reference number before the limit service sees it - so a card that does not exist is a business failure rather than a field one. The card's status is not checked: a closed card is read like any other.
GetCreditCardLimitResponse
availableCashAdvanceLimittotalLimitGetCreditCardPortfolioSummaryRequest
channelCodeThree-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.
mainCustomerNumberThe main customer of a corporate relationship, as a number. The employees and supplementary holders under it carry their own customerNumber.
GetCreditCardPortfolioSummaryResponse
assetstotalDebtAmountcardCounttotalDebtAmountUSDtotalDebtAmountEURproductCodeproductNameThe card product's full name.
statementCurrencyThe currency the statement is produced in.
GetCreditCardStatementSendPreferenceRequest
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.
customerNumberThe 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.
GetCreditCardTransactionAllRequest
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.
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.
beginDateA 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.
endDateA 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.
onlySuccessFlagWhether to return only the transactions that succeeded.
GetCreditCustomerLisfOfBranchRequest
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.
branchCodeRequired in practice — Branch whose customers are listed. Not validated — the facade's null check on it cannot fail, because the field is a bare int, so an omitted value arrives as zero, matches no branch and comes back as an empty list rather than a refusal.
GetCustomerAssetsSummaryCreditCardModel
supplementaryCardFlagWhether this is a supplementary card rather than a main one.
cardLimitThe card's own spending limit.
cardAvailableLimitHow much of the card's limit is left.
currentDebtWhat is owed as of now.
totalDebtautoLimitIncreaseFlagWhether the card takes part in automatic limit increases.
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.
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.
cardRefNumberThe card reference, which identifies one issued card including its renewals. Returned by the create and listing operations alongside the shadow number.
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.
customerNumberThe 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.
mainCustomerNumberThe main customer of a corporate relationship, as a number. The employees and supplementary holders under it carry their own customerNumber.
productNumberThe card product the card is issued on. Defined in the parameter tables; getCardProductList returns the ones a tenant may use.
statementDateA 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.
statementDueDateA 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.
statementPeriodWhich statement period the card is billed on. The periods a product allows come from the reference data.
productNameThe card product's full name.
productShortNameThe card product's short name, for a list or a statement line.
expiryDateStrThe card's expiry as MMYY.
cardFormTypeValues:
P— physicalD— digitalB— physical and digital — a product setting, resolved toPorDon issueH— HCET— tokenV— virtual
cardStatusCodeValues:
A— validB— pendingC— stolenD— cancelled by the bankF— fraudG— temporarily blockedI— cancelledL— lostM— cancelled by the customerT— corporate dummy
cardStatusCodeDescriptionThe description of cardStatusCode, carried alongside it for display. It is not a key: match on the code.
cardStatusReasonCodeWhy the status is being set. The valid reasons depend on the status: getAvailableCardStatusList returns the pairs a card may move to.
cardStatusReasonCodeDescriptionThe description of cardStatusReasonCode, carried alongside it for display. It is not a key: match on the code.
cardStatusChangeChannelWhich channel last changed the card's status.
securityFlagWhether the card is under a security restriction.
The accounts the card draws on.
GetCustomerAssetsSummaryCreditRequest
channelCodeThree-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.
customerNumberThe 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.
GetCustomerAvailableLimitRequest
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.
mainCustomerNumberThe main customer of a corporate relationship, as a number. The employees and supplementary holders under it carry their own customerNumber.
GetCustomerAvailableLimitResponse
availableLimitHow much of the limit is left.
availableCashLimitlimitThe limit to set.
cashLimitUsedlimitUsedHow much of the limit has been used.
GetCustomerCreditCardListByTenantIdProductNumberResult
cardLimitThe card's own spending limit.
customerLimitThe limit of the customer behind the card.
customerAvailableLimitHow much of the customer's limit is left.
cardAvailableLimitHow much of the card's limit is left.
delinquencyPeriodHow many periods the account has been in arrears.
pendingReplaceApplicationExistsWhether a replacement has been asked for and not yet produced.
cardStatusCodeValues:
A— validB— pendingC— stolenD— cancelled by the bankF— fraudG— temporarily blockedI— cancelledL— lostM— cancelled by the customerT— corporate dummy
cardStatusCodeDescThe description of cardStatusCode, carried alongside it for display. It is not a key: match on the code.
cardStatusReasonCodeWhy the status is being set. The valid reasons depend on the status: getAvailableCardStatusList returns the pairs a card may move to.
cardStatusReasonCodeDescThe description of cardStatusReasonCode, carried alongside it for display. It is not a key: match on the code.
customerNumberThe 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.
cardFormTypeValues:
P— physicalD— digitalB— physical and digital — a product setting, resolved toPorDon issueH— HCET— tokenV— virtual
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.
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.
productNumberThe card product the card is issued on. Defined in the parameter tables; getCardProductList returns the ones a tenant may use.
productShortNameThe card product's short name, for a list or a statement line.
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.
statementCurrencyThe currency the statement is produced in.
statementDateA 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.
nextDueDateA 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.
nextStatementDateA 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.
dueDateA 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.
cardRefNumberThe card reference, which identifies one issued card including its renewals. Returned by the create and listing operations alongside the shadow number.
expiryDateStrThe card's expiry as MMYY.
firstPinSetDateA 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.
barcodeThe delivery barcode the consignment is tracked by.
noNameFlagWhether the card was produced without a name on it.
delinquencyStatusValues:
N— normalD— delinquent for the periodG— delinquent
GetCustomerCreditCardListByTenantIdRequest
customerNumberCustomer whose cards are listed. A real null check — the field is nullable, so absence is refused rather than read as zero.
channelCodeThree-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.
tenantIdWhich tenant's cards to list. Its check is commented out in the facade, and absence is not an error: the query runs instead with a marker the service substitutes for a missing tenant, which asks a different question rather than a wider one. Send it to ask about a named tenant.
productNumbersNarrows the answer to these products; each entry is one product number, at most five characters. An absent or empty list means no filter.
The two operations that take this request match it differently. getCustomerCreditCardListByTenantId keeps a card whose product number contains one of the values, so a prefix or a fragment matches. getCustomerCreditCardListByTenantIdProductNumber keeps a card whose product number equals one, so only the whole number does.
GetCustomerCreditCardListByTenantIdResult
cardLimitThe card's own spending limit.
cardAvailableLimitHow much of the card's limit is left.
customerLimitThe limit of the customer behind the card.
customerAvailableLimitHow much of the customer's limit is left.
pendingReplaceApplicationExistsWhether a replacement has been asked for and not yet produced.
delinquencyPeriodHow many periods the account has been in arrears.
cardStatusCodeValues:
A— validB— pendingC— stolenD— cancelled by the bankF— fraudG— temporarily blockedI— cancelledL— lostM— cancelled by the customerT— corporate dummy
cardStatusCodeDescThe description of cardStatusCode, carried alongside it for display. It is not a key: match on the code.
cardStatusReasonCodeWhy the status is being set. The valid reasons depend on the status: getAvailableCardStatusList returns the pairs a card may move to.
cardStatusReasonCodeDescThe description of cardStatusReasonCode, carried alongside it for display. It is not a key: match on the code.
customerNumberThe 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.
cardFormTypeValues:
P— physicalD— digitalB— physical and digital — a product setting, resolved toPorDon issueH— HCET— tokenV— virtual
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.
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.
productNumberThe card product the card is issued on. Defined in the parameter tables; getCardProductList returns the ones a tenant may use.
productShortNameThe card product's short name, for a list or a statement line.
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.
statementCurrencyThe currency the statement is produced in.
statementDateA 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.
nextDueDateA 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.
nextStatementDateA 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.
dueDateA 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.
cardRefNumberThe card reference, which identifies one issued card including its renewals. Returned by the create and listing operations alongside the shadow number.
expiryDateStrThe card's expiry as MMYY.
firstPinSetDateA 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.
barcodeThe delivery barcode the consignment is tracked by.
noNameFlagWhether the card was produced without a name on it.
binThe bank identification number — the leading digits of the card number that name the issuer and the product range.
encryptedCardNumberThe card number encrypted under the platform's key, which is how it travels between services.
keyDerivationIndexWhich key the card's encrypted values were produced under. Returned with the card; a caller does not choose it.
delinquencyStatusValues:
N— normalD— delinquent for the periodG— delinquent
GetCustomerCreditShadowCardsByTenantIdRequest
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.
customerNumberCustomer whose shadow cards are listed. A real null check — the field is nullable, so absence is refused.
tenantIdWhich tenant's cards to list. Demanded here, unlike on getCustomerCreditCardListByTenantId, where the same check is commented out — the two operations differ on this field and the difference is in the source rather than by accident of shape.
GetCustomerCreditShadowCardsByTenantIdResult
cardTypeWhich kind of card, as the one-letter code the account type carries: C credit, D debit, P prepaid.
customerNumberThe 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.
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.
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.
productNumberThe card product the card is issued on. Defined in the parameter tables; getCardProductList returns the ones a tenant may use.
productShortNameThe card product's short name, for a list or a statement line.
cardStatusCodeValues:
A— validB— pendingC— stolenD— cancelled by the bankF— fraudG— temporarily blockedI— cancelledL— lostM— cancelled by the customerT— corporate dummy
cardStatusCodeDescThe description of cardStatusCode, carried alongside it for display. It is not a key: match on the code.
cardStatusReasonCodeWhy the status is being set. The valid reasons depend on the status: getAvailableCardStatusList returns the pairs a card may move to.
cardStatusReasonCodeDescThe description of cardStatusReasonCode, carried alongside it for display. It is not a key: match on the code.
GetCustomerLimitationParametersRequest
customerNumberThe 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.
GetCustomerOperationLimitRequest
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.
customerNumberRequired in practice — Customer whose operation limits are read. Not validated — the service's check on it is commented out, so a zero or negative value is not refused; it simply matches nothing and the list comes back empty.
GetCustomerTotalLimitInfoRequest
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.
customerNumberCustomer whose total limit is read. Three separate refusals — absent, zero and negative each raise their own code.
productNumberThe card product the card is issued on. Defined in the parameter tables; getCardProductList returns the ones a tenant may use.
GetCustomerTotalLimitInfoResponse
customerLimitThe limit of the customer behind the card.
cardApplicationNumberGetCustomerTransactionDetailRequest
utidThe unique transaction identifier the platform gives a transaction, and the handle every later operation on it takes. Returned by the transaction listings.
GetDigitalSlipReceiptRequest
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.
GetDigitalSlipReceiptResponse
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.
GetDisputeListRequest
CaseNumberRestrict the search to one case. The contract holds a non-nullable integer, so a search that does not use this criterion sends 0.
DisputeTransactionIdRestrict the search to one dispute transaction. The contract holds a non-nullable integer, so a search that does not use this criterion sends 0.
UTIDRestrict the search to one unique transaction identifier.
CustomerNumberRestrict the search to one customer. The contract holds a non-nullable integer, so a search that does not use this criterion sends 0.
ShadowCardNumberRestrict the search to one card, by shadow number.
CardRefNumberRestrict the search to one card, by card reference number.
EncryptedCardNumberRestrict the search to one card, by encrypted card number. The facade does not decrypt it.
CardNumberRestrict the search to one card, by plain card number.
ExternalCaseIdRestrict the search to one case in the external dispute system. Only the integration route reads it.
GetEarlyCloseCandidateListRequest
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.
customerNumberThe 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.
GetEarlyReleaseAvailableInstallmentsByCriteriasRequest
cardRefNumberThe card reference, which identifies one issued card including its renewals. Returned by the create and listing operations alongside the shadow number.
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.
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.
GetEarlyReleaseCashInstallmentRequest
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.
utidThe unique transaction identifier the platform gives a transaction, and the handle every later operation on it takes. Returned by the transaction listings.
GetEarlyReleaseCashInstallmentResponse
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.
transactionAmountThe amount of the transaction.
installmentCountHow many instalments to split the amount across. The available counts for a card and amount come from the simulation operations.
totalFeeAmountinstallmentProfitRatetotalInstallmentAmountWhat the instalments come to together.
remainingInstallmentCountHow many instalments are still to run.
remainingInstallmentCapitalAmountearlyReleaseTotalAmountearlyReleaseInterestAmountearlyReleaseTotalTaxAmountearlyReleaseBsmvAmountearlyReleaseKkdfAmountshadowCardNumberThe 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.
utidThe unique transaction identifier the platform gives a transaction, and the handle every later operation on it takes. Returned by the transaction listings.
GetEarlyReleaseCashInstallmentsRequest
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.
GetInstallmentCountsByUtidRequest
UtidThe unique transaction identifier the platform gives a transaction, and the handle every later operation on it takes. Returned by the transaction listings.
GetInstallmentCountsByUtidResponse
AmountThe amount.
DateA 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.
MinInstallmentCountMaxInstallmentCountMinDeferringMonthCountMaxDeferringMonthCountInstallmentCountLimitInstallmentCountMccGroupLimitInstallmentCountMccLimitInstallmentProfileDeferringLimitInstallmentProfileInstallmentLimitMccDefinitionInstallmentLimitDescriptionGetManuelInstallmentCancelRecordsByCardRefNumberRequest
cardRefNumberThe card reference, which identifies one issued card including its renewals. Returned by the create and listing operations alongside the shadow number.
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.
GetPendingCardEmbossListRequest
shadowCardNumberThe card whose pending emboss records are listed. The only field the request carries, and the only thing checked.
GetPendingCardEmbossListResponse
cardSeqNumberWhich chip on the card was used, where a customer holds more than one card on the same number.
embossDateA 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.
applicationDateA 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.
embossReasonCodeValues:
N— new cardY— renewal
embossReasonDescriptionThe description of embossReasonCode, carried alongside it for display. It is not a key: match on the code.
embossReasonSubCodeValues:
BRK— broken cardCHF— damaged chipEXP— renewal at maturityFRD— fraudMGF— magnetic stripe errorNSU— name updateOTH— otherEXO— bulk renewal at maturityLST— lost cardSTL— stolen card
Not set is ---.
embossReasonSubDescThe description of embossReasonSubCode, carried alongside it for display. It is not a key: match on the code.
embossStatusValues:
W— waitingP— processingC— emboss file createdE— embossedT— PIN printedD— deliveredR— emboss file removedF— emboss faultyN— emboss not completedX— error
Not set is "".
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.
productTypeCodeValues:
C— creditD— debitP— prepaid
productTypeDescriptionThe description of productTypeCode, carried alongside it for display. It is not a key: match on the code.
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.
validFlagWhether the row is live. The platform sets it; a value sent here is replaced.
GetPendingProvisionListRequest
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.
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.
GetRenewCountByShadowCardNumberRequest
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.
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.
embossReasonSubCodeValues:
BRK— broken cardCHF— damaged chipEXP— renewal at maturityFRD— fraudMGF— magnetic stripe errorNSU— name updateOTH— otherEXO— bulk renewal at maturityLST— lost cardSTL— stolen card
Not set is ---.
GetRenewCountByShadowCardNumberResponse
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.
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.
isSupplementaryGetStatementPeriodByProductNumberRequest
productNumberThe card product the card is issued on. Defined in the parameter tables; getCardProductList returns the ones a tenant may use.
GetStatementPeriodChangeCountRequest
cardRefNumberThe card reference, which identifies one issued card including its renewals. Returned by the create and listing operations alongside the shadow number.
GetStatementPeriodChangeCountResponse
changeCountExceededchangeCountGetStatementPeriodChangeInfoRequest
cardRefNumberThe card reference, which identifies one issued card including its renewals. Returned by the create and listing operations alongside the shadow number.
GetStatementPeriodChangeInfoResponse
yearlyRemainingStatementChangeCountstatementDateA 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.
next1StatementDateA 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.
next2StatementDateA 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.
lastChangeDateA 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.
isStatementPeriodChangeAvailableGetWaitingInstallmentDetailRequest
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.
GetWaitingInstallmentSummaryRequest
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.
HealthCheckResponse
dateA 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.
resultThe outcome, as the downstream system words it.
IncreasePinTryCountRequest
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.
shadowCardNumberThe card the operation acts on, by its shadow card number — the platform's own reference, not the PAN.
increaseCountHow many tries to add to the card's PIN try count. Negative and zero are refused separately, each with its own code, so the smallest value this operation accepts is 1.
InstallmentEarlyReleaseRow
DeferringDayAuthorizationNumberThe authorisation code the issuer returned when the transaction was approved. Six characters, from the scheme.
DeferringFlagInstallmentCapitalAmountThe capital part of the instalment, without interest.
InstallmentCountHow many instalments to split the amount across. The available counts for a card and amount come from the simulation operations.
InstallmentFeeAmountThe fee charged for splitting into instalments.
InstallmentProfitAmountThe interest charged across the instalments.
InstallmentTax1AmountInstallmentTax2AmountMaskedCardNumberThe card number with its middle digits masked, as the platform stores it. It is a display form, not a key.
MerchantNameThe merchant's name as it reached the platform from the scheme.
RemainingCapitalAmountRemainingFeeAmountRemainingInstallmentAmountRemainingInstallmentCountHow many instalments are still to run.
RemainingInstallmentProfitAmountRemainingInstallmentBsmvAmountRemainingTaxTaxRemainingInstallmentKkdfAmountShadowCardNumberThe 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.
TotalCapitalAmountTotalInstallmentAmountWhat the instalments come to together.
TotalInstallmentProfitAmountTotalInstallmentBsmvAmountTotalInstallmentKkdfAmountTotalFeeAmountTrnDateA 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.
TrnDescriptionThe transaction in words, as it reached the platform.
TrnInstallmentTypeUtidThe unique transaction identifier the platform gives a transaction, and the handle every later operation on it takes. Returned by the transaction listings.
RemainingTaxAndFeeAmountTotalTaxAndFeeAmountCurrentTaxAndFeeAmountDeferringBsmvAmountDeferringProfitAmountDeferringKkdfAmountTotalDeferringBsmvAmountTotalDeferringProfitAmountTotalDeferringKkdfAmountRemainingDeferringBsmvAmountRemainingDeferringProfitAmountRemainingDeferringKkdfAmountLKSResultItem
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.
transactionIdThe platform's identifier for this call, for tracing it in the logs.
detailMore about the error than message carries, where there is more.
ListCardAccountByAccountNumberRequest
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.
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.
ListCardAccountByAccountNumberResponse
The accounts to attach to the card as it is created. Each entry carries the account's own identifiers; attaching one later is attachCardAccount.
ListCardAccountByShadowCardNumberRequest
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.
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.
ListCardAccountByShadowCardNumberResponse
The accounts to attach to the card as it is created. Each entry carries the account's own identifiers; attaching one later is attachCardAccount.
ManuelInstallmentCancelRecord
CardRefNumberThe card reference, which identifies one issued card including its renewals. Returned by the create and listing operations alongside the shadow number.
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.
DeferringDateA 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.
DeferringMonthFeeRateFixedFeeAmountInsertUserIdAn audit column the platform fills in. It is on the request because the contract was generated from the table, and a value sent here is replaced.
InstallmentAmountWhat each instalment comes to.
InstallmentCodeInstallmentCountHow many instalments to split the amount across. The available counts for a card and amount come from the simulation operations.
InstallmentProfitRateInstallmentPriorityInstallmentProfitAmountThe interest charged across the instalments.
MaskedCardNumberThe card number with its middle digits masked, as the platform stores it. It is a display form, not a key.
MerchantNameThe merchant's name as it reached the platform from the scheme.
ProcessedDateA 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.
ProcessedFlagRecordIdThe identifier of the row the operation created or acted on. Returned rather than sent in most operations that carry it.
InstallmentTaxAmountTrnAmountThe amount of the transaction, in its own currency.
TrnDateA 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.
TrnSourceValidFlagWhether the row is live. The platform sets it; a value sent here is replaced.
UtidThe unique transaction identifier the platform gives a transaction, and the handle every later operation on it takes. Returned by the transaction listings.
InstallmentOrderDateA 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.
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.
SupplementaryCardFlagWhether this is a supplementary card rather than a main one.
ManuelInstallmentOrderRequest
installmentCountHow many instalments to split the amount across. The available counts for a card and amount come from the simulation operations.
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.
utidRequired in practice — The transaction to split, as in the simulation. The same key orders the plan that was simulated. Not validated here.
deferringMonthCountHow many months the purchase is deferred by.
channelTypeThe channel the order is recorded under. Forwarded to transaction management; nothing here resolves or checks it, and it is a different field from the channel the rest of this API takes.
ManuelInstallmentOrderSimulateRecord
installmentNumberWhich instalment this is.
installmentAmountWhat each instalment comes to.
installmentDateA 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.
installmentCapitalAmountThe capital part of the instalment, without interest.
remainingTotalAmountManuelInstallmentOrderSimulateRequest
installmentCountRequired in practice — How many instalments to plan for. Echoed back rather than answered — see the 200 description.
shadowCardNumberRequired in practice — The card the transaction belongs to. It narrows the lookup; it does not select what is split. Not validated here.
utidRequired in practice — The transaction being split, and the key to the whole operation. A plan is simulated for one transaction, not for a card: find the transaction first, then simulate against its utid. Not validated here.
deferringMonthCountMonths to defer the first instalment by. Sending one makes the headline total understate the cost; see the 200 description.
ManuelInstallmentOrderSimulateResponse
installmentAmountWhat each instalment comes to.
profitRatetotalPaymentAmounttotalPFTAmountinstallmentCountHow many instalments to split the amount across. The available counts for a card and amount come from the simulation operations.
deferringMonthCountHow many months the purchase is deferred by.
NextPeriodInstallmentItem
statementDateA 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.
totalAmountThe amount of every entry in the list added together.
The transactions the search matched.
OperationLimitErrorItem
errorCodeThe platform's own code for the error, and what to match on.
errorTextThe error in words, for a log or a screen rather than for matching.
OperationLimitItem
Which limit row this is: the transaction group, the network and the channel together identify one. The descriptions beside each code are returned for display and are not part of the key.
profileCodeWhich profile the card's limits come from.
profileDescriptionNot read by the service. The description of profileCode, carried for display. It is forwarded once and then only copied back into the response; nothing reads it and nothing stores it. profileCode is the half that is checked.
perTrnAmountThe most the card may spend in one transaction.
perTrnAmountLimitRatioThe same cap as a share of the card's limit rather than an amount.
dailyTrnCountThe most transactions the card may make in a day.
dailyTrnAmountThe most the card may spend in a day.
weeklyTrnCountThe most transactions the card may make in a week.
weeklyTrnAmountThe most the card may spend in a week.
monthlyTrnCountThe most transactions the card may make in a month.
monthlyTrnAmountThe most the card may spend in a month.
yearlyTrnCountThe most transactions the card may make in a year.
yearlyTrnAmountThe most the card may spend in a year.
cardTypeWhich kind of card, as the one-letter code the account type carries: C credit, D debit, P prepaid.
OperationLimitItemKeys
customLimitationChangeFlaglimitProfileDetailIdThe limit row this entry belongs to.
trnLimitationGroupCodeValues:
SA— purchaseNA— cash advanceST— purchase, main card
trnLimitationGroupDescriptionNot read by the service. The facade maps the key's codes and drops this field on the way through — it is not in the mapping at all — so nothing behind the API sees what is sent and the response echoes an empty value. Match on the code beside it.
trnMainLimitationGroupCodeValues:
SA— purchaseNA— cash advanceST— purchase, main card
trnMainLimitationGroupDescriptionNot read by the service. The facade maps the key's codes and drops this field on the way through — it is not in the mapping at all — so nothing behind the API sees what is sent and the response echoes an empty value. Match on the code beside it.
networkTypeValues:
O— on-usD— domestic, through BKMM— MastercardV— Visa
networkDescriptionNot read by the service. The facade maps the key's codes and drops this field on the way through — it is not in the mapping at all — so nothing behind the API sees what is sent and the response echoes an empty value. Match on the code beside it.
channelTypeThe channel a limit row applies to, which is not the channel the request is made on.
channelDescriptionNot read by the service. The facade maps the key's codes and drops this field on the way through — it is not in the mapping at all — so nothing behind the API sees what is sent and the response echoes an empty value. Match on the code beside it.
eventCodeWhich event the limit row is keyed on.
eventDescriptionNot read by the service. The facade maps the key's codes and drops this field on the way through — it is not in the mapping at all — so nothing behind the API sees what is sent and the response echoes an empty value. Match on the code beside it.
mccThe merchant category code — the four-digit code the scheme classifies the merchant's trade with.
mccGroupRecreateCustomerCardAccountsRequest
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.
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.
The accounts to attach to the card as it is created. Each entry carries the account's own identifiers; attaching one later is attachCardAccount.
ReleasePendingInstallmentRequest
utidThe unique transaction identifier the platform gives a transaction, and the handle every later operation on it takes. Returned by the transaction listings.
feeAmountThe fee charged on the transaction.
earlyReleaseTypeWhich kind of early settlement is being asked for.
ReleasePendingInstallmentResponse
erLogRecordIdshadowCardNumberThe 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.
RemoveCardOperationLimitRequest
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.
cardRefNumberThe card whose operation limits are removed.
ListHasNoItem — Which operation limits to remove. An empty list is refused rather than treated as nothing to do.
RemoveCardOperationLimitResponseItem
actionTypeWhich kind of change this entry records. — 0 None, 1 Insert, 2 Update, 3 Delete
successWhether 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.
Which limit row this is — group, network and channel.
What went wrong, one entry per problem. Present on a refusal; the HTTP status carries the kind.
RemoveCustomerOperationLimitRequest
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.
customerNumberCustomer whose operation limits are removed. Negative and zero are refused separately, each with its own code, and the customer must then exist.
ListHasNoItem — Which limits to remove. An empty list is refused; a key naming no limit on this customer is refused as a business failure.
RemoveCustomerOperationLimitResponseItem
actionTypeWhich kind of change this entry records. — 0 None, 1 Insert, 2 Update, 3 Delete
successWhether 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.
What went wrong, one entry per problem. Present on a refusal; the HTTP status carries the kind.
Which limit row this is — group, network and channel.
RemoveOperationLimitItemKeys
operationLimitRecordIdThe limit row the operation acts on, as returned by the limit listing.
RenewCountItem
embossReasonSubCodeValues:
BRK— broken cardCHF— damaged chipEXP— renewal at maturityFRD— fraudMGF— magnetic stripe errorNSU— name updateOTH— otherEXO— bulk renewal at maturityLST— lost cardSTL— stolen card
Not set is ---.
embossReasonSubDescThe description of embossReasonSubCode, carried alongside it for display. It is not a key: match on the code.
renewAmountrenewCountmaxRenewCountReplaceCardRequest
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.
shadowCardNumberThe card being replaced.
cardEmbossReasonWhy the card is reissued. Renew is the only value this operation accepts; anything else is refused.
Values:
N— new cardY— renewal
cardEmbossSubReasonThe sub-reason under cardEmbossReason.
Values:
BRK— broken cardCHF— damaged chipEXP— renewal at maturityFRD— fraudMGF— magnetic stripe errorNSU— name updateOTH— otherEXO— bulk renewal at maturityLST— lost cardSTL— stolen card
Not set is ---.
embossNameThe name printed on the card.
deliveryTypeHow the card reaches the cardholder. Branch makes deliveryBranchCode mandatory; Post constrains deliveryAddressType.
Values:
P— by postS— to the branch
Not set is "".
deliveryAddressTypeConditional — The address the card is posted to. When deliveryType is Post and this is sent, it may not be None.
Values:
RA— homeAL— businessEA— employerOO— alternativeWA— previousSW— SWIFTSS— SWIFT name and addressMR— Mernis, registeredMS— Mernis, stated
Not set is --.
deliveryBranchCodeConditional — The branch the card is delivered to. Mandatory when deliveryType is Branch.
productNumberReissue onto a different product. If sent it must be a product the platform defines; the product change scenario must exist too.
instantIssuingFlagDefault false — Issue the card at a branch on the spot. True makes embossBranchCode mandatory.
embossBranchCodeConditional — The branch that prints the card. Mandatory when instantIssuingFlag is true.
Permissions to carry onto the new card.
cardSendAddressIdThe stored address the card is sent to.
enrollMasterpassEnrol the new card in Masterpass.
ReplaceCardRequestInfo
deliveryTypeHow the replacement card is delivered. Not validated — the facade's checks on this field are commented out, so a blank or unknown delivery type is not refused here.
Values:
P— by postS— to the branch
Not set is "".
deliveryAddressTypeValues:
RA— homeAL— businessEA— employerOO— alternativeWA— previousSW— SWIFTSS— SWIFT name and addressMR— Mernis, registeredMS— Mernis, stated
Not set is --.
deliveryBranchCodeembossNameThe name embossed on the card.
cardEmbossReasonRequired · NotNullOrWhiteSpace — Why the card is re-embossed. Checked by the facade as part of replaceInfo; the reason and its sub-reason are a pair and both are demanded.
Values:
N— new cardY— renewal
cardEmbossSubReasonRequired · NotNullOrWhiteSpace — The sub-reason for the re-emboss, demanded alongside cardEmbossReason.
Values:
BRK— broken cardCHF— damaged chipEXP— renewal at maturityFRD— fraudMGF— magnetic stripe errorNSU— name updateOTH— otherEXO— bulk renewal at maturityLST— lost cardSTL— stolen card
Not set is ---.
productNumberThe card product the card is issued on. Defined in the parameter tables; getCardProductList returns the ones a tenant may use.
What the card may do: e-commerce, international purchases and mail order. Each is optional, and one left unset takes the platform's own default rather than being refused — for e-commerce that default follows digitalCardFlag.
cardSendAddressIdWhich of the customer's addresses to send the card to. The identifier of an address already held for that customer, not an address.
ReplaceCardResponse
newCardGeneratedWhether the change produced a new card.
productChangedWhether the change moved the card to another product.
expiryDateA 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.
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.
What the operation wants to say about work it did anyway. A warning does not mean the operation failed.
ReplaceCardResponseInfo
newCardGeneratedWhether the change produced a new card.
productChangedWhether the change moved the card to another product.
expiryDateA 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.
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.
ReplaceCardUsingNoNameApplicationRequest
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.
customerNumberThe customer the card is for. Omitted it arrives as 0, which the service refuses, as it does a negative number.
applicationIdThe replace application to issue the card from. Omitted it arrives as 0, which matches no application and is refused.
barcodeThe delivery barcode the consignment is tracked by.
ReplaceCardUsingNoNameApplicationResponse
recordIdThe identifier of the row the operation created or acted on. Returned rather than sent in most operations that carry it.
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.
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.
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.
What the operation wants to say about work it did anyway. A warning does not mean the operation failed.
The card number, expiry and verification value, returned only where the operation and the channel are entitled to them.
ReplaceNoNameCardPermissions
eCommercePermittedWhether the card may be used online.
ReplaceNoNameCardRequest
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.
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.
replaceReasonCodeWhy the card is being replaced. It decides what the replacement inherits and whether the card number changes.
What the card may do: e-commerce, international purchases and mail order. Each is optional, and one left unset takes the platform's own default rather than being refused — for e-commerce that default follows digitalCardFlag.
enrollMasterpassWhether to enrol the new card with Masterpass. Forwarded to the issuing service, which does the enrolment; the card is created either way.
ReplaceNoNameCardResponse
applicationIdThe card application this request belongs to. Returned when an application is created, and carried through the card that comes out of it.
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.
newCardGeneratedWhether the change produced a new card.
productChangedWhether the change moved the card to another product.
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.
cardRefNumberThe card reference, which identifies one issued card including its renewals. Returned by the create and listing operations alongside the shadow number.
ResetCardLimitRequest
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.
cardRefNumberThe card whose limit is reset, by card reference number. Checked here, unlike on the increase and decrease operations, where the equivalent check is commented out.
ResetCvvCounterRequest
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.
shadowCardNumberThe card the operation acts on, by its shadow card number — the platform's own reference, not the PAN.
ReverseCashAdvanceRequest
amountThe amount.
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.
uTIDThe unique transaction identifier the platform gives a transaction, and the handle every later operation on it takes. Returned by the transaction listings.
referenceNumberThe caller's own reference for the transaction, carried into the institution transaction record. It is truncated to 50 characters rather than refused.
ReverseCashAdvanceResponse
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.
uTIDThe unique transaction identifier the platform gives a transaction, and the handle every later operation on it takes. Returned by the transaction listings.
authCodeThe authorisation code the issuer returned when the transaction was approved. Six characters, from the scheme.
responseReasonCodeWhy the downstream system answered as it did, where it narrows the response code.
ReverseCashInstallmentRequest
amountThe amount.
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.
uTIDThe unique transaction identifier the platform gives a transaction, and the handle every later operation on it takes. Returned by the transaction listings.
referenceNumberThe caller's own reference for the transaction, carried into the institution transaction record. It is truncated to 50 characters rather than refused.
ReverseCashInstallmentResponse
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.
uTIDThe unique transaction identifier the platform gives a transaction, and the handle every later operation on it takes. Returned by the transaction listings.
authCodeThe authorisation code the issuer returned when the transaction was approved. Six characters, from the scheme.
responseReasonCodeWhy the downstream system answered as it did, where it narrows the response code.
ReversePaymentTransactionRequest
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.
ReversePaymentTransactionResponse
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.
uTIDThe unique transaction identifier the platform gives a transaction, and the handle every later operation on it takes. Returned by the transaction listings.
authCodeThe authorisation code the issuer returned when the transaction was approved. Six characters, from the scheme.
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.
responseCodeDescriptionThe description of responseCode, carried alongside it for display. It is not a key: match on the code.
responseReasonCodeWhy the downstream system answered as it did, where it narrows the response code.
responseReasonCodeDescriptionThe description of responseReasonCode, carried alongside it for display. It is not a key: match on the code.
RewardDetail
rewardTypeWhich kind of reward was earned.
rewardTypeDescriptionThe description of rewardType, carried alongside it for display. It is not a key: match on the code.
availableBankRewardRewardItem
amountThe amount.
rewardTypeWhich kind of reward was earned.
rewardTypeDescriptionThe description of rewardType, carried alongside it for display. It is not a key: match on the code.
SaveCardPermissionsRequest
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.
The permissions to write. Must be sent; an empty list is accepted and changes nothing.
cardRefNumberOne-of · NotNull — The card to permit or restrict. Send this or shadowCardNumber; sending neither is refused with both named.
shadowCardNumberOne-of · NotNull — The card to permit or restrict. Send this or cardRefNumber; when both are sent this one finds the card.
SaveCardPermissionsRequestItem
restrictionCodeThe restriction this entry is about. Must be a restriction the platform defines; a bad one is reported against permissions.
Values:
SA— purchaseNA— cashDN— domestic cashYD— international saleYN— international cashAT— ATMMO— mail orderEC— e-commerce, fully secureEN— e-commerce, half secureEX— e-commerce, not secureCLS— contactlessTA— instalmentPTH— pre-authorisationQC— quasi cashCB— POS cashbackCSB— cashbackTCS— POS cash advanceFA— bill paymentVG— tax paymentCEK— chequeFF— FastFundPPP— project sharing programme
permittedDefault false — True permits, false restricts. Null is read as false.
startDateWhen the permission starts.
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.
endDateWhen the permission ends.
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.
transactionIdThe caller's own id for this entry.
SaveCardPermissionsResponse
changedCountHow many entries actually changed. An entry already holding the value it was sent is skipped, so this can be lower than the number sent — and zero is a success.
listOfRecordIdSaveCreditCardAutoPaymentOrderRequest
accountNumberFunding account number. Lifecycle rejects an empty or zero account.
shadowCardNumberCard whose auto-payment order is created or updated.
paymentTypeT (all / statement), A (minimum), or N (none). Blank defaults to T; any other value throws 60004.
accountOwnerNameDisplay name of the funding account owner.
Belongs to the core banking account rather than to a column here.
SensitiveCardData
panThe card number in full. Returned only where the operation is entitled to it.
expiryDateStrThe card's expiry as MMYY.
cvvSensitiveData
panThe card number in full. Returned only where the operation is entitled to it.
cvv2SetCardOperationLimitRequest
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.
cardRefNumberThe card whose limits are set.
ListHasNoItem — The limits to write. Must be sent and must hold at least one entry.
SetCardOperationLimitResponseItem
actionTypeWhich kind of change this entry records. — 0 None, 1 Insert, 2 Update, 3 Delete
successWhether 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.
What went wrong, one entry per problem. Present on a refusal; the HTTP status carries the kind.
The operation limits in force.
SetCardPinRequest
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.
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.
clearPinExactly four digits today, and the four is not in this contract: setCardPin hardcodes it while verifyCardPin and changeCardPin read it from the platform's Pin parameter, so a tenant that changes that parameter changes two of the three.
SetCardPinResponse
successWhether 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.
encryptedPinThe PIN block as the key management service produced it. The PIN itself never travels.
SetCustomerOperationLimitRequest
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.
customerNumberCustomer whose operation limits are set. Zero is refused; the service checks for zero rather than for absence, so the two arrive as the same failure.
ListHasNoItem — The limits to set. An empty list is refused rather than treated as nothing to do.
SetCustomerOperationLimitResponseItem
actionTypeWhich kind of change this entry records. — 0 None, 1 Insert, 2 Update, 3 Delete
successWhether 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.
What went wrong, one entry per problem. Present on a refusal; the HTTP status carries the kind.
The operation limits in force.
SetRsaPinRequest
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.
shadowCardNumberThe card whose PIN is set.
ePBThe encrypted PIN block.
Its size follows the block format and the key it was built with rather than a column, so no length is published.
operationDateThe date the operation is stamped with.
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.
SetRsaPinResponse
successWhether 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.
encryptedPinThe PIN block as the key management service produced it. The PIN itself never travels.
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.
responseDescriptionThe description of responseCode, carried alongside it for display. It is not a key: match on the code.
SimulateCashInstallmentForAllRequest
channelIdThree-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.
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.
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.
An account at the bank's core banking system rather than a column here, so its format is the core's: no table behind these APIs holds an account number as text, and most of this platform's own requests type it as a number. The platform stores iban and accountAlias instead, and publishes a width for both.
transactionAmountThe amount of the transaction.
SimulateCashInstallmentInstallmentRow
installmentNumberWhich instalment this is.
installmentDateA 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.
installmentAmountWhat each instalment comes to.
installmentCapitalAmountThe capital part of the instalment, without interest.
installmentProfitAmountThe interest charged across the instalments.
installmentBsmvAmountinstallmentKkdfAmountremainingTotalAmountremainingCapitalAmountremainingProfitAmountremainingBsmvAmountremainingKkdfAmountSimulateCashInstallmentRequest
channelIdThree-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.
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.
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.
An account at the bank's core banking system rather than a column here, so its format is the core's: no table behind these APIs holds an account number as text, and most of this platform's own requests type it as a number. The platform stores iban and accountAlias instead, and publishes a width for both.
transactionAmountThe amount of the transaction.
installmentCountHow many instalments to split the amount across. The available counts for a card and amount come from the simulation operations.
SimulateCashInstallmentRow
totalAmountThe amount of every entry in the list added together.
totalProfitAmounttotalBsmvAmounttotalKkdfAmountinsterestRatefirstInstallAmountinstallmentAmountWhat each instalment comes to.
installmentDateA 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.
installmentCountHow many instalments to split the amount across. The available counts for a card and amount come from the simulation operations.
SimulateInstallmentEarlyReleaseRequest
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.
utidThe unique transaction identifier the platform gives a transaction, and the handle every later operation on it takes. Returned by the transaction listings.
SimulateInstallmentEarlyReleaseResponse
CanceledFeeAndProfitAmountProfitAmountFeeAmountThe fee charged on the transaction.
EarlyReleaseDeferringAmountTrnDateA 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.
EarlyPaymentAmountRemainingInstallmentCountHow many instalments are still to run.
TotalInstallmentCountHow many instalments the plan has in all.
AmountOfRemainingInstallmentSummaryRecordIdCanceledProfitAmountCanceledKkdfAmountCanceledBsmvAmountCanceledFeeAmountStatementCodeInfo
statementCodedescriptionThe error in words. errorCode is the part to match on; this is for a log or a screen.
StatementRemainingDebtList
currencyCodeThe currency of the amount, as its three-letter code.
remainingDebtWhat is still owed.
StatementRewardDetail
rewardTypeWhich kind of reward was earned.
rewardTypeDescriptionThe description of rewardType, carried alongside it for display. It is not a key: match on the code.
revolvingTotalRewardSubmitCardApplicationExtStatusRequest
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.
applicationIdCard application the status belongs to. Refused when absent and refused again when zero. Not checked against the application table — an id that matches no application is accepted and stored, so a typo arrives as a status row nothing will ever read.
externalStatusCodeThe application's status in the external system that owns the process — a card application originated outside the platform, tracked here against applicationId. One character, and the length is checked before anything is written rather than left to the column.
The codes are the submitting system's own. Nothing resolves this value against a parameter table or an enumeration: it is compared with the stored value for inequality and written through, so any single character is accepted. The one code the platform writes itself is X, set by the no-name application expiry batch when it cancels an expired pending application (alongside a cancellation reason of EXP). It carries no meaning the platform reads back, and a bank's own codes may use it or not.
Submitting any status has one side effect worth knowing: the expiry batch reads the last write to this record and, where there is one, measures a pending application's expiry from that date against the ExternalStatusExpirePeriod parameter instead of from the application date against DefaultExpirePeriod. So a status submission moves the clock the application expires on.
SubmitCardApplicationExtStatusResponse
cardApplicationExtStatusHistoryRecordIdTransferBranchCustomerRequest
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.
currentBranchCodeThe branch the customers are moved from. Refused when it is the same as targetBranchCode — a transfer to the branch already held is an error here, not a no-op.
targetBranchCodeThe branch the customers are moved to.
listOfPersonIdWhich customers to move. Checked for presence, not for contents.
TransferBranchCustomerResponse
oldBranchThe branch before the move.
newBranchThe branch after it.
changedCardCountHow many cards the operation changed.
listOfShadowCardNumbersThe cards the operation acted on.
VerifyCardPinRequest
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.
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.
clearCardNumberA card number is not stored by these services; the platform keeps a shadow card number instead.
clearPinExactly four digits today, and the four is not in this contract: setCardPin hardcodes it while verifyCardPin and changeCardPin read it from the platform's Pin parameter, so a tenant that changes that parameter changes two of the three.
VerifyCardPinResponse
verifiedWhether the value presented matched the one held.
lastTryCountHow many failed attempts stand against the card.
tryCountExceedWhether the card has run out of attempts. The card is blocked when it has.
VerifyCardVerificationValueRequest
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.
shadowCardNumberThe card whose CVV is being checked.
verificationValueNotNull · LengthNotEquals — The CVV to check. Exactly 3 characters; any other length is refused before the card is read.
VerifyCardVerificationValueResponse
verifiedWhether the CVV matched. A CVV that does not match is not an error — the call returns 200 with this false and the card's failed-attempt counter goes up. The counter is not in this response: the service behind it returns the count and whether the maximum was reached, and this API does not pass either on. Enough failures lock the card, and the next call is then refused with 1156 before the CVV is looked at.
VerifyPartialCardVerificationValueRequest
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.
shadowCardNumberThe card whose CVV is being checked.
NotBetween — The positions to check, as position/value pairs. Two or three pairs, no more and no fewer. Each position is 1 to 3 — the CVV is three digits — and each value is 0 to 9.
VerifyPartialCardVerificationValueResponse
verifiedTrue only when every pair sent matches. The service generates the card's CVV and compares the positions given, so a wrong position is a mismatch rather than an error.
VerifyRsaPinRequest
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.
shadowCardNumberThe card the operation acts on, by its shadow card number — the platform's own reference, not the PAN.
ePBThe encrypted PIN block to verify.
Its size follows the block format and the key it was built with rather than a column, so no length is published.
operationDateThe date the PIN block was produced under. The block and this date are verified as a pair.
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.
VerifyRsaPinResponse
verifiedWhether the value presented matched the one held.
lastTryCountHow many failed attempts stand against the card.
tryCountExceedWhether the card has run out of attempts. The card is blocked when it has.
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.
responseDescriptionThe description of responseCode, carried alongside it for display. It is not a key: match on the code.
VerifyRsaPinWithStaticSaltRequest
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.
shadowCardNumberThe card the operation acts on, by its shadow card number — the platform's own reference, not the PAN.
ePBThe encrypted PIN block to verify.
Its size follows the block format and the key it was built with rather than a column, so no length is published.
operationDateThe date the PIN block was produced under.
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.
staticSaltThe salt the PIN block was built with. This is the only field that separates this operation from verifyRsaPin; the checks are otherwise identical.
A cryptographic input rather than stored data: no column behind it and no length published.
VerifyRsaPinWithStaticSaltResponse
verifiedWhether the value presented matched the one held.
lastTryCountHow many failed attempts stand against the card.
tryCountExceedWhether the card has run out of attempts. The card is blocked when it has.
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.
responseDescriptionThe description of responseCode, carried alongside it for display. It is not a key: match on the code.
WaitingInstallmentDetailInfo
recordIdThe identifier of the row the operation created or acted on. Returned rather than sent in most operations that carry it.
statementDateA 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.
installmentAmountWhat each instalment comes to.
amountThe amount.
trnAmountThe amount of the transaction, in its own currency.
creditCardStatementTransactionTypeIsBorrowcreditCardStatementTransactionTypeIsLoandomesticAmounttotalPointEarnedinstallmentNumberWhich instalment this is.
originalAmounttotalInstallmentCountHow many instalments the plan has in all.
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.
cardProductVirtualFlagWhether the product is a virtual one.
cardProductDigitalFlagWhether the product can be issued digitally.
remainInstallmentAmountsupplementaryCardFlagWhether this is a supplementary card rather than a main one.
erOrderedFlagdigitalSlipFlagWhether a digital receipt was produced.
utidThe unique transaction identifier the platform gives a transaction, and the handle every later operation on it takes. Returned by the transaction listings.
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.
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.
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.
installmentCurrencyCodecurrencyCodeThe currency of the amount, as its three-letter code.
trnCurrencyCodeThe currency the transaction was made in.
mCCCodemCCDescriptionThe description of mCCCode, carried alongside it for display. It is not a key: match on the code.
mCCGroupCodemCCGroupDescriptionThe description of mCCGroupCode, carried alongside it for display. It is not a key: match on the code.
transactionCodetransactionDescriptionThe description of transactionCode, carried alongside it for display. It is not a key: match on the code.
productNumberThe card product the card is issued on. Defined in the parameter tables; getCardProductList returns the ones a tenant may use.
capitalRewardIndicatorWhether the reward counts towards the capital scheme.
trnEffectWhether the transaction adds to the balance or takes from it.
channelTypeThe channel a limit row applies to, which is not the channel the request is made on.
bkmUniqueMerchantIdThe merchant's identifier at BKM, the domestic switch.
digitalSlipValueThe digital receipt itself.
rewardTypeWhich kind of reward was earned.
rewardTypeDescriptionThe description of rewardType, carried alongside it for display. It is not a key: match on the code.
authorizationNumberThe authorisation code the issuer returned when the transaction was approved. Six characters, from the scheme.
bsmvAmountThe BSMV levy on the transaction.
kkdfAmountThe KKDF levy on the transaction.
installmentFeeAmountThe fee charged for splitting into instalments.
installmentProfitAmountThe interest charged across the instalments.
panEntryModeHow the card was read at the terminal — chip, stripe, contactless, keyed, or stored on file. The scheme's own code.
panEntryModeDescriptionThe description of panEntryMode, carried alongside it for display. It is not a key: match on the code.
merchantNameThe merchant's name as it reached the platform from the scheme.
merchantNumberThe merchant's number with the acquirer.
WaitingInstallmentSummaryInfo
statementDateA 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.
totalInstallmentAmountWhat the instalments come to together.
totalInstallmentBsmvAmounttotalInstallmentCapitalAmounttotalInstallmentFeeAmounttotalInstallmentKkdfAmounttotalInstallmentProfitAmount