Everest Card — API reference
  • Credit
  • Debit
  • Prepaid
  • Common Methods
  • OAuth2
  • Delivery
Information
Cards
    Card applications
      getCreditApplicationIdByFromShadowCardNumberpostsubmitCardApplicationExtStatuspost
    Card issuance and personalisation
      createIndividualCardpostcreateIndividualSupplementaryCardpostcreateDummyCorporateCardpostcreateCorporateCardpostcreateVirtualCardpostgetApplicableProductsByCustomerNumberpostgetApplicableProductsByMainCustomerPreControlpostcreateNoNameCardpostcancelCardEmbossByShadowCardNumberpostgetPendingCardEmbossListpost
    Card lifecycle
      getCardListpostreplaceCardpostgetCardMemopostchangeCardStatuspostchangeCustomerCreditCardStatuspostchangeAndReplaceCardpostgetRenewCountByShadowCardNumberpostgetCreditCardInfopostgetCustomerCreditCardListByTenantIdpostgetCustomerCreditShadowCardsByTenantIdpostgetCustomerCreditCardListByTenantIdProductNumberpostgetCardListNewpost
    No-name cards
      activateNoNameCardpostreplaceNoNameCardpostreplaceCardUsingNoNameApplicationpostchangeAndReplaceNoNameCardpostcancelNoNameCardApplicationpost
Customers and accounts
    Branch management
      changeCardBranchpostchangeCustomerBranchposttransferBranchCustomerpostgetCreditCustomerListOfBranchpost
    Customers
      getCorporateCustomerInfoByIndividualCustomerpostgetCustomerAssetsSummaryCreditpost
    Account linking
      attachCardAccountpostdetachCardAccountpostdetachCardAccountByAccountNumberpostlistCardAccountByAccountNumberpostlistCardAccountByShadowCardNumberpostrecreateCustomerCardAccountpost
Transactions
    doPaymentTransactionpostreversePaymentTransactionpostdoPaymentFeeInquirypostgetCustomerTransactionDetailpostgetCardIntermTransactionInfopostgetPendingProvisionListpostgetCreditCardTransactionAllpostgetCreditCardCurrentTransactionListpostgetTransactionAllpostgetPendingProvisionListNewpostgetDigitalSlipReceiptpost
    Cash advance
      getCashAdvanceInfopostdoCashAdvancepostreverseCashAdvancepostgetCancelableCashAdvanceListpost
Limits and controls
    Card and customer limits
      changeCardLimitDecreasepostchangeCardLimitIncreasepostchangeCardLimitReversepostresetCardLimitpostchangeCardAutoLimitIncreasepostgetCustomerTotalLimitInfopostgetCreditCardLimitpostgetCardAvailableLimitpostgetCustomerAvailableLimitpostchangeCorporateCardLimitDecreasepostchangeCorporateCardLimitIncreasepostchangeIndividualCardLimitpostdecreaseCustomerLimitpostchangeVirtualCardLimitpost
    Operation limits
      getCardOperationLimitpostsetCardOperationLimitpostremoveCardOperationLimitpostgetCardLimitationParameterDatapostgetCustomerOperationLimitpostsetCustomerOperationLimitpostremoveCustomerOperationLimitpostgetCustomerLimitationParameterDatapost
    Permissions and restrictions
      getCardPermissionspostsaveCardPermissionspostchangeCardMiscOptionpostgetCardMiscOptionpost
Instalments
    getEarlyCloseCandidateListpostdoEarlyClosepostgetInstallmentCountsByUtidpostgetCashInstallmentParameterpostsimulateCashInstallmentForAllpostsimulateCashInstallmentpostdoCashInstallmentpostreverseCashInstallmentpostgetCancelableCashInstallmentListpostgetEarlyReleaseCashInstallmentspostgetEarlyReleaseCashInstallmentpostdoCashInstallmentEarlyReleasePaymentpostcancelCashInstallEarlyReleasePaymentpostgetAllWaitingInstallmentspostgetWaitingInstallmentDetailpostgetWaitingInstallmentSummarypostmanuelInstallmentOrderpostmanuelInstallmentOrderSimulatepostgetInstallmentCountsByUtidNewpostcancelInstallmentEarlyReleasepostgetManuelInstallmentCancelRecordsByCardRefNumberpostgetEarlyReleaseAvailableInstallmentsByCriteriaspostsimulateInstallmentEarlyReleasepostreleasePendingInstallmentpostcancelInstallmentTransactionOrderpost
Billing and statements
    Collections and legal follow-up
      getCardDelinquencyInfoByCustomerNumberpostgetCreditCardCollectionInfoByCardRefNumberpostgetCreditCardCollectionInfoByMainCustomerNumberpostgetCreditCardCollectionTransactionListByDatepostgetCreditCardPortfolioSummarypost
    Debt payment
      checkCreditCardForDebtPaymentpostdoCreditCardDebtPaymentpostcancelCreditCardDebtPaymentpostgetCancelableCreditCardDebtPaymentListpostsaveCreditCardAutoPaymentOrderpostgetCreditCardAutoPaymentOrderpost
    Statements and billing
      getCardStatementSummarypostgetCardStatementDetailpostgetCreditCardStatementSendPreferencepostgetCardStatementListpostgetCreditCardLastStatementpostgetCreditCardLastStatementNewpostgetCardStatementDetailSummarypostgetCardStatementDetailSummaryNewpostchangeCreditCardStatementPeriodpostgetStatementPeriodChangeCountpostgetCalculatedStatementPeriodpostgetStatementPeriodByProductNumberpostchangeCreditCardStatementSendPreferencepostgetCardStatementAddressInformationpostgetCardFinancialInfoByCardRefNumberpostgetStatementPeriodChangeInfopost
Security
    PIN and card security
      setCardPinpostchangeCardPinpostverifyCardPinpostverifyRsaPinpostverifyRsaPinWithStaticSaltpostsetRsaPinpostincreasePinTryCountpostchangeRsaPinpostverifyCardVerificationValuepostgenerateCardVVpostverifyPartialCardVerificationValuepostresetCvvCounterpost
Disputes
    Disputes and chargebacks
      createDisputeCasepostcancelDisputeCasepostaddDocumentByCaseNumberpostgetDisputeListpostgetDisputeReasonDefListpost
Rewards
    Campaigns and rewards
      getCreditCardDateRangeForRewardByCustomerNumberReqSourcepost
Platform
    Platform operations
      healthCheckpostrefreshCachepost
    Reference data
      getAvailableCardStatusListpost
SchemasError codesChannels
powered by Zudoku
Credit Digital Channels Integration
Credit Digital Channels Integration

Schemas


ActivateNoNameCardRequest

channel
​string · maxLength: 3 · required

Three-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.

customerNumber
​integer · int64 · required

The 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.

lastFourDigit
​string · maxLength: 19 · optional

The 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.

barcode
​string · optional

The 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

Channel
​string · maxLength: 3 · required

Three-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.

CaseNumber
​integer · int32 · optional

Required — Case the documents are attached to. The contract holds a non-nullable integer, so leaving the field out sends 0.

ExternalCaseId
​string · optional

The case identifier in the external dispute system. Only the integration route reads it; the local route attaches by CaseNumber alone.

ExternalDocumentId
​string · optional

The document identifier in the external dispute system. Only the integration route reads it.

​array · optional

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

productGroupCode
​string · maxLength: 5 · optional

Which group of products this one belongs to.

ApplicableProductFilters

productGroupCode
​string · maxLength: 5 · required

Demanded 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

channel
​string · maxLength: 3 · required

Three-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.

accountNumber
​integer · int64 · required

The 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.

fecCode
​integer · int32 · optional

The foreign-currency code of the account, where the card draws on one.

accountBranchId
​integer · int32 · optional

The branch that holds the account, as core banking numbers it.

accountType
​string · enum · maxLength: 1 · optional

Values:

  • A — main account
  • V — virement
accountSuffix
​integer · int32 · optional

The suffix that distinguishes one account from another under the same number at core banking.

shadowCardNumber
​string · maxLength: 19 · optional

Required 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.

accountAlias
​string · maxLength: 30 · optional

A name for the account, shown to the cardholder where the account is listed. The platform stores it and does not interpret it.

iban
​string · maxLength: 30 · optional

The account's IBAN, stored alongside the account number.

accountOrderFlag
​boolean · optional

Not 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

recordId
​integer · int64 · required

The identifier of the row the operation created or acted on. Returned rather than sent in most operations that carry it.

CancelCardEmbossByShadowCardNumberRequest

channel
​string · maxLength: 3 · required

Three-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.

shadowCardNumber
​string · maxLength: 19 · required

Shadow 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

channel
​string · maxLength: 3 · required

Three-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.

trnId
​integer · int64 · required

Transaction id of the early-release payment being reversed.

amount
​number · double · required

Amount of the original early-release payment.

currencyCode
​string · maxLength: 3 · required

Currency of the original payment.

clientReferenceNumber
​integer · int64 · required

Same client reference used on the payment call.

cashInstallmentUtid
​string · required

UTID of the cash-installment plan the payment belonged to.

The installment's own transaction identifier, carried through to the services that hold it.

cardRefNumber
​string · maxLength: 19 · optional

Card reference when needed to locate the original payment.

mainCustomerNumber
​integer · int64 · optional

Main customer number when required by the cancel criteria.

trnDate
​string · optional

Original 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.

Example: 2026-10-16T14:30:00Z

CancelCashInstallEarlyReleasePaymentResponse

trnId
​integer · int64 · required

The platform's identifier for the transaction row.

CancelCreditCardDebtPaymentRequest

channel
​string · maxLength: 3 · required

Three-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.

trnId
​integer · int64 · required

Transaction id of the debt payment being reversed.

amount
​number · double · required

Amount of the original payment.

currencyCode
​string · maxLength: 3 · required

Currency of the original payment.

clientReferenceNumber
​integer · int64 · required

Same client reference used on doCreditCardDebtPayment.

cardRefNumber
​string · maxLength: 19 · optional

Card reference when cancelling by card rather than shadow alone.

mainCustomerNumber
​integer · int64 · optional

Main customer number when required by the cancel criteria.

trnDate
​string · optional

Original 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.

Example: 2026-10-16T14:30:00Z

CancelCreditCardDebtPaymentResponse

trnId
​integer · int64 · required

The platform's identifier for the transaction row.

CancelDisputeCaseRequest

Channel
​string · maxLength: 3 · required

Three-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.

CaseNumber
​integer · int32 · optional

Required — Case being withdrawn. The contract holds a non-nullable integer, so leaving the field out sends 0, and the local route refuses that.

DisputeTransactionId
​integer · int64 · optional

Dispute 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.

UTID
​string · maxLength: 50 · optional

Unique transaction identifier of the disputed transaction, as an alternative to DisputeTransactionId.

Description
​string · maxLength: 200 · optional

Free-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

isSuccessful
​boolean · required

Whether 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

shadowCardNumber
​string · maxLength: 19 · optional

The 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.

utid
​string · maxLength: 50 · optional

The unique transaction identifier the platform gives a transaction, and the handle every later operation on it takes. Returned by the transaction listings.

CancelInstallmentEarlyReleaseResponse

effectedRowCount
​integer · int32 · required

CancelInstallmentTransactionOrderRequest

recordId
​integer · int64 · optional

The identifier of the row the operation created or acted on. Returned rather than sent in most operations that carry it.

CancelInstallmentTransactionOrderResponse

installmentOrderRecordId
​integer · int64 · required
success
​boolean · required

Whether 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

channel
​string · maxLength: 3 · required

Three-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.

applicationId
​integer · int64 · optional

The card application this request belongs to. Returned when an application is created, and carried through the card that comes out of it.

cancelReasonCode
​string · maxLength: 3 · optional

Why the application is being cancelled.

cancelReasonText
​string · maxLength: 1024 · optional

Free text alongside the cancellation reason.

CardAccount

fecCode
​integer · int32 · required

The foreign-currency code of the account, where the card draws on one.

accountBranchId
​integer · int32 · required

The branch that holds the account, as core banking numbers it.

accountSuffix
​integer · int32 · required

The suffix that distinguishes one account from another under the same number at core banking.

accountNumber
​integer · int64 · required

The 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.

recordId
​integer · int64 · required

The identifier of the row the operation created or acted on. Returned rather than sent in most operations that carry it.

validFlag
​boolean · required

Whether the row is live. The platform sets it; a value sent here is replaced.

insertDate
​string · required

When 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.

Example: 2026-10-16T14:30:00Z
accountType
​string · enum · maxLength: 1 · optional

Values:

  • A — main account
  • V — virement
shadowCardNumber
​string · maxLength: 19 · optional

The 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.

accountAlias
​string · maxLength: 30 · optional

A name for the account, shown to the cardholder where the account is listed. The platform stores it and does not interpret it.

updateUserId
​string · maxLength: 100 · optional

An 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.

updateDate
​string · optional

When 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.

Example: 2026-10-16T14:30:00Z
insertTokenId
​string · maxLength: 64 · optional

An 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.

insertUserId
​string · maxLength: 100 · optional

An 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.

updateTokenId
​string · maxLength: 64 · optional

An 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.

iban
​string · maxLength: 30 · optional

The account's IBAN, stored alongside the account number.

accountOrderFlag
​boolean · optional

Not 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.

currencyCode
​string · maxLength: 3 · optional

The currency of the amount, as its three-letter code.

CardAccountInfo

accountNumber
​integer · int64 · required

The 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.

accountBranchId
​integer · int32 · required

The branch that holds the account, as core banking numbers it.

fecCode
​integer · int32 · required

The foreign-currency code of the account, where the card draws on one.

balance
​number · double · required
usableBalance
​number · double · required

The balance available to spend.

cardAccountType
​string · optional
accountType
​string · enum · optional

Values:

  • A — main account
  • V — virement
accountSubType
​string · optional
accountOrderFlag
​boolean · optional

Not 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.

currencyCode
​string · optional

The currency of the amount, as its three-letter code.

iBAN
​string · optional
errorDescription
​string · optional

The error in words. errorCode is the part to match on.

CardAutoPaymentOrderEntity

paymentAccountNumber
​integer · int64 · required
mainCustomerNumber
​integer · int64 · required

The main customer of a corporate relationship, as a number. The employees and supplementary holders under it carry their own customerNumber.

paymentAccountOwnerName
​string · optional
mainCardRefNumber
​string · optional

The 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.

shadowCardNumber
​string · optional

The 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.

paymentType
​string · optional

What kind of payment this is.

maskedCardNumber
​string · optional

The 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

authorizationAmount
​number · double · optional
availableLimit
​number · double · optional

How much of the limit is left.

cardLimit
​number · double · optional

The card's own spending limit.

cardOpeningDate
​string · optional

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.

Example: 2026-10-16T14:30:00Z
cardRefNumber
​string · optional

The card reference, which identifies one issued card including its renewals. Returned by the create and listing operations alongside the shadow number.

cardStatusCode
​string · optional

Values:

  • A — valid
  • B — pending
  • C — stolen
  • D — cancelled by the bank
  • F — fraud
  • G — temporarily blocked
  • I — cancelled
  • L — lost
  • M — cancelled by the customer
  • T — corporate dummy
cardStatusDescription
​string · optional

The description of cardStatusCode, carried alongside it for display. It is not a key: match on the code.

currentAmount
​number · double · optional
customerNumber
​integer · int64 · optional

The 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.

customerRoofLimit
​number · double · optional
customerType
​string · optional

Values:

  • 1 — corporate
  • 2 — individual
  • 3 — employee
  • 4 — sole proprietorship

Not set is N.

customerTypeDescription
​string · optional

The description of customerType, carried alongside it for display. It is not a key: match on the code.

delayDayCount
​integer · int32 · optional
delayProfitBsmvRate
​string · optional
delayProfitKkdfRate
​string · optional
delayProfitRate
​number · double · optional
delinquencyPeriod
​integer · int32 · optional

How many periods the account has been in arrears.

delinquencyStatusCode
​string · optional
delinquencyStatusDescription
​string · optional

The description of delinquencyStatusCode, carried alongside it for display. It is not a key: match on the code.

firstDelayDate
​string · optional

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.

Example: 2026-10-16T14:30:00Z
maskedCardNumber
​string · optional

The 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.

nextStatementDate
​string · optional

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.

Example: 2026-10-16T14:30:00Z
nextStatementDueDate
​string · optional

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.

Example: 2026-10-16T14:30:00Z
nextStatementDueOptionDate
​string · optional

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.

Example: 2026-10-16T14:30:00Z
pendingInstallmentAmount
​number · double · optional
productName
​string · optional

The card product's full name.

productNumber
​string · optional

The card product the card is issued on. Defined in the parameter tables; getCardProductList returns the ones a tenant may use.

rediscountProfitAmount
​number · double · optional
rediscountTaxAmount
​number · double · optional
rediscountTax1Amount
​number · double · optional
rediscountTax2Amount
​number · double · optional
remainingStatementAmount
​number · double · optional
remainingStatementMinAmount
​number · double · optional
shadowCardNumber
​string · optional

The 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.

statementAmount
​number · double · optional
statementDate
​string · optional

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.

Example: 2026-10-16T14:30:00Z
statementDueDate
​string · optional

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.

Example: 2026-10-16T14:30:00Z
statementDueOptionDate
​string · optional

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.

Example: 2026-10-16T14:30:00Z
statementMinAmount
​number · double · optional

The least that may be paid against the statement.

totalDebt
​number · double · optional
totalDebtWithRediscount
​number · double · optional
totalDebtWithRediscountAuthorization
​number · double · optional
totalDebtWithDailyPayment
​number · double · optional
currentPeriodDebt
​number · double · optional
currentPeriodRediscountProfit
​number · double · optional
customerCurrentDebtWithRediscount
​number · double · optional
customerCurrentDebtWithoutRediscount
​number · double · optional
totalDebtIfCardCancelled
​number · double · optional
​array · optional

CardInfo

maskedCustomerName
​string · optional
shadowCardNumber
​string · optional

The 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.

tenantId
​string · optional

Which tenant's records to read. Omitting it reads the rows that belong to no tenant rather than all of them.

CardIntermTransactionInfo

lastStatementTotalDebt
​number · double · required
lastStatementUsedPoint
​number · double · required
totalCurrentPoint
​number · double · required
statementDate
​string · required

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.

Example: 2026-10-16T14:30:00Z
nextStatementDate
​string · required

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.

Example: 2026-10-16T14:30:00Z
remaingStatementDebt
​number · double · required

What is left of the statement's debt.

next
​boolean · required
​array · optional
​array · optional
​array · optional

CardLimitationParameterData

shadowCardNumber
​string · optional

The 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.

customerLimitationFlag
​boolean · optional

Whether the card draws against the customer's limit rather than having one of its own.

profileCode
​string · optional

Which profile the card's limits come from.

profileDescription
​string · optional

The description of profileCode, carried alongside it for display. It is not a key: match on the code.

​object · optional

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.

perTrnAmount
​number · double · optional

The most the card may spend in one transaction.

perTrnAmountLimitRatio
​number · double · optional

The same cap as a share of the card's limit rather than an amount.

dailyTrnCount
​integer · int32 · optional

The most transactions the card may make in a day.

dailyTrnAmount
​number · double · optional

The most the card may spend in a day.

weeklyTrnCount
​integer · int32 · optional

The most transactions the card may make in a week.

weeklyTrnAmount
​number · double · optional

The most the card may spend in a week.

monthlyTrnCount
​integer · int32 · optional

The most transactions the card may make in a month.

monthlyTrnAmount
​number · double · optional

The most the card may spend in a month.

yearlyTrnCount
​integer · int32 · optional

The most transactions the card may make in a year.

yearlyTrnAmount
​number · double · optional

The most the card may spend in a year.

CardMccAmountSummary

amount
​number · double · required

The amount.

mccGroupCode
​string · optional

Which group of merchant categories the merchant falls in.

currencyCode
​string · optional

The currency of the amount, as its three-letter code.

CardMccRewardSummary

point
​number · double · required
mccGroupCode
​string · optional

Which group of merchant categories the merchant falls in.

CardMiscOptionData

customerNumber
​integer · int64 · required

The 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.

mainCardRefNumber
​string · optional

The 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.

cardRefNumber
​string · optional

The card reference, which identifies one issued card including its renewals. Returned by the create and listing operations alongside the shadow number.

optionType
​string · enum · optional

Values:

  • DS — digital slip — whether the cardholder's slip is printed
  • DC — dynamic CVV — whether the card's CVV is generated per period
optionValue
​string · enum · optional

Values:

  • HardCopy — a printed slip — the value DS takes
  • DigitalSlip — a digital slip — the value DS takes
  • true — dynamic CVV on — the value DC takes, compared as this exact string

CardMiscOptionResponse

listOfCardMiscOptionLogRecordId
​array · optional

CardStatementInfo

amount
​number · double · required

The amount.

minAmount
​number · double · required
date
​string · required

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.

Example: 2026-10-16T14:30:00Z
dueDate
​string · required

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.

Example: 2026-10-16T14:30:00Z
nextDueDate
​string · required

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.

Example: 2026-10-16T14:30:00Z
nextStatementDate
​string · required

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.

Example: 2026-10-16T14:30:00Z
statementCode
​string · optional
currencyCode
​string · optional

The currency of the amount, as its three-letter code.

documentID
​string · optional
​array · optional

CardStatementInfoResponse

​array · optional

CashInstallmentEarlyReleaseDetailEntity

installmentNumber
​integer · int32 · required

Which instalment this is.

installmentDate
​string · required

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.

Example: 2026-10-16T14:30:00Z
installmentAmount
​number · double · required

What each instalment comes to.

installmentCapitalAmount
​number · double · required

The capital part of the instalment, without interest.

installmentProfitAmount
​number · double · required

The interest charged across the instalments.

installmentBsmvAmount
​number · double · required
installmentKkdfAmount
​number · double · required
statementFlag
​boolean · required

Whether the transaction has reached a statement.

moveCurrentFlag
​boolean · required

CashInstallmentEarlyReleaseSummaryEntity

transactionDate
​string · required

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.

Example: 2026-10-16T14:30:00Z
transactionAmount
​number · double · required

The amount of the transaction.

installmentCount
​integer · int32 · required

How many instalments to split the amount across. The available counts for a card and amount come from the simulation operations.

totalFeeAmount
​number · double · required
installmentProfitRate
​number · double · required
totalInstallmentAmount
​number · double · required

What the instalments come to together.

remainingInstallmentCount
​integer · int32 · required

How many instalments are still to run.

remainingInstallmentCapitalAmount
​number · double · required
earlyReleaseTotalAmount
​number · double · required
earlyReleaseInterestAmount
​number · double · required
earlyReleaseTotalTaxAmount
​number · double · required
earlyReleaseBsmvAmount
​number · double · required
earlyReleaseKkdfAmount
​number · double · required
shadowCardNumber
​string · optional

The 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.

mainCardRefNumber
​string · optional

The 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.

utid
​string · optional

The unique transaction identifier the platform gives a transaction, and the handle every later operation on it takes. Returned by the transaction listings.

​array · optional

ChangeAndReplaceCardRequest

channel
​string · maxLength: 3 · required

Three-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.

shadowCardNumber
​string · maxLength: 19 · required

The 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.

​object · required

How the replacement card is issued. The object itself is required, and two of its fields are checked with it.

cardStatusCode
​string · maxLength: 2 · optional

Values:

  • A — valid
  • B — pending
  • C — stolen
  • D — cancelled by the bank
  • F — fraud
  • G — temporarily blocked
  • I — cancelled
  • L — lost
  • M — cancelled by the customer
  • T — corporate dummy
cardStatusReasonCode
​string · maxLength: 2 · optional

Why the status is being set. The valid reasons depend on the status: getAvailableCardStatusList returns the pairs a card may move to.

closeRequestDate
​string · optional

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.

Example: 2026-10-16T14:30:00Z

ChangeAndReplaceCardResponse

toStatusActive
​boolean · required

Whether the card ends this operation in an active status.

resetCustomerLimit
​boolean · required
listOfShadowCardNumberForClosedCard
​array · optional

The cards the operation closed.

listOfCardRefNumberForResetLimit
​array · optional
​object · optional

What the replacement produced.

ChangeAndReplaceNoNameCardReplaceModel

replaceReasonCode
​string · optional

Why the card is being replaced. It decides what the replacement inherits and whether the card number changes.

enrollMasterpass
​boolean · optional

Whether to enrol the new card with Masterpass. Forwarded to the issuing service, which does the enrolment; the card is created either way.

​object · optional

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

channel
​string · maxLength: 3 · required

Three-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.

shadowCardNumber
​string · maxLength: 19 · required

The 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.

cardStatusCode
​string · maxLength: 2 · required

Values:

  • A — valid
  • B — pending
  • C — stolen
  • D — cancelled by the bank
  • F — fraud
  • G — temporarily blocked
  • I — cancelled
  • L — lost
  • M — cancelled by the customer
  • T — corporate dummy
cardStatusReasonCode
​string · maxLength: 2 · required

Why the status is being set. The valid reasons depend on the status: getAvailableCardStatusList returns the pairs a card may move to.

​object · required

What the replacement card should carry — delivery, address and emboss details. Left out, the replacement inherits the card's own.

closeRequestDate
​string · optional

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.

Example: 2026-10-16T14:30:00Z

ChangeAndReplaceNoNameCardResponse

toStatusActive
​boolean · required

Whether the card ends this operation in an active status.

applicationId
​integer · int64 · optional

The card application this request belongs to. Returned when an application is created, and carried through the card that comes out of it.

shadowCardNumber
​string · optional

The 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.

newCardGenerated
​boolean · optional

Whether the change produced a new card.

productChanged
​boolean · optional

Whether the change moved the card to another product.

maskedCardNumber
​string · optional

The 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.

cardRefNumber
​string · optional

The card reference, which identifies one issued card including its renewals. Returned by the create and listing operations alongside the shadow number.

ChangeCardAutoLimitIncreaseRequest

channel
​string · maxLength: 3 · required

Three-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.

cardRefNumber
​string · maxLength: 19 · optional

Required 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.

autoLimitIncreaseFlag
​boolean · optional

Whether the card takes part in automatic limit increases.

shadowCardNumber
​string · maxLength: 19 · optional

Required 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

isChanged
​boolean · required
cardRefNumber
​string · optional

The card reference, which identifies one issued card including its renewals. Returned by the create and listing operations alongside the shadow number.

autoLimitIncreaseFlag
​boolean · optional

Whether the card takes part in automatic limit increases.

ChangeCardBranchRequest

channel
​string · maxLength: 3 · required

Three-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.

shadowCardNumber
​string · maxLength: 19 · optional

The 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.

targetBranchCode
​integer · int32 · optional

The branch to move the card or customer to.

ChangeCardBranchResponse

isSuccess
​boolean · required

Whether 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.

oldBranch
​integer · int32 · required

The branch before the move.

newBranch
​integer · int32 · required

The branch after it.

ChangeCardLimitDecreaseRequest

channel
​string · maxLength: 3 · required

Three-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.

limit
​number · double · required

The limit the card is lowered to — an absolute figure, not a difference.

shadowCardNumber
​string · maxLength: 19 · optional

One-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.

cardRefNumber
​string · maxLength: 19 · optional

One-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.

limitRatio
​number · double · optional

The limit as a share of another limit rather than an amount.

cashLimitRatio
​number · double · optional

How much of the card's limit may be drawn as cash, as a share.

changeCustomerLimit
​boolean · optional

Whether the customer's limit moves with the card's.

cardProfileSetCode
​string · maxLength: 10 · optional

Which profile set the card's limits come from. Defined in the parameter tables.

applicationNo
​string · optional

The 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.

skipReverseWhenLksFailed
​boolean · optional

Whether to leave the payment in place when the core banking leg fails rather than reversing it.

ChangeCardLimitDecreaseResponse

listOfCardLimitChangeLogId
​array · optional

The limit changes to reverse, by the log id each change returned.

listOfCustomerLimitChangeLogId
​array · optional

The customer limit changes to reverse, by the log id each change returned.

​object · optional

ChangeCardLimitRequest

channel
​string · maxLength: 3 · required

Three-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.

limit
​number · double · required

The 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.

shadowCardNumber
​string · maxLength: 19 · optional

One-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.

cardRefNumber
​string · maxLength: 19 · optional

One-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.

limitRatio
​number · double · optional

The limit as a share of another limit rather than an amount.

cashLimitRatio
​number · double · optional

How much of the card's limit may be drawn as cash, as a share.

changeCustomerLimit
​boolean · optional

Whether the customer's limit moves with the card's.

cardProfileSetCode
​string · maxLength: 10 · optional

Which profile set the card's limits come from. Defined in the parameter tables.

ChangeCardLimitResponse

listOfCardLimitChangeLogId
​array · optional

The limit changes to reverse, by the log id each change returned.

listOfCustomerLimitChangeLogId
​array · optional

The customer limit changes to reverse, by the log id each change returned.

ChangeCardLimitReverseRequest

channel
​string · maxLength: 3 · required

Three-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.

listOfCardLimitChangeLogId
​integer[] · required

ListHasNoItem — 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.

listOfCustomerLimitChangeLogId
​array · optional

The 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.

ChangeCardLimitReverseResponse

listOfError
​array · optional

ChangeCardMiscOptionRequest

channel
​string · maxLength: 3 · required

Three-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.

optionType
​string · enum · maxLength: 20 · optional

Values:

  • DS — digital slip — whether the cardholder's slip is printed
  • DC — dynamic CVV — whether the card's CVV is generated per period
optionValue
​string · enum · maxLength: 100 · optional

Values:

  • HardCopy — a printed slip — the value DS takes
  • DigitalSlip — a digital slip — the value DS takes
  • true — dynamic CVV on — the value DC takes, compared as this exact string
customerNumber
​integer · int64 · optional

The 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.

mainCardRefNumber
​string · maxLength: 19 · optional

The 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.

cardRefNumber
​string · maxLength: 19 · optional

The card reference, which identifies one issued card including its renewals. Returned by the create and listing operations alongside the shadow number.

allMainCardFlag
​boolean · optional

Whether every main card of the customer is included.

allCardFlag
​boolean · optional

Whether every card of the customer is included.

ChangeCardPinRequest

channel
​string · maxLength: 3 · required

Three-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.

shadowCardNumber
​string · maxLength: 19 · optional

The 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.

currentCardPin
​string · optional

Checked against the platform's Pin parameter rather than a fixed length, so it follows the tenant's configuration and can change without a release.

newCardPin
​string · optional

Checked 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

success
​boolean · required

Whether 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.

verified
​boolean · required

Whether the value presented matched the one held.

changed
​boolean · required
encryptedPin
​string · optional

The PIN block as the key management service produced it. The PIN itself never travels.

ChangeCardStatusRequest

channel
​string · maxLength: 3 · required

Three-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.

shadowCardNumber
​string · maxLength: 19 · required

The card whose status changes.

cardStatusCode
​string · maxLength: 2 · required

The status to move to. Must be a status the platform defines.

Values:

  • A — valid
  • B — pending
  • C — stolen
  • D — cancelled by the bank
  • F — fraud
  • G — temporarily blocked
  • I — cancelled
  • L — lost
  • M — cancelled by the customer
  • T — corporate dummy
cardStatusReasonCode
​string · maxLength: 2 · required

Dependent — The reason for the new status. Must be a reason defined for cardStatusCode.

transactionId
​string · maxLength: 50 · optional

The caller's own id. Echoed back in the error body.

reissueCard
​boolean · optional

Default false — Reissue the card with the status change.

closeRequestDate
​string · optional

The 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.

Example: 2026-10-16T14:30:00Z
changeMeOnly
​boolean · optional

Default false — Change only this card, not the cards that would follow it.

ChangeCardStatusResponse

toStatusActive
​boolean · required

Whether the card ends this operation in an active status.

resetCustomerLimit
​boolean · required
listOfShadowCardNumberForClosedCard
​array · optional

The cards the operation closed.

listOfCardRefNumberForResetLimit
​array · optional
newShadowCardNumber
​string · optional

ChangeCorporateCardLimitDecreaseRequest

channel
​string · maxLength: 3 · required

Three-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.

shadowCardNumber
​string · maxLength: 19 · optional

The 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.

limit
​number · double · optional

The limit to set.

cardRefNumber
​string · maxLength: 19 · optional

The card reference, which identifies one issued card including its renewals. Returned by the create and listing operations alongside the shadow number.

limitRatio
​number · double · optional

The limit as a share of another limit rather than an amount.

cashLimitRatio
​number · double · optional

How much of the card's limit may be drawn as cash, as a share.

changeCustomerLimit
​boolean · optional

Whether the customer's limit moves with the card's.

cardProfileSetCode
​string · maxLength: 10 · optional

Which profile set the card's limits come from. Defined in the parameter tables.

applicationNo
​string · optional

Not 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

channel
​string · maxLength: 3 · required

Three-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.

limit
​number · double · required

The 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.

shadowCardNumber
​string · maxLength: 19 · optional

One-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.

cardRefNumber
​string · maxLength: 19 · optional

One-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.

limitRatio
​number · double · optional

The limit as a share of another limit rather than an amount.

cashLimitRatio
​number · double · optional

How much of the card's limit may be drawn as cash, as a share.

changeCustomerLimit
​boolean · optional

Default 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.

cardProfileSetCode
​string · maxLength: 10 · optional

The 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

listOfCardLimitChangeLogId
​array · optional

The limit changes to reverse, by the log id each change returned.

listOfCustomerLimitChangeLogId
​array · optional

The customer limit changes to reverse, by the log id each change returned.

ChangeCreditCardStatementPeriodRequest

statementPeriod
​string · maxLength: 6 · required

Which statement period the card is billed on. The periods a product allows come from the reference data.

shadowCardNumber
​string · maxLength: 19 · optional

The 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.

ChangeCreditCardStatementPeriodResponse

changeRecordId
​integer · int64 · required

ChangeCreditCardStatementSendPreferenceRequest

mainCardRefNumber
​string · maxLength: 19 · optional

The 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.

emailSendFlag
​boolean · optional

Whether the statement is sent by e-mail.

postingFlag
​boolean · optional

Whether the statement is posted on paper.

smsSendFlag
​boolean · optional

Whether the statement is announced by SMS.

postingAddressType
​string · maxLength: 2 · optional

Which kind of address the statement is posted to.

ChangeCreditCardStatementSendPreferenceResponse

ChangeCustomerBranchRequest

channel
​string · maxLength: 3 · required

Three-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.

customerNumber
​integer · int64 · optional

The 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.

targetBranchCode
​integer · int32 · optional

The branch to move the card or customer to.

ChangeCustomerBranchResponse

oldBranch
​integer · int32 · required

The branch before the move.

newBranch
​integer · int32 · required

The branch after it.

changedCardCount
​integer · int32 · required

How many cards the operation changed.

listOfShadowCardNumbers
​array · optional

The cards the operation acted on.

ChangeCustomerCreditCardStatusRequest

channel
​string · maxLength: 3 · required

Three-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.

customerNumber
​integer · int64 · min: 1 · required

Customer whose cards are moved. Rejected by the facade when absent, and by the service again when zero.

cardStatusCode
​string · maxLength: 2 · optional

Values:

  • A — valid
  • B — pending
  • C — stolen
  • D — cancelled by the bank
  • F — fraud
  • G — temporarily blocked
  • I — cancelled
  • L — lost
  • M — cancelled by the customer
  • T — corporate dummy
cardStatusReasonCode
​string · maxLength: 2 · optional

Why the status is being set. The valid reasons depend on the status: getAvailableCardStatusList returns the pairs a card may move to.

activateCard
​boolean · optional

Whether to activate the card as it is created.

ChangeCustomerCreditCardStatusResponse

listOfShadowCardNumberForClosedCard
​array · optional

The cards the operation closed.

ChangeIndividualCardLimitRequest

channel
​string · maxLength: 3 · required

Three-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.

customerNumber
​integer · int64 · optional

The 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.

cardRefNumber
​string · maxLength: 19 · optional

The card reference, which identifies one issued card including its renewals. Returned by the create and listing operations alongside the shadow number.

newCustomerLimit
​number · double · optional

The limit to set on the customer.

newCardLimit
​number · double · optional

The limit to set on the card.

increaseAllMainCardsLimitFlag
​boolean · optional

Whether the increase applies to every main card of the customer.

ChangeIndividualCardLimitResponse

listOfCardLimitChangeLogId
​array · optional

The limit changes to reverse, by the log id each change returned.

listOfCustomerLimitChangeLogId
​array · optional

The customer limit changes to reverse, by the log id each change returned.

ChangeRsaPinRequest

channel
​string · maxLength: 3 · required

Three-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.

shadowCardNumber
​string · maxLength: 19 · required

The card the operation acts on, by its shadow card number — the platform's own reference, not the PAN.

currentEPB
​string · required

The 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.

newEPB
​string · required

The 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.

operationDateOfCurrent
​string · required

The 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.

Example: 2026-10-16T14:30:00Z
operationDateOfNew
​string · required

The 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.

Example: 2026-10-16T14:30:00Z

ChangeRsaPinResponse

success
​boolean · required

Whether 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.

encryptedPin
​string · optional

The PIN block as the key management service produced it. The PIN itself never travels.

responseCode
​integer · int32 · optional

The 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.

responseDescription
​string · optional

The description of responseCode, carried alongside it for display. It is not a key: match on the code.

ChangeVirtualCardLimitRequest

channel
​string · maxLength: 3 · required

Three-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.

cardRefNumber
​string · maxLength: 19 · optional

Required 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.

limitType
​string · enum · maxLength: 1 · optional

Required 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 set
  • H — decreasing — each transaction reduces it

Not set is N.

newDemandedAvailableLimit
​number · double · optional

Required 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.

endOfDayFlag
​boolean · optional

Conditional — 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

newLimit
​number · double · required
listOfCardLimitChangeLogId
​array · optional

The limit changes to reverse, by the log id each change returned.

CheckCreditCardForDebtPaymentRequest

channelCode
​string · maxLength: 3 · required

Three-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.

pan
​string · required

Clear 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

isRipper
​boolean · required
result
​string · optional

The outcome, as the downstream system words it.

errorCode
​string · optional

The platform's own code for the error, and what to match on.

errorMessage
​string · optional
errorService
​string · optional
processorBin
​string · optional
bankCode
​string · optional
bankName
​string · optional
isSuplemantary
​boolean · optional
​object · optional

The card the operation is answering about.

CreateCardMiscOption

optionType
​string · enum · maxLength: 20 · optional

Values:

  • DS — digital slip — whether the cardholder's slip is printed
  • DC — dynamic CVV — whether the card's CVV is generated per period
optionValue
​string · enum · maxLength: 100 · optional

Values:

  • HardCopy — a printed slip — the value DS takes
  • DigitalSlip — a digital slip — the value DS takes
  • true — dynamic CVV on — the value DC takes, compared as this exact string

CreateCardPermissions

eCommercePermitted
​boolean · optional

Whether the card may be used online.

mailOrderPermitted
​boolean · optional

Whether the card may be used for mail and telephone order.

internationalPurchasePermitted
​boolean · optional

Whether the card may be used abroad.

CreateCorporateCardRequest

channel
​string · maxLength: 3 · required

Three-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.

productNumber
​string · maxLength: 5 · required

Product 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.

customerNumber
​integer · int64 · min: 1 · required

Customer the card belongs to. Rejected when absent, when zero, and when the number has no personal-information record.

shadowCardNumber
​string · maxLength: 19 · required

The 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.

branchCode
​integer · int32 · required

Branch the application is made at. Rejected when absent and again when it matches no branch.

digitalCardFlag
​boolean · optional

Ask for the card to be issued as digital. Refused when the product has no digital card ability.

nameOnCard
​string · maxLength: 26 · optional

The 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.

secondNameOnCard
​string · maxLength: 26 · optional

The second embossed line, used for the company name on a corporate card.

cardDeliveryType
​string · enum · maxLength: 1 · optional

Values:

  • P — by post
  • S — to the branch

Not set is "".

cardSendAddressType
​string · enum · maxLength: 2 · optional

Which address the card is sent to. Only checked when supplied, and then it may not resolve to None.

Values:

  • RA — home
  • AL — business
  • EA — employer
  • OO — alternative
  • WA — previous
  • SW — SWIFT
  • SS — SWIFT name and address
  • MR — Mernis, registered
  • MS — Mernis, stated

Not set is --.

cardSendAddressId
​integer · int64 · optional

Which of the customer's addresses to send the card to. The identifier of an address already held for that customer, not an address.

cardDeliveryBranchCode
​integer · int32 · optional

Conditional · 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.

enrollMasterpass
​boolean · optional

Whether to enrol the new card with Masterpass. Forwarded to the issuing service, which does the enrolment; the card is created either way.

​object · optional

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.

​array · optional

The accounts to attach to the card as it is created. Each entry carries the account's own identifiers; attaching one later is attachCardAccount.

contractType
​string · maxLength: 20 · optional

Which cardholder contract the customer accepted. The pair with contractVersionNumber records what was agreed to and when.

contractVersionNumber
​string · maxLength: 20 · optional

Which version of that contract the customer accepted.

cardLimitValue
​number · double · optional

The spending limit to open the card with.

authorizationSmsSendFlag
​boolean · optional

Whether an SMS is sent for each authorisation on the card.

authorizationSmsSendMinimumAmount
​number · double · optional

The amount an authorisation has to reach before that SMS is sent.

applicationId
​string · maxLength: 50 · optional

The card application this request belongs to. Returned when an application is created, and carried through the card that comes out of it.

applicationDate
​string · optional

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.

Example: 2026-10-16T14:30:00Z
applicationContractId
​string · maxLength: 20 · optional

The contract record in the application system that this card comes from.

CreateCorporateCardResponse

recordId
​integer · int64 · required

The identifier of the row the operation created or acted on. Returned rather than sent in most operations that carry it.

maskedCardNumber
​string · optional

The 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.

shadowCardNumber
​string · optional

The 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.

mainShadowCardNumber
​string · optional
cardRefNumber
​string · optional

The card reference, which identifies one issued card including its renewals. Returned by the create and listing operations alongside the shadow number.

mainCardRefNumber
​string · optional

The 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.

​object · optional

What the operation wants to say about work it did anyway. A warning does not mean the operation failed.

​object · optional

The card number, expiry and verification value, returned only where the operation and the channel are entitled to them.

CreateDisputeCaseDetail

DisputeAmount
​number · double · required

Amount disputed for this transaction. The contract holds a non-nullable number, so leaving the field out sends 0.

UTID
​string · maxLength: 50 · optional

Required 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.

CurrencyCode
​string · maxLength: 3 · optional

Currency 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.

DisputeAmountCurrencyCode
​string · maxLength: 3 · optional

Currency of the disputed amount, and the field both routes read first.

ClearingChannel
​string · maxLength: 4 · optional

With 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.

ClearingTableName
​string · maxLength: 30 · optional

Which clearing table the disputed record is in. Only the integration route reads it.

ClearingNumber
​integer · int64 · optional

Which 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.

AcquirerRefNumber
​string · maxLength: 23 · optional

The acquirer's reference for the disputed transaction. Only the integration route reads it.

ExternalCaseId
​string · optional

Required 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.

ExternalDocumentId
​string · optional

Required 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.

SpecialFollowup
​string · maxLength: 1 · optional

Whether 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.

VipFlag
​string · maxLength: 1 · optional

Whether the cardholder is a VIP, Y or N. The integration service substitutes N for a blank; the local route drops it.

​array · optional

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

Channel
​string · maxLength: 3 · required

Three-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.

ShadowCardNumber
​string · maxLength: 19 · optional

Shadow 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.

CardRefNumber
​string · maxLength: 19 · optional

Card 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.

EncryptedCardNumber
​string · optional

Encrypted 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.

CardNumber
​string · optional

Plain 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.

CaseType
​string · enum · maxLength: 1 · optional

Which 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 side
  • A — acquirer side
DisputeDate
​string · optional

Required — 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.

Example: 2026-10-16T14:30:00Z
DisputeReasonCode
​string · maxLength: 2 · optional

Dispute 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.

DisputeExplanation
​string · maxLength: 512 · optional

Required in practice — Free-text explanation of the dispute. Both routes refuse a blank one, and neither declares the field required.

ExternalCaseId
​string · optional

Not 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.

SpecialFollowup
​string · maxLength: 1 · optional

Not 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.

VipFlag
​string · maxLength: 1 · optional

Not 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.

​array · optional

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.

​array · optional

Document references to attach to the new case. Only the identifier of each entry is forwarded, on both routes.

CreateDisputeCaseResponse

CaseNumber
​integer · int32 · required

The dispute case this belongs to.

​array · optional

The transactions the case covers.

CreateDummyCorporateCardRequest

channel
​string · maxLength: 3 · required

Three-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.

productNumber
​string · maxLength: 5 · required

Product 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.

customerNumber
​integer · int64 · min: 1 · required

Customer the card belongs to. Rejected when absent and again when zero.

branchCode
​integer · int32 · required

Branch the application is made at. Rejected when absent and again when it matches no branch.

digitalCardFlag
​boolean · optional

Ask for the card to be issued as digital. Refused when the product has no digital card ability.

nameOnCard
​string · maxLength: 26 · optional

The 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.

statementPeriod
​string · maxLength: 6 · optional

Which statement period the card is billed on. The periods a product allows come from the reference data.

statementCurrencyCode
​string · maxLength: 3 · optional

The currency the statement is produced in.

statementPostFlag
​boolean · optional

Whether the statement is posted on paper.

statementSmsSendFlag
​boolean · optional

Whether the statement is announced by SMS.

statementEmailSendFlag
​boolean · optional

Whether the statement is sent by e-mail.

statementSendingAddressType
​string · maxLength: 2 · optional

Which address the statement is sent to. Only checked when supplied, and then it may not resolve to None.

statementSendAddressId
​integer · int64 · optional

Which of the customer's addresses the statement is posted to.

cardLimitValue
​number · double · optional

The spending limit to open the card with.

customerLimitValue
​number · double · optional

The limit for the customer behind the card, which the card's own limit draws against.

autoInstallmentCount
​integer · int32 · optional

How many instalments a purchase is split into automatically, where the product allows it.

autoDeferringMonthCount
​integer · int32 · optional

How many months a purchase is deferred automatically, where the product allows it.

autoLimitIncreaseFlag
​boolean · optional

Whether the card takes part in automatic limit increases.

autoPaymentFlag
​boolean · optional

Whether the card's debt is paid automatically. The account it is paid from is autoPaymentAccount, which is only read when this is true.

​object · optional

The account automatic payment draws on. Read only when autoPaymentFlag is true; otherwise no payment order is created.

applicationId
​string · maxLength: 50 · optional

The card application this request belongs to. Returned when an application is created, and carried through the card that comes out of it.

applicationDate
​string · optional

Application 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.

Example: 2026-10-16T14:30:00Z
applicationContractId
​string · maxLength: 20 · optional

The contract record in the application system that this card comes from.

CreateDummyCorporateCardResponse

cardMasterRecordId
​integer · int64 · required
secureCardMasterRecordId
​integer · int64 · required
cardRefNumber
​string · optional

The card reference, which identifies one issued card including its renewals. Returned by the create and listing operations alongside the shadow number.

mainCardRefNumber
​string · optional

The 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.

shadowCardNumber
​string · optional

The 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.

​object · optional

What the operation wants to say about work it did anyway. A warning does not mean the operation failed.

CreateIndividualCardAccount

accountNumber
​integer · int64 · required

The 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.

accountType
​string · enum · maxLength: 1 · optional

Values:

  • A — main account
  • V — virement
accountOrderFlag
​boolean · optional

Not 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.

currencyCode
​string · maxLength: 3 · optional

The currency of the amount, as its three-letter code.

CreateIndividualCardAutoPaymentAccount

accountBranchId
​integer · int32 · required

The branch that holds the account, as core banking numbers it.

accountNumber
​integer · int64 · required

The 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.

paymentType
​string · maxLength: 3 · optional

What kind of payment this is.

accountSuffix
​integer · int32 · optional

The suffix that distinguishes one account from another under the same number at core banking.

CreateIndividualCardRequest

channel
​string · maxLength: 3 · required

Three-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.

productNumber
​string · maxLength: 5 · required

The product the card is issued on. Must be defined, applicable, and have at least one applicable channel.

customerNumber
​integer · int64 · required

The customer the card is issued to.

branchCode
​integer · int32 · required

The branch the card is issued from. Must be a defined branch.

digitalCardFlag
​boolean · optional

Whether to issue the card as a digital one. It also decides the default e-commerce permission where permissions leaves that unset.

nameOnCard
​string · maxLength: 26 · optional

The 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.

secondNameOnCard
​string · maxLength: 26 · optional

The second embossed line, used for the company name on a corporate card.

cardDeliveryType
​string · enum · maxLength: 1 · optional

How the card reaches the cardholder. Branch makes cardDeliveryBranchCode mandatory.

Values:

  • P — by post
  • S — to the branch

Not set is "".

cardSendAddressType
​string · enum · maxLength: 2 · optional

Values:

  • RA — home
  • AL — business
  • EA — employer
  • OO — alternative
  • WA — previous
  • SW — SWIFT
  • SS — SWIFT name and address
  • MR — Mernis, registered
  • MS — Mernis, stated

Not set is --.

cardDeliveryBranchCode
​integer · int32 · optional

Conditional · NotNull — The branch the card is delivered to. Mandatory when cardDeliveryType is Branch.

cardSendAddressId
​integer · int64 · optional

Which of the customer's addresses to send the card to. The identifier of an address already held for that customer, not an address.

​object · optional

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.

​array · optional

The accounts to attach to the card as it is created. Each entry carries the account's own identifiers; attaching one later is attachCardAccount.

​object · optional

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.

enrollMasterpass
​boolean · optional

Whether to enrol the new card with Masterpass. Forwarded to the issuing service, which does the enrolment; the card is created either way.

contractType
​string · maxLength: 20 · optional

Which cardholder contract the customer accepted. The pair with contractVersionNumber records what was agreed to and when.

contractVersionNumber
​string · maxLength: 20 · optional

Which version of that contract the customer accepted.

statementPeriod
​string · maxLength: 6 · optional

Which statement period the card is billed on. The periods a product allows come from the reference data.

statementCurrencyCode
​string · maxLength: 3 · optional

The currency the statement is produced in.

statementSendingAddressType
​string · maxLength: 2 · optional

Which kind of address that is.

statementPostFlag
​boolean · optional

Whether the statement is posted on paper.

statementSmsSendFlag
​boolean · optional

Whether the statement is announced by SMS.

statementEmailSendFlag
​boolean · optional

Whether the statement is sent by e-mail.

statementSendAddressId
​integer · int64 · optional

Which of the customer's addresses the statement is posted to.

cardLimitValue
​number · double · optional

The spending limit to open the card with.

customerLimitValue
​number · double · optional

The limit for the customer behind the card, which the card's own limit draws against.

authorizationSmsSendFlag
​boolean · optional

Whether an SMS is sent for each authorisation on the card.

authorizationSmsSendMinimumAmount
​number · double · optional

The amount an authorisation has to reach before that SMS is sent.

autoInstallmentCount
​integer · int32 · optional

How many instalments a purchase is split into automatically, where the product allows it.

autoDeferringMonthCount
​integer · int32 · optional

How many months a purchase is deferred automatically, where the product allows it.

autoLimitIncreaseFlag
​boolean · optional

Whether the card takes part in automatic limit increases.

autoPaymentFlag
​boolean · optional

Whether the card's debt is paid automatically. The account it is paid from is autoPaymentAccount, which is only read when this is true.

​object · optional

The account automatic payment draws on. Read only when autoPaymentFlag is true; otherwise no payment order is created.

applicationId
​string · maxLength: 50 · optional

The card application this request belongs to. Returned when an application is created, and carried through the card that comes out of it.

applicationDate
​string · optional

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.

Example: 2026-10-16T14:30:00Z
applicationContractId
​string · maxLength: 20 · optional

The contract record in the application system that this card comes from.

CreateIndividualCardResponse

recordId
​integer · int64 · required

The identifier of the row the operation created or acted on. Returned rather than sent in most operations that carry it.

maskedCardNumber
​string · optional

The 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.

shadowCardNumber
​string · optional

The 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.

cardRefNumber
​string · optional

The card reference, which identifies one issued card including its renewals. Returned by the create and listing operations alongside the shadow number.

mainCardRefNumber
​string · optional

The 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.

​object · optional

What the operation wants to say about work it did anyway. A warning does not mean the operation failed.

​object · optional

The card number, expiry and verification value, returned only where the operation and the channel are entitled to them.

CreateIndividualCreditCardPermissions

eCommercePermitted
​boolean · optional

Whether the card may be used online.

mailOrderPermitted
​boolean · optional

Whether the card may be used for mail and telephone order.

internationalPurchasePermitted
​boolean · optional

Whether the card may be used abroad.

CreateIndividualSupplementaryCardRequest

channel
​string · maxLength: 3 · required

Three-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.

productNumber
​string · maxLength: 5 · required

Product 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.

customerNumber
​integer · int64 · min: 1 · required

Customer 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.

shadowCardNumber
​string · maxLength: 19 · required

The 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.

branchCode
​integer · int32 · required

Branch the application is made at. Rejected when absent and rejected again when it matches no branch.

digitalCardFlag
​boolean · optional

Ask 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.

nameOnCard
​string · maxLength: 26 · optional

The 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.

secondNameOnCard
​string · maxLength: 26 · optional

The second embossed line, used for the company name on a corporate card.

cardDeliveryType
​string · enum · maxLength: 1 · optional

Conditional · 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 post
  • S — to the branch

Not set is "".

cardSendAddressType
​string · enum · maxLength: 2 · optional

Which 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 — home
  • AL — business
  • EA — employer
  • OO — alternative
  • WA — previous
  • SW — SWIFT
  • SS — SWIFT name and address
  • MR — Mernis, registered
  • MS — Mernis, stated

Not set is --.

cardDeliveryBranchCode
​integer · int32 · optional

Conditional · NotNull — Branch the card is delivered to. Required when cardDeliveryType is the branch delivery type, and the branch it names must exist. Ignored otherwise.

cardSendAddressId
​integer · int64 · optional

Which of the customer's addresses to send the card to. The identifier of an address already held for that customer, not an address.

​object · optional

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.

​array · optional

The accounts to attach to the card as it is created. Each entry carries the account's own identifiers; attaching one later is attachCardAccount.

​object · optional

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.

enrollMasterpass
​boolean · optional

Whether to enrol the new card with Masterpass. Forwarded to the issuing service, which does the enrolment; the card is created either way.

contractType
​string · maxLength: 20 · optional

Which cardholder contract the customer accepted. The pair with contractVersionNumber records what was agreed to and when.

contractVersionNumber
​string · maxLength: 20 · optional

Which version of that contract the customer accepted.

cardLimitValue
​number · double · optional

The spending limit to open the card with.

authorizationSmsSendFlag
​boolean · optional

Whether an SMS is sent for each authorisation on the card.

authorizationSmsSendMinimumAmount
​number · double · optional

The amount an authorisation has to reach before that SMS is sent.

autoInstallmentCount
​integer · int32 · optional

How many instalments a purchase is split into automatically, where the product allows it.

autoDeferringMonthCount
​integer · int32 · optional

How many months a purchase is deferred automatically, where the product allows it.

applicationId
​string · maxLength: 50 · optional

The card application this request belongs to. Returned when an application is created, and carried through the card that comes out of it.

applicationDate
​string · optional

Application 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.

Example: 2026-10-16T14:30:00Z
applicationContractId
​string · maxLength: 20 · optional

The contract record in the application system that this card comes from.

CreateIndividualSupplementaryCardResponse

recordId
​integer · int64 · required

The identifier of the row the operation created or acted on. Returned rather than sent in most operations that carry it.

maskedCardNumber
​string · optional

The 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.

shadowCardNumber
​string · optional

The 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.

cardRefNumber
​string · optional

The card reference, which identifies one issued card including its renewals. Returned by the create and listing operations alongside the shadow number.

mainCardRefNumber
​string · optional

The 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.

​object · optional

What the operation wants to say about work it did anyway. A warning does not mean the operation failed.

​object · optional

The card number, expiry and verification value, returned only where the operation and the channel are entitled to them.

CreateNoNameCardAccount

accountNumber
​integer · int64 · required

The 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.

accountType
​string · enum · maxLength: 1 · optional

Values:

  • A — main account
  • V — virement
accountOrderFlag
​boolean · optional

Not 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.

currencyCode
​string · maxLength: 3 · optional

The currency of the amount, as its three-letter code.

CreateNoNameCardPermissions

eCommercePermitted
​boolean · optional

Whether the card may be used online.

mailorderPermitted
​boolean · optional
internationalPurchasePermitted
​boolean · optional

Whether the card may be used abroad.

CreateNoNameCardRequest

channel
​string · maxLength: 3 · required

Three-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.

productNumber
​string · maxLength: 5 · required

The card product the card is issued on. Defined in the parameter tables; getCardProductList returns the ones a tenant may use.

barcode
​string · maxLength: 120 · optional

The delivery barcode the consignment is tracked by.

customerNumber
​integer · int64 · optional

The 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.

mainCustomerNumber
​integer · int64 · optional

The main customer of a corporate relationship, as a number. The employees and supplementary holders under it carry their own customerNumber.

mainCardRefNumber
​string · maxLength: 19 · optional

The 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.

branchCode
​integer · int32 · optional

The branch the card is opened at, as a number. Held as a number rather than text throughout.

cardSendAddressType
​string · enum · maxLength: 2 · optional

Values:

  • RA — home
  • AL — business
  • EA — employer
  • OO — alternative
  • WA — previous
  • SW — SWIFT
  • SS — SWIFT name and address
  • MR — Mernis, registered
  • MS — Mernis, stated

Not set is --.

enrollMasterpass
​boolean · optional

Whether to enrol the new card with Masterpass. Forwarded to the issuing service, which does the enrolment; the card is created either way.

​object · optional

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.

​array · optional

The accounts to attach to the card as it is created. Each entry carries the account's own identifiers; attaching one later is attachCardAccount.

contractType
​string · maxLength: 20 · optional

Which cardholder contract the customer accepted. The pair with contractVersionNumber records what was agreed to and when.

statementPeriod
​string · maxLength: 6 · optional

Which statement period the card is billed on. The periods a product allows come from the reference data.

statementCurrencyCode
​string · maxLength: 3 · optional

The currency the statement is produced in.

cardLimitValue
​number · double · optional

The spending limit to open the card with.

customerLimitValue
​number · double · optional

The limit for the customer behind the card, which the card's own limit draws against.

autoLimitIncreaseFlag
​boolean · optional

Whether the card takes part in automatic limit increases.

applicationId
​string · maxLength: 50 · optional

The card application this request belongs to. Returned when an application is created, and carried through the card that comes out of it.

applicationDate
​string · optional

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.

Example: 2026-10-16T14:30:00Z
applicationContractId
​string · maxLength: 20 · optional

The contract record in the application system that this card comes from.

CreateNoNameCardResponse

recordId
​integer · int64 · required

The identifier of the row the operation created or acted on. Returned rather than sent in most operations that carry it.

maskedCardNumber
​string · optional

The 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.

shadowCardNumber
​string · optional

The 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.

cardRefNumber
​string · optional

The card reference, which identifies one issued card including its renewals. Returned by the create and listing operations alongside the shadow number.

mainCardRefNumber
​string · optional

The 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.

​object · optional

What the operation wants to say about work it did anyway. A warning does not mean the operation failed.

​object · optional

The card number, expiry and verification value, returned only where the operation and the channel are entitled to them.

CreateVirtualCardRequest

channel
​string · maxLength: 3 · required

Three-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.

shadowCardNumber
​string · maxLength: 19 · required

The 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.

limitType
​string · enum · maxLength: 1 · required

How 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 set
  • H — decreasing — each transaction reduces it

Not set is N.

endOfDayFlag
​boolean · optional

Conditional · 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.

limit
​number · double · optional

Default — Defaults to 0. The virtual card's limit. It may not exceed the related card's available limit.

enrollMasterpass
​boolean · optional

Whether to enrol the new card with Masterpass. Forwarded to the issuing service, which does the enrolment; the card is created either way.

CreateVirtualCardResponse

recordId
​integer · int64 · required

The identifier of the row the operation created or acted on. Returned rather than sent in most operations that carry it.

maskedCardNumber
​string · optional

The 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.

shadowCardNumber
​string · optional

The 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.

cardRefNumber
​string · optional

The card reference, which identifies one issued card including its renewals. Returned by the create and listing operations alongside the shadow number.

relatedCardRefNumber
​string · optional

The card this one is related to, where it is.

mainCardRefNumber
​string · optional

The 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.

​object · optional

What the operation wants to say about work it did anyway. A warning does not mean the operation failed.

​object · optional

The card number, expiry and verification value, returned only where the operation and the channel are entitled to them.

CreditCardCollectionInfo

delayDayCount
​integer · int32 · required
lastStatementMinAmount
​number · double · required
lastPaymentAmount
​number · double · required
lastPaymentDate
​string · required

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.

Example: 2026-10-16T14:30:00Z
statementDate
​string · required

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.

Example: 2026-10-16T14:30:00Z
totalDebit
​number · double · required
statementTotalAmount
​number · double · required

What the statement comes to.

remainingMinimumPaymentAmount
​number · double · required
statementDueDate
​string · required

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.

Example: 2026-10-16T14:30:00Z
totalAmount
​number · double · required

The amount of every entry in the list added together.

totalAmountForCreditTransactions
​number · double · required
totalAmountForDebitTransactions
​number · double · required
customerLimit
​number · double · required

The limit of the customer behind the card.

cardOpeningDate
​string · required

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.

Example: 2026-10-16T14:30:00Z
statementRemainAmount
​number · double · required

What is left of the statement.

cardLimit
​number · double · required

The card's own spending limit.

cardAvailableLimit
​number · double · required

How much of the card's limit is left.

nextStatementDate
​string · required

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.

Example: 2026-10-16T14:30:00Z
minimumPaymentAmount
​number · double · required

The least that may be paid this period.

supplementaryCardFlag
​boolean · required

Whether this is a supplementary card rather than a main one.

currentCardFlag
​boolean · required
hasCardAutoPayment
​boolean · required
autoPaymentAccountNumber
​integer · int64 · required
customerNumber
​integer · int64 · required

The 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.

remainingDebt
​number · double · required

What is still owed.

branchCode
​string · optional

The branch the card is opened at, as a number. Held as a number rather than text throughout.

branchName
​string · optional

The branch's name.

productNumber
​string · optional

The card product the card is issued on. Defined in the parameter tables; getCardProductList returns the ones a tenant may use.

productSegment
​string · enum · optional

Values:

  • B — individual
  • T — corporate

Not set is "".

productName
​string · optional

The card product's full name.

subProductType
​string · optional
maskedCardNumber
​string · optional

The 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.

shadowCardNumber
​string · optional

The 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.

guarantor
​string · optional
statementCurrencyCode
​string · optional

The currency the statement is produced in.

transferedCardNumberText
​string · optional
cardStatusDescription
​string · optional
delinquencyStatus
​string · optional

Values:

  • N — normal
  • D — delinquent for the period
  • G — delinquent
delinquencyStartDate
​string · optional

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.

Example: 2026-10-16T14:30:00Z
reconstructAmount
​number · double · optional

CreditCardCollectionTransactionItem

customerNumber
​integer · int64 · optional

The 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.

maskedCardNumber
​string · optional

The 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.

transactionNumber
​string · optional
transactionType
​string · optional
debitCreditIndicator
​string · optional
amount
​number · double · optional

The amount.

CreditCardCurrentPeriodTransactionModel

totalAmount
​number · double · required

The amount of every entry in the list added together.

currentDebt
​number · double · required

What is owed as of now.

remaingStatementDebt
​number · double · required

What is left of the statement's debt.

estimatedStatementDebt
​number · double · required
currencyCode
​string · optional

The currency of the amount, as its three-letter code.

​array · optional
​array · optional
​array · optional

CreditCardCurrentPeriodTransactionModels

totalAmount
​number · double · required

The amount of every entry in the list added together.

currentDebt
​number · double · required

What is owed as of now.

remaingStatementDebt
​number · double · required

What is left of the statement's debt.

estimatedStatementDebt
​number · double · required
currencyCode
​string · optional

The currency of the amount, as its three-letter code.

​array · optional
​array · optional

CreditCardDetailTransactionItem

amount
​number · double · required

The amount.

trnAmount
​number · double · required

The amount of the transaction, in its own currency.

date
​string · required

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.

Example: 2026-10-16T14:30:00Z
isDeferrable
​boolean · required

Whether the transaction may be deferred.

isSplittableIntoInstallments
​boolean · required

Whether the transaction may be split into instalments.

totalInstallmentCount
​integer · int32 · required

How many instalments the plan has in all.

currentInstallmentNumber
​integer · int32 · required

Which instalment the plan has reached.

cardProductVirtualFlag
​boolean · required

Whether the product is a virtual one.

cardProductDigitalFlag
​boolean · required

Whether the product can be issued digitally.

supplementaryCardFlag
​boolean · required

Whether this is a supplementary card rather than a main one.

installOrderedFlag
​boolean · required

Whether an instalment plan has been asked for.

orderedInstallCount
​integer · int32 · required

How many instalments were asked for.

orderedDeferCount
​number · double · required

How many months of deferral were asked for.

recordId
​integer · int64 · required

The identifier of the row the operation created or acted on. Returned rather than sent in most operations that carry it.

earlyReleaseOrderedFlag
​boolean · required

Whether early settlement has been asked for.

statementFlag
​boolean · required

Whether the transaction has reached a statement.

digitalSlipFlag
​boolean · required

Whether a digital receipt was produced.

remainingInstallAmount
​number · double · optional
utid
​string · optional

The unique transaction identifier the platform gives a transaction, and the handle every later operation on it takes. Returned by the transaction listings.

authorizationNumber
​string · optional

The authorisation code the issuer returned when the transaction was approved. Six characters, from the scheme.

panEntryMode
​string · optional

How the card was read at the terminal — chip, stripe, contactless, keyed, or stored on file. The scheme's own code.

panEntryModeDescription
​string · optional

The description of panEntryMode, carried alongside it for display. It is not a key: match on the code.

rrn
​string · optional

The retrieval reference number — the card scheme's handle for the transaction, and what a bank quotes when asking the scheme about it.

currencyCode
​string · optional

The currency of the amount, as its three-letter code.

trnCurrencyCode
​string · optional

The currency the transaction was made in.

description
​string · optional

The error in words. errorCode is the part to match on; this is for a log or a screen.

​object · optional

What the transaction earned.

trnCodeMatrixId
​string · optional

Which row of the transaction-code matrix this transaction was classified by.

trnCodeMatrixDescription
​string · optional

The description of trnCodeMatrixId, carried alongside it for display. It is not a key: match on the code.

shadowCardNumber
​string · optional

The 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.

cardRefNumber
​string · optional

The card reference, which identifies one issued card including its renewals. Returned by the create and listing operations alongside the shadow number.

maskedCardNumber
​string · optional

The 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.

mainCardRefNumber
​string · optional

The 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.

capitalRewardIndicator
​string · optional

Whether the reward counts towards the capital scheme.

mcc
​string · optional

The merchant category code — the four-digit code the scheme classifies the merchant's trade with.

mccGroupCode
​string · optional

Which group of merchant categories the merchant falls in.

mCCGroupDescription
​string · optional

The description of mccGroupCode, carried alongside it for display. It is not a key: match on the code.

mccDescription
​string · optional

The description of mcc, carried alongside it for display. It is not a key: match on the code.

trnEffect
​string · optional

Whether the transaction adds to the balance or takes from it.

channelType
​string · optional

The channel a limit row applies to, which is not the channel the request is made on.

channelTypeDescription
​string · optional

The description of channelType, carried alongside it for display. It is not a key: match on the code.

sourceNetwork
​string · optional

Which network the transaction arrived over.

networkTypeDescription
​string · optional
bkmUniqueMerchantId
​string · optional

The merchant's identifier at BKM, the domestic switch.

digitalSlipValue
​string · optional

The digital receipt itself.

currentEodDate
​string · optional

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.

Example: 2026-10-16T14:30:00Z
feeAmount
​number · double · optional

The fee charged on the transaction.

bsmvAmount
​number · double · optional

The BSMV levy on the transaction.

kkdfAmount
​number · double · optional

The KKDF levy on the transaction.

installmentFeeAmount
​number · double · optional

The fee charged for splitting into instalments.

installmentProfitAmount
​number · double · optional

The interest charged across the instalments.

merchantName
​string · optional

The merchant's name as it reached the platform from the scheme.

merchantNumber
​string · optional

The merchant's number with the acquirer.

nextStatementDate
​string · optional

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.

Example: 2026-10-16T14:30:00Z
nextDueDate
​string · optional

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.

Example: 2026-10-16T14:30:00Z

CreditCardDetailTransactionItems

amount
​number · double · required

The amount.

trnAmount
​number · double · required

The amount of the transaction, in its own currency.

date
​string · required

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.

Example: 2026-10-16T14:30:00Z
isDeferrable
​boolean · required

Whether the transaction may be deferred.

isSplittableIntoInstallments
​boolean · required

Whether the transaction may be split into instalments.

totalInstallmentCount
​integer · int32 · required

How many instalments the plan has in all.

currentInstallmentNumber
​integer · int32 · required

Which instalment the plan has reached.

cardProductVirtualFlag
​boolean · required

Whether the product is a virtual one.

cardProductDigitalFlag
​boolean · required

Whether the product can be issued digitally.

supplementaryCardFlag
​boolean · required

Whether this is a supplementary card rather than a main one.

remainingInstallAmount
​number · double · optional
utid
​string · optional

The unique transaction identifier the platform gives a transaction, and the handle every later operation on it takes. Returned by the transaction listings.

currencyCode
​string · optional

The currency of the amount, as its three-letter code.

trnCurrencyCode
​string · optional

The currency the transaction was made in.

trnCodeMatrixId
​string · optional

Which row of the transaction-code matrix this transaction was classified by.

description
​string · optional

The error in words. errorCode is the part to match on; this is for a log or a screen.

​object · optional

What the transaction earned.

shadowCardNumber
​string · optional

The 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.

cardRefNumber
​string · optional

The card reference, which identifies one issued card including its renewals. Returned by the create and listing operations alongside the shadow number.

mainCardRefNumber
​string · optional

The 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.

capitalRewardIndicator
​string · optional

Whether the reward counts towards the capital scheme.

mcc
​string · optional

The merchant category code — the four-digit code the scheme classifies the merchant's trade with.

mccGroupCode
​string · optional

Which group of merchant categories the merchant falls in.

trnEffect
​string · optional

Whether the transaction adds to the balance or takes from it.

bkmUniqueMerchantId
​string · optional

The merchant's identifier at BKM, the domestic switch.

trnCode
​string · optional

What kind of transaction this is, as the platform's own code.

trnCodeDescription
​string · optional

The description of trnCode, carried alongside it for display. It is not a key: match on the code.

channelType
​string · optional

The channel a limit row applies to, which is not the channel the request is made on.

channelDescription
​string · optional

The description of channelType, carried alongside it for display. It is not a key: match on the code.

CreditCardIntermTransactionItem

pageNumber
​integer · int32 · required

Which page of results to return, counting from 1.

rowCount
​integer · int32 · required

How many rows a page holds.

amount
​number · double · required

The amount.

trnAmount
​number · double · required

The amount of the transaction, in its own currency.

date
​string · required

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.

Example: 2026-10-16T14:30:00Z
isDeferrable
​boolean · required

Whether the transaction may be deferred.

isSplittableIntoInstallments
​boolean · required

Whether the transaction may be split into instalments.

totalInstallmentCount
​integer · int32 · required

How many instalments the plan has in all.

currentInstallmentNumber
​integer · int32 · required

Which instalment the plan has reached.

cardProductVirtualFlag
​boolean · required

Whether the product is a virtual one.

cardProductDigitalFlag
​boolean · required

Whether the product can be issued digitally.

supplementaryCardFlag
​boolean · required

Whether this is a supplementary card rather than a main one.

installOrderedFlag
​boolean · required

Whether an instalment plan has been asked for.

orderedInstallCount
​integer · int32 · required

How many instalments were asked for.

orderedDeferCount
​number · double · required

How many months of deferral were asked for.

recordId
​integer · int64 · required

The identifier of the row the operation created or acted on. Returned rather than sent in most operations that carry it.

earlyReleaseOrderedFlag
​boolean · required

Whether early settlement has been asked for.

statementFlag
​boolean · required

Whether the transaction has reached a statement.

digitalSlipFlag
​boolean · required

Whether a digital receipt was produced.

utid
​string · optional

The unique transaction identifier the platform gives a transaction, and the handle every later operation on it takes. Returned by the transaction listings.

authorizationNumber
​string · optional

The authorisation code the issuer returned when the transaction was approved. Six characters, from the scheme.

panEntryMode
​string · optional

How the card was read at the terminal — chip, stripe, contactless, keyed, or stored on file. The scheme's own code.

panEntryModeDescription
​string · optional

The description of panEntryMode, carried alongside it for display. It is not a key: match on the code.

rrn
​string · optional

The retrieval reference number — the card scheme's handle for the transaction, and what a bank quotes when asking the scheme about it.

currencyCode
​string · optional

The currency of the amount, as its three-letter code.

trnCurrencyCode
​string · optional

The currency the transaction was made in.

description
​string · optional

The error in words. errorCode is the part to match on; this is for a log or a screen.

​object · optional

What the transaction earned.

trnCodeMatrixId
​string · optional

Which row of the transaction-code matrix this transaction was classified by.

trnCodeMatrixDescription
​string · optional

The description of trnCodeMatrixId, carried alongside it for display. It is not a key: match on the code.

shadowCardNumber
​string · optional

The 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.

cardRefNumber
​string · optional

The card reference, which identifies one issued card including its renewals. Returned by the create and listing operations alongside the shadow number.

maskedCardNumber
​string · optional

The 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.

mainCardRefNumber
​string · optional

The 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.

capitalRewardIndicator
​string · optional

Whether the reward counts towards the capital scheme.

mcc
​string · optional

The merchant category code — the four-digit code the scheme classifies the merchant's trade with.

mccGroupCode
​string · optional

Which group of merchant categories the merchant falls in.

mCCGroupDescription
​string · optional

The description of mccGroupCode, carried alongside it for display. It is not a key: match on the code.

mccDescription
​string · optional

The description of mcc, carried alongside it for display. It is not a key: match on the code.

trnEffect
​string · optional

Whether the transaction adds to the balance or takes from it.

channelType
​string · optional

The channel a limit row applies to, which is not the channel the request is made on.

channelTypeDescription
​string · optional

The description of channelType, carried alongside it for display. It is not a key: match on the code.

sourceNetwork
​string · optional

Which network the transaction arrived over.

networkTypeDescription
​string · optional
bkmUniqueMerchantId
​string · optional

The merchant's identifier at BKM, the domestic switch.

digitalSlipValue
​string · optional

The digital receipt itself.

currentEodDate
​string · optional

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.

Example: 2026-10-16T14:30:00Z
feeAmount
​number · double · optional

The fee charged on the transaction.

bsmvAmount
​number · double · optional

The BSMV levy on the transaction.

kkdfAmount
​number · double · optional

The KKDF levy on the transaction.

installmentFeeAmount
​number · double · optional

The fee charged for splitting into instalments.

installmentProfitAmount
​number · double · optional

The interest charged across the instalments.

merchantName
​string · optional

The merchant's name as it reached the platform from the scheme.

merchantNumber
​string · optional

The merchant's number with the acquirer.

nextStatementDate
​string · optional

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.

Example: 2026-10-16T14:30:00Z
nextDueDate
​string · optional

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.

Example: 2026-10-16T14:30:00Z

CreditCardModel

supplementaryCardFlag
​boolean · required

Whether this is a supplementary card rather than a main one.

cardRefCurrentCardFlag
​boolean · required

Whether this is the card currently in force under its reference, as opposed to one it replaced.

branchCode
​integer · int32 · required

The branch the card is opened at, as a number. Held as a number rather than text throughout.

mainCardLimit
​number · double · required
cardLimit
​number · double · required

The card's own spending limit.

customerLimit
​number · double · required

The limit of the customer behind the card.

cardCashLimit
​number · double · required
cardAvailableLimit
​number · double · required

How much of the card's limit is left.

cardAvailableCashLimit
​number · double · required
customerAvailableLimit
​number · double · required

How much of the customer's limit is left.

customerAvailableCashLimit
​number · double · required
statementTotalAmount
​number · double · required

What the statement comes to.

statementMinAmount
​number · double · required

The least that may be paid against the statement.

statementTotalCurrent
​number · double · required
statementTotalDueDate
​number · double · required
virtualFlag
​boolean · required

Whether the card is a virtual one.

emvFlag
​boolean · required

Whether the card carries a chip.

magneticStripeFlag
​boolean · required

Whether the card carries a magnetic stripe.

contactlessFlag
​boolean · required

Whether the card can be used contactlessly.

rewardEarningFlag
​boolean · required

Whether the transaction earned a reward.

cvv2RetryCount
​integer · int32 · required

How many verification-value attempts are left before the card blocks.

pinRetryCount
​integer · int32 · required

How many PIN attempts are left before the card blocks.

remainingInstallmentAmount
​number · double · required
totalDebtAmount
​number · double · required
currentDebt
​number · double · required

What is owed as of now.

cardAnnualFeeAmount
​number · double · required

The annual fee the product carries.

limitUsed
​number · double · required

How much of the limit has been used.

pendingReplaceApplicationExists
​boolean · required

Whether a replacement has been asked for and not yet produced.

isDelivered
​boolean · required

Whether the consignment reached the cardholder.

shadowCardNumber
​string · optional

The 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.

maskedCardNumber
​string · optional

The 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.

cardRefNumber
​string · optional

The card reference, which identifies one issued card including its renewals. Returned by the create and listing operations alongside the shadow number.

mainCardRefNumber
​string · optional

The 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.

customerNumber
​string · optional

The 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.

mainCustomerNumber
​string · optional

The main customer of a corporate relationship, as a number. The employees and supplementary holders under it carry their own customerNumber.

relatedCardRefNumber
​string · optional

The card this one is related to, where it is.

ownerName
​string · optional

The cardholder's first name, as the customer record holds it.

ownerSecondName
​string · optional

The cardholder's middle name, where there is one.

ownerSurname
​string · optional

The cardholder's surname, as the customer record holds it.

embossName
​string · optional

The name embossed on the card.

expireDate
​string · optional
limitType
​string · enum · optional

Values:

  • S — fixed — the limit stays as set
  • H — decreasing — each transaction reduces it

Not set is N.

limitStartDate
​string · optional

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.

Example: 2026-10-16T14:30:00Z
limitEndDate
​string · optional

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.

Example: 2026-10-16T14:30:00Z
autoLimitIncreaseFlag
​boolean · optional

Whether the card takes part in automatic limit increases.

mainMaskedCardNumber
​string · optional
productNumber
​string · optional

The card product the card is issued on. Defined in the parameter tables; getCardProductList returns the ones a tenant may use.

cardStatusCode
​string · optional

Values:

  • A — valid
  • B — pending
  • C — stolen
  • D — cancelled by the bank
  • F — fraud
  • G — temporarily blocked
  • I — cancelled
  • L — lost
  • M — cancelled by the customer
  • T — corporate dummy
cardStatusCodeDescription
​string · optional

The description of cardStatusCode, carried alongside it for display. It is not a key: match on the code.

cardStatusReasonCode
​string · optional

Why the status is being set. The valid reasons depend on the status: getAvailableCardStatusList returns the pairs a card may move to.

cardStatusReasonCodeDescription
​string · optional

The description of cardStatusReasonCode, carried alongside it for display. It is not a key: match on the code.

statementDate
​string · optional

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.

Example: 2026-10-16T14:30:00Z
dueDate
​string · optional

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.

Example: 2026-10-16T14:30:00Z
nextStatementDate
​string · optional

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.

Example: 2026-10-16T14:30:00Z
nextDueDate
​string · optional

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.

Example: 2026-10-16T14:30:00Z
productName
​string · optional

The card product's full name.

productShortName
​string · optional

The card product's short name, for a list or a statement line.

tenantId
​string · optional

Which tenant's records to read. Omitting it reads the rows that belong to no tenant rather than all of them.

cardClosedDate
​string · optional

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.

Example: 2026-10-16T14:30:00Z
cardCloseReasonCode
​string · optional
delay
​string · optional
digitalCardFlag
​boolean · optional

Whether to issue the card as a digital one. It also decides the default e-commerce permission where permissions leaves that unset.

cardBrand
​string · optional

Which scheme the card is issued on.

cardBrandDescription
​string · optional

The description of cardBrand, carried alongside it for display. It is not a key: match on the code.

statementCurrencyCode
​string · optional

The currency the statement is produced in.

fromShadowCardNumber
​string · optional

The card this one replaced. Empty where the card is the first of its reference.

statementEurAmount
​number · double · optional
statementUsdAmount
​number · double · optional
cardDeliveryType
​string · enum · optional

Values:

  • P — by post
  • S — to the branch

Not set is "".

applicationDate
​string · optional

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.

Example: 2026-10-16T14:30:00Z
applicationChannelCode
​string · optional
applicationChannelDescription
​string · optional

The description of applicationChannelCode, carried alongside it for display. It is not a key: match on the code.

barcode
​string · optional

The delivery barcode the consignment is tracked by.

toShadowCardNumber
​string · optional

The card this one was replaced by, where it has been. Empty while it is still the current card.

embossReasonCode
​string · optional

Values:

  • N — new card
  • Y — renewal
embossReasonDescription
​string · optional

The description of embossReasonCode, carried alongside it for display. It is not a key: match on the code.

embossReasonSubCode
​string · optional

Values:

  • BRK — broken card
  • CHF — damaged chip
  • EXP — renewal at maturity
  • FRD — fraud
  • MGF — magnetic stripe error
  • NSU — name update
  • OTH — other
  • EXO — bulk renewal at maturity
  • LST — lost card
  • STL — stolen card

Not set is ---.

embossReasonSubDesc
​string · optional

The description of embossReasonSubCode, carried alongside it for display. It is not a key: match on the code.

cardStatusChangeDate
​string · optional

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.

Example: 2026-10-16T14:30:00Z
lastTrnDate
​string · optional

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.

Example: 2026-10-16T14:30:00Z
firstPinSetDate
​string · optional

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.

Example: 2026-10-16T14:30:00Z
lastPinSetDate
​string · optional

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.

Example: 2026-10-16T14:30:00Z
lastPinChangeDate
​string · optional

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.

Example: 2026-10-16T14:30:00Z
isFirstPinSet
​string · optional

Whether the cardholder has set a PIN yet.

deliveryAddress
​string · optional

Where the card is to be delivered, as written.

sendingBranchCode
​integer · int32 · optional

The branch the card is sent from.

sendingAddressType
​string · enum · optional

Values:

  • RA — home
  • AL — business
  • EA — employer
  • OO — alternative
  • WA — previous
  • SW — SWIFT
  • SS — SWIFT name and address
  • MR — Mernis, registered
  • MS — Mernis, stated

Not set is --.

productGroupCode
​string · optional

Which group of products this one belongs to.

productGroupDescription
​string · optional

The description of productGroupCode, carried alongside it for display. It is not a key: match on the code.

fromMaskedCardNumber
​string · optional
toMaskedCardNumber
​string · optional

The replacing card, in its masked form.

customerType
​string · optional

Values:

  • 1 — corporate
  • 2 — individual
  • 3 — employee
  • 4 — sole proprietorship

Not set is N.

​array · optional

The accounts the card draws on.

​object · optional

Filled only for a digital or virtual card. On a physical card it is null.

totalDebtAmountUSD
​number · double · optional
totalDebtAmountEUR
​number · double · optional
statementCurrency
​string · optional

The currency the statement is produced in.

statementPeriod
​string · optional

Which statement period the card is billed on. The periods a product allows come from the reference data.

cardStatusChangeChannel
​string · optional

Which channel last changed the card's status.

securityFlag
​boolean · optional

Whether the card is under a security restriction.

currentAmount
​number · double · optional
currentAmountWithDailyPayment
​number · double · optional

CreditCardNextPeriodInstallmentModel

totalAmount
​number · double · required

The amount of every entry in the list added together.

​array · optional
currencyCode
​string · optional

The currency of the amount, as its three-letter code.

CreditCardPendingTransactionItem

amount
​number · double · required

The amount.

trnAmount
​number · double · required

The amount of the transaction, in its own currency.

date
​string · required

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.

Example: 2026-10-16T14:30:00Z
isDeferrable
​boolean · required

Whether the transaction may be deferred.

isSplittableIntoInstallments
​boolean · required

Whether the transaction may be split into instalments.

totalInstallmentCount
​integer · int32 · required

How many instalments the plan has in all.

currentInstallmentNumber
​integer · int32 · required

Which instalment the plan has reached.

cardProductVirtualFlag
​boolean · required

Whether the product is a virtual one.

cardProductDigitalFlag
​boolean · required

Whether the product can be issued digitally.

supplementaryCardFlag
​boolean · required

Whether this is a supplementary card rather than a main one.

installOrderedFlag
​boolean · required

Whether an instalment plan has been asked for.

orderedInstallCount
​integer · int32 · required

How many instalments were asked for.

orderedDeferCount
​number · double · required

How many months of deferral were asked for.

recordId
​integer · int64 · required

The identifier of the row the operation created or acted on. Returned rather than sent in most operations that carry it.

earlyReleaseOrderedFlag
​boolean · required

Whether early settlement has been asked for.

statementFlag
​boolean · required

Whether the transaction has reached a statement.

digitalSlipFlag
​boolean · required

Whether a digital receipt was produced.

approvedAuthorizationFlag
​boolean · optional
responseCode
​string · optional

The 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.

responseCodeDescription
​string · optional

The description of responseCode, carried alongside it for display. It is not a key: match on the code.

responseReasonCode
​string · optional

Why the downstream system answered as it did, where it narrows the response code.

responseReasonCodeDescription
​string · optional

The description of responseReasonCode, carried alongside it for display. It is not a key: match on the code.

trnStatusCode
​string · optional

Where the transaction has got to, as a code.

trnStatusDescription
​string · optional

The description of trnStatusCode, carried alongside it for display. It is not a key: match on the code.

utid
​string · optional

The unique transaction identifier the platform gives a transaction, and the handle every later operation on it takes. Returned by the transaction listings.

authorizationNumber
​string · optional

The authorisation code the issuer returned when the transaction was approved. Six characters, from the scheme.

panEntryMode
​string · optional

How the card was read at the terminal — chip, stripe, contactless, keyed, or stored on file. The scheme's own code.

panEntryModeDescription
​string · optional

The description of panEntryMode, carried alongside it for display. It is not a key: match on the code.

rrn
​string · optional

The retrieval reference number — the card scheme's handle for the transaction, and what a bank quotes when asking the scheme about it.

currencyCode
​string · optional

The currency of the amount, as its three-letter code.

trnCurrencyCode
​string · optional

The currency the transaction was made in.

description
​string · optional

The error in words. errorCode is the part to match on; this is for a log or a screen.

​object · optional

What the transaction earned.

trnCodeMatrixId
​string · optional

Which row of the transaction-code matrix this transaction was classified by.

trnCodeMatrixDescription
​string · optional

The description of trnCodeMatrixId, carried alongside it for display. It is not a key: match on the code.

shadowCardNumber
​string · optional

The 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.

cardRefNumber
​string · optional

The card reference, which identifies one issued card including its renewals. Returned by the create and listing operations alongside the shadow number.

maskedCardNumber
​string · optional

The 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.

mainCardRefNumber
​string · optional

The 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.

capitalRewardIndicator
​string · optional

Whether the reward counts towards the capital scheme.

mcc
​string · optional

The merchant category code — the four-digit code the scheme classifies the merchant's trade with.

mccGroupCode
​string · optional

Which group of merchant categories the merchant falls in.

mCCGroupDescription
​string · optional

The description of mccGroupCode, carried alongside it for display. It is not a key: match on the code.

mccDescription
​string · optional

The description of mcc, carried alongside it for display. It is not a key: match on the code.

trnEffect
​string · optional

Whether the transaction adds to the balance or takes from it.

channelType
​string · optional

The channel a limit row applies to, which is not the channel the request is made on.

channelTypeDescription
​string · optional

The description of channelType, carried alongside it for display. It is not a key: match on the code.

sourceNetwork
​string · optional

Which network the transaction arrived over.

networkTypeDescription
​string · optional
bkmUniqueMerchantId
​string · optional

The merchant's identifier at BKM, the domestic switch.

digitalSlipValue
​string · optional

The digital receipt itself.

currentEodDate
​string · optional

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.

Example: 2026-10-16T14:30:00Z
feeAmount
​number · double · optional

The fee charged on the transaction.

bsmvAmount
​number · double · optional

The BSMV levy on the transaction.

kkdfAmount
​number · double · optional

The KKDF levy on the transaction.

installmentFeeAmount
​number · double · optional

The fee charged for splitting into instalments.

installmentProfitAmount
​number · double · optional

The interest charged across the instalments.

merchantName
​string · optional

The merchant's name as it reached the platform from the scheme.

merchantNumber
​string · optional

The merchant's number with the acquirer.

nextStatementDate
​string · optional

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.

Example: 2026-10-16T14:30:00Z
nextDueDate
​string · optional

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.

Example: 2026-10-16T14:30:00Z

CreditCardPermissions

restrictionCode
​string · optional

Values:

  • SA — purchase
  • NA — cash
  • DN — domestic cash
  • YD — international sale
  • YN — international cash
  • AT — ATM
  • MO — mail order
  • EC — e-commerce, fully secure
  • EN — e-commerce, half secure
  • EX — e-commerce, not secure
  • CLS — contactless
  • TA — instalment
  • PTH — pre-authorisation
  • QC — quasi cash
  • CB — POS cashback
  • CSB — cashback
  • TCS — POS cash advance
  • FA — bill payment
  • VG — tax payment
  • CEK — cheque
  • FF — FastFund
  • PPP — project sharing programme
restrictionCodeDescription
​string · optional

The description of restrictionCode, carried alongside it for display. It is not a key: match on the code.

restrictionPermissionIndicator
​string · optional

Whether the entry grants the capability or withholds it.

restrictionPermissionIndicatorDescription
​string · optional

The description of restrictionPermissionIndicator, carried alongside it for display. It is not a key: match on the code.

channel
​string · optional

Which channel this restriction covers, not the channel reading it. Empty where the restriction applies to every channel.

securityFlag
​boolean · optional

Whether the card is under a security restriction.

CreditCardStatementItem

recordId
​integer · int64 · required

The identifier of the row the operation created or acted on. Returned rather than sent in most operations that carry it.

statementDebt
​number · double · required

What the statement says is owed.

minimumPaymentAmount
​number · double · required

The least that may be paid this period.

remainingDebt
​number · double · required

What is still owed.

prevTotalAmount
​number · double · required

What the total came to before this change.

statementDate
​string · required

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.

Example: 2026-10-16T14:30:00Z
dueDate
​string · required

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.

Example: 2026-10-16T14:30:00Z
nextStatementDate
​string · required

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.

Example: 2026-10-16T14:30:00Z
nextDueDate
​string · required

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.

Example: 2026-10-16T14:30:00Z
remainingMinimumPaymentDebt
​number · double · required

What is left of the minimum payment.

currencyCode
​string · optional

The currency of the amount, as its three-letter code.

​array · optional

The transactions the search matched.

CreditCardStatementSendPreference

statementEMailSendFlag
​boolean · required
statementPostingFlag
​boolean · required

Whether the statement is posted on paper.

statementSmsSendFlag
​boolean · required

Whether the statement is announced by SMS.

mainCardRefNumber
​string · optional

The 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.

postingAddressType
​string · optional

Which kind of address the statement is posted to.

CreditCardTransactionItem

amount
​number · double · required

The amount.

trnAmount
​number · double · required

The amount of the transaction, in its own currency.

date
​string · required

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.

Example: 2026-10-16T14:30:00Z
isDeferrable
​boolean · required

Whether the transaction may be deferred.

isSplittableIntoInstallments
​boolean · required

Whether the transaction may be split into instalments.

totalInstallmentCount
​integer · int32 · required

How many instalments the plan has in all.

currentInstallmentNumber
​integer · int32 · required

Which instalment the plan has reached.

cardProductVirtualFlag
​boolean · required

Whether the product is a virtual one.

cardProductDigitalFlag
​boolean · required

Whether the product can be issued digitally.

supplementaryCardFlag
​boolean · required

Whether this is a supplementary card rather than a main one.

installOrderedFlag
​boolean · required

Whether an instalment plan has been asked for.

orderedInstallCount
​integer · int32 · required

How many instalments were asked for.

orderedDeferCount
​number · double · required

How many months of deferral were asked for.

recordId
​integer · int64 · required

The identifier of the row the operation created or acted on. Returned rather than sent in most operations that carry it.

earlyReleaseOrderedFlag
​boolean · required

Whether early settlement has been asked for.

statementFlag
​boolean · required

Whether the transaction has reached a statement.

digitalSlipFlag
​boolean · required

Whether a digital receipt was produced.

utid
​string · optional

The unique transaction identifier the platform gives a transaction, and the handle every later operation on it takes. Returned by the transaction listings.

authorizationNumber
​string · optional

The authorisation code the issuer returned when the transaction was approved. Six characters, from the scheme.

panEntryMode
​string · optional

How the card was read at the terminal — chip, stripe, contactless, keyed, or stored on file. The scheme's own code.

panEntryModeDescription
​string · optional

The description of panEntryMode, carried alongside it for display. It is not a key: match on the code.

rrn
​string · optional

The retrieval reference number — the card scheme's handle for the transaction, and what a bank quotes when asking the scheme about it.

currencyCode
​string · optional

The currency of the amount, as its three-letter code.

trnCurrencyCode
​string · optional

The currency the transaction was made in.

description
​string · optional

The error in words. errorCode is the part to match on; this is for a log or a screen.

​object · optional

What the transaction earned.

trnCodeMatrixId
​string · optional

Which row of the transaction-code matrix this transaction was classified by.

trnCodeMatrixDescription
​string · optional

The description of trnCodeMatrixId, carried alongside it for display. It is not a key: match on the code.

shadowCardNumber
​string · optional

The 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.

cardRefNumber
​string · optional

The card reference, which identifies one issued card including its renewals. Returned by the create and listing operations alongside the shadow number.

maskedCardNumber
​string · optional

The 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.

mainCardRefNumber
​string · optional

The 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.

capitalRewardIndicator
​string · optional

Whether the reward counts towards the capital scheme.

mcc
​string · optional

The merchant category code — the four-digit code the scheme classifies the merchant's trade with.

mccGroupCode
​string · optional

Which group of merchant categories the merchant falls in.

mCCGroupDescription
​string · optional

The description of mccGroupCode, carried alongside it for display. It is not a key: match on the code.

mccDescription
​string · optional

The description of mcc, carried alongside it for display. It is not a key: match on the code.

trnEffect
​string · optional

Whether the transaction adds to the balance or takes from it.

channelType
​string · optional

The channel a limit row applies to, which is not the channel the request is made on.

channelTypeDescription
​string · optional

The description of channelType, carried alongside it for display. It is not a key: match on the code.

sourceNetwork
​string · optional

Which network the transaction arrived over.

networkTypeDescription
​string · optional
bkmUniqueMerchantId
​string · optional

The merchant's identifier at BKM, the domestic switch.

digitalSlipValue
​string · optional

The digital receipt itself.

currentEodDate
​string · optional

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.

Example: 2026-10-16T14:30:00Z
feeAmount
​number · double · optional

The fee charged on the transaction.

bsmvAmount
​number · double · optional

The BSMV levy on the transaction.

kkdfAmount
​number · double · optional

The KKDF levy on the transaction.

installmentFeeAmount
​number · double · optional

The fee charged for splitting into instalments.

installmentProfitAmount
​number · double · optional

The interest charged across the instalments.

merchantName
​string · optional

The merchant's name as it reached the platform from the scheme.

merchantNumber
​string · optional

The merchant's number with the acquirer.

nextStatementDate
​string · optional

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.

Example: 2026-10-16T14:30:00Z
nextDueDate
​string · optional

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.

Example: 2026-10-16T14:30:00Z

CreditCardTransactionItems

amount
​number · double · required

The amount.

trnAmount
​number · double · required

The amount of the transaction, in its own currency.

date
​string · required

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.

Example: 2026-10-16T14:30:00Z
isDeferrable
​boolean · required

Whether the transaction may be deferred.

isSplittableIntoInstallments
​boolean · required

Whether the transaction may be split into instalments.

totalInstallmentCount
​integer · int32 · required

How many instalments the plan has in all.

currentInstallmentNumber
​integer · int32 · required

Which instalment the plan has reached.

cardProductVirtualFlag
​boolean · required

Whether the product is a virtual one.

cardProductDigitalFlag
​boolean · required

Whether the product can be issued digitally.

supplementaryCardFlag
​boolean · required

Whether this is a supplementary card rather than a main one.

utid
​string · optional

The unique transaction identifier the platform gives a transaction, and the handle every later operation on it takes. Returned by the transaction listings.

currencyCode
​string · optional

The currency of the amount, as its three-letter code.

trnCurrencyCode
​string · optional

The currency the transaction was made in.

trnCodeMatrixId
​string · optional

Which row of the transaction-code matrix this transaction was classified by.

description
​string · optional

The error in words. errorCode is the part to match on; this is for a log or a screen.

​object · optional

What the transaction earned.

shadowCardNumber
​string · optional

The 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.

cardRefNumber
​string · optional

The card reference, which identifies one issued card including its renewals. Returned by the create and listing operations alongside the shadow number.

mainCardRefNumber
​string · optional

The 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.

capitalRewardIndicator
​string · optional

Whether the reward counts towards the capital scheme.

mcc
​string · optional

The merchant category code — the four-digit code the scheme classifies the merchant's trade with.

mccGroupCode
​string · optional

Which group of merchant categories the merchant falls in.

trnEffect
​string · optional

Whether the transaction adds to the balance or takes from it.

bkmUniqueMerchantId
​string · optional

The merchant's identifier at BKM, the domestic switch.

trnCode
​string · optional

What kind of transaction this is, as the platform's own code.

trnCodeDescription
​string · optional

The description of trnCode, carried alongside it for display. It is not a key: match on the code.

channelType
​string · optional

The channel a limit row applies to, which is not the channel the request is made on.

channelDescription
​string · optional

The description of channelType, carried alongside it for display. It is not a key: match on the code.

CreditCorporateCustomerInfo

mainCustomerNumber
​string · optional

The main customer of a corporate relationship, as a number. The employees and supplementary holders under it carry their own customerNumber.

shadowCardNumber
​string · optional

The 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.

maskedCardNumber
​string · optional

The 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

currentCard
​boolean · required
customerNumber
​integer · int64 · required

The 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.

digitalCard
​boolean · required
mainCustomerNumber
​integer · int64 · required

The main customer of a corporate relationship, as a number. The employees and supplementary holders under it carry their own customerNumber.

supplementaryCard
​boolean · required

Whether this is a supplementary card rather than a main one.

cardRefNumber
​string · optional

The card reference, which identifies one issued card including its renewals. Returned by the create and listing operations alongside the shadow number.

cardStatusCode
​string · optional

Values:

  • A — valid
  • B — pending
  • C — stolen
  • D — cancelled by the bank
  • F — fraud
  • G — temporarily blocked
  • I — cancelled
  • L — lost
  • M — cancelled by the customer
  • T — corporate dummy
cardStatusReasonCode
​string · optional

Why the status is being set. The valid reasons depend on the status: getAvailableCardStatusList returns the pairs a card may move to.

mainCardRefNumber
​string · optional

The 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.

maskedCardNumber
​string · optional

The 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.

productNumber
​string · optional

The card product the card is issued on. Defined in the parameter tables; getCardProductList returns the ones a tenant may use.

shadowCardNumber
​string · optional

The 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.

statementCurrencyCode
​string · optional

The currency the statement is produced in.

statementPeriod
​string · optional

Which statement period the card is billed on. The periods a product allows come from the reference data.

statementPeriodDescription
​string · optional

The description of statementPeriod, carried alongside it for display. It is not a key: match on the code.

nextStatementDate
​string · optional

CustomerLimitationParameterData

customerNumber
​integer · int64 · required

The 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.

customerLimitationFlag
​boolean · optional

Whether the card draws against the customer's limit rather than having one of its own.

profileCode
​string · optional

Which profile the card's limits come from.

profileDescription
​string · optional

The description of profileCode, carried alongside it for display. It is not a key: match on the code.

​object · optional

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.

perTrnAmount
​number · double · optional

The most the card may spend in one transaction.

perTrnAmountLimitRatio
​number · double · optional

The same cap as a share of the card's limit rather than an amount.

dailyTrnCount
​integer · int32 · optional

The most transactions the card may make in a day.

dailyTrnAmount
​number · double · optional

The most the card may spend in a day.

weeklyTrnCount
​integer · int32 · optional

The most transactions the card may make in a week.

weeklyTrnAmount
​number · double · optional

The most the card may spend in a week.

monthlyTrnCount
​integer · int32 · optional

The most transactions the card may make in a month.

monthlyTrnAmount
​number · double · optional

The most the card may spend in a month.

yearlyTrnCount
​integer · int32 · optional

The most transactions the card may make in a year.

yearlyTrnAmount
​number · double · optional

The most the card may spend in a year.

cardType
​string · optional

Which kind of card, as the one-letter code the account type carries: C credit, D debit, P prepaid.

DecreaseCustomerLimitRequest

channel
​string · maxLength: 3 · required

Three-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.

customerNumber
​integer · int64 · min: 1 · required

Customer 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.

newCustomerLimit
​number · double · optional

Required 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.

skipReverseWhenLksFailed
​boolean · optional

Default false — Whether to keep the decrease when the LKS call fails instead of reversing it. Null is read as false.

DecreaseCustomerLimitResponse

listOfCustomerLimitChangeLogId
​array · optional

The customer limit changes to reverse, by the log id each change returned.

listOfCardLimitChangeLogId
​array · optional

The limit changes to reverse, by the log id each change returned.

​object · optional

DetachCardAccountByAccountNumberRequest

channel
​string · maxLength: 3 · required

Three-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.

shadowCardNumber
​string · maxLength: 19 · optional

The 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.

accountNumber
​integer · int64 · optional

The 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.

accountSuffix
​integer · int32 · optional

The suffix that distinguishes one account from another under the same number at core banking.

DetachCardAccountByAccountNumberResponse

DetachCardAccountRequest

channel
​string · maxLength: 3 · required

Three-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.

recordId
​integer · int64 · required

The 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.

shadowCardNumber
​string · maxLength: 19 · required

The card the account is unlinked from.

DetachCardAccountResponse

recordId
​integer · int64 · required

The identifier of the row the operation created or acted on. Returned rather than sent in most operations that carry it.

DisputeList

CaseNumber
​integer · int64 · optional

The dispute case this belongs to.

CustomerNumber
​integer · int64 · optional

The 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.

DisputeAmount
​number · double · optional
DisputeCurrencyCode
​string · optional
DisputeDate
​string · optional

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.

Example: 2026-10-16T14:30:00Z
DisputeReasonCode
​string · optional

Why the case was raised.

DisputeTransactionId
​integer · int64 · optional

The disputed transaction within the case.

InsertUserId
​string · optional

An 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.

MaskedCardNumber
​string · optional

The card number with its middle digits masked, as the platform stores it. It is a display form, not a key.

ShadowCardNumber
​string · optional

The 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.

MerchantName
​string · optional

The merchant's name as it reached the platform from the scheme.

TrnAmount
​number · double · optional

The amount of the transaction, in its own currency.

TrnCurrencyCode
​string · optional

The currency the transaction was made in.

TrnDate
​string · optional

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.

Example: 2026-10-16T14:30:00Z
TrnStatusDescription
​string · optional

The transaction's state in words.

AuthorizationNumber
​string · optional

The authorisation code the issuer returned when the transaction was approved. Six characters, from the scheme.

Mcc
​string · optional

The merchant category code — the four-digit code the scheme classifies the merchant's trade with.

SourceNetwork
​string · optional

Which network the transaction arrived over.

Utid
​string · optional

The unique transaction identifier the platform gives a transaction, and the handle every later operation on it takes. Returned by the transaction listings.

DisputeReasonDefinitions

DisputeReasonCode
​integer · int32 · required

Why the case was raised.

DisputeReasonDescription
​string · optional

The description of DisputeReasonCode, carried alongside it for display. It is not a key: match on the code.

DisputeTransactionDetail

DisputeTransactionId
​integer · int64 · required

The disputed transaction within the case.

UTID
​string · optional

The unique transaction identifier the platform gives a transaction, and the handle every later operation on it takes. Returned by the transaction listings.

DmsReference

DmsReferenceId
​string · optional

Identifier 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

DmsReferenceId
​string · optional

Identifier of a document held in the document management system, and the only part of the entry that is forwarded.

DoCashAdvanceRequest

channelId
​string · maxLength: 3 · required

Three-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.

shadowCardNumber
​string · maxLength: 19 · optional

The 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.

accountNumber
​string · optional

The 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.

referenceNumber
​string · maxLength: 50 · optional

The caller's own reference for the withdrawal, forwarded to the authorisation service. It is the value reverseCashAdvance takes to undo this one.

cashAdvanceAmount
​number · double · optional

Required 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

isSuccess
​boolean · required

Whether 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.

feeAmount
​number · double · required

The fee charged on the transaction.

uTID
​string · optional

The unique transaction identifier the platform gives a transaction, and the handle every later operation on it takes. Returned by the transaction listings.

authCode
​string · optional

The authorisation code the issuer returned when the transaction was approved. Six characters, from the scheme.

responseCode
​string · optional

The 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.

responseReasonCode
​string · optional

Why the downstream system answered as it did, where it narrows the response code.

rrn
​string · optional

The retrieval reference number — the card scheme's handle for the transaction, and what a bank quotes when asking the scheme about it.

DoCashInstallmentEarlyReleasePaymentRequest

channel
​string · maxLength: 3 · required

Three-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.

amount
​number · double · required

Early-release settlement amount.

clientReferenceNumber
​integer · int64 · required

Caller business key for the payment.

shadowCardNumber
​string · maxLength: 19 · required

Card the early-release payment is posted against.

currencyCode
​string · maxLength: 3 · required

ISO currency of the payment.

cashInstallmentUtid
​string · required

UTID of the cash-installment plan being settled early.

The installment's own transaction identifier, carried through to the services that hold it.

accountNumber
​integer · int32 · optional

Accepted on the request; not mapped into the payment entity.

DoCashInstallmentEarlyReleasePaymentResponse

trnId
​integer · int64 · required

The platform's identifier for the transaction row.

utid
​string · optional

The unique transaction identifier the platform gives a transaction, and the handle every later operation on it takes. Returned by the transaction listings.

rrn
​string · optional

The retrieval reference number — the card scheme's handle for the transaction, and what a bank quotes when asking the scheme about it.

authorizationNumber
​string · optional

The authorisation code the issuer returned when the transaction was approved. Six characters, from the scheme.

DoCashInstallmentRequest

channelId
​string · maxLength: 3 · required

Three-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.

shadowCardNumber
​string · maxLength: 19 · required

The 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.

accountNumber
​string · optional

The 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.

referenceNumber
​string · maxLength: 50 · optional

The caller's own reference for the transaction, carried into the institution transaction record. It is truncated to 50 characters rather than refused.

transactionAmount
​number · double · optional

The amount of the transaction.

installmentCount
​integer · int32 · optional

How many instalments to split the amount across. The available counts for a card and amount come from the simulation operations.

DoCashInstallmentResponse

isSuccess
​boolean · required

Whether 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.

feeAmount
​number · double · required

The fee charged on the transaction.

uTID
​string · optional

The unique transaction identifier the platform gives a transaction, and the handle every later operation on it takes. Returned by the transaction listings.

authCode
​string · optional

The authorisation code the issuer returned when the transaction was approved. Six characters, from the scheme.

responseCode
​string · optional

The 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.

responseReasonCode
​string · optional

Why the downstream system answered as it did, where it narrows the response code.

reasonDescription
​string · optional

The downstream system's own wording for the refusal, passed through.

rrn
​string · optional

The retrieval reference number — the card scheme's handle for the transaction, and what a bank quotes when asking the scheme about it.

DoCreditCardDebtPaymentRequest

channel
​string · maxLength: 3 · required

Three-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.

amount
​number · double · required

Debt payment amount posted to the card.

clientReferenceNumber
​integer · int64 · required

Optional — The caller's own reference for the payment, forwarded to transaction management.

shadowCardNumber
​string · maxLength: 19 · required

One-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.

currencyCode
​string · maxLength: 3 · required

ISO currency of the payment amount.

accountNumber
​integer · int32 · optional

Accepted on the request but not forwarded into the payment entity.

clearCardNumber
​string · optional

One-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.

description
​string · maxLength: 100 · optional

Free-text description on the payment.

resourceCode
​string · maxLength: 20 · optional

Which 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.

earlyReleaseLogFlag
​boolean · optional

Forwarded to transaction management, which decides what it means. Nothing in this API reads it.

DoCreditCardDebtPaymentResponse

trnId
​integer · int64 · required

The platform's identifier for the transaction row.

utid
​string · optional

The unique transaction identifier the platform gives a transaction, and the handle every later operation on it takes. Returned by the transaction listings.

rrn
​string · optional

The retrieval reference number — the card scheme's handle for the transaction, and what a bank quotes when asking the scheme about it.

authorizationNumber
​string · optional

The authorisation code the issuer returned when the transaction was approved. Six characters, from the scheme.

DoEarlyCloseRequest

shadowCardNumber
​string · maxLength: 19 · optional

The 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.

utid
​string · maxLength: 50 · optional

The unique transaction identifier the platform gives a transaction, and the handle every later operation on it takes. Returned by the transaction listings.

feeAmount
​number · double · optional

The fee charged on the transaction.

earlyReleaseType
​integer · int32 · optional

Which kind of early settlement is being asked for.

DoEarlyCloseResponse

erLogRecordId
​integer · int64 · required
shadowCardNumber
​string · optional

The 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

transactionSource
​string · maxLength: 5 · required

Channel of the would-be payment; see the Channels page.

transactionType
​string · maxLength: 4 · required

Same transaction type codes as doPaymentTransaction.

amount
​number · double · required

Principal amount the fee is calculated against.

tranDate
​string · required

Business 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.

Example: 2026-10-16T14:30:00Z
shadowCardNumber
​string · maxLength: 19 · required

The card the fee is calculated for.

institutionCode
​string · maxLength: 7 · required

Institution / biller code.

referenceNumber
​string · maxLength: 50 · required

Caller reference for the inquiry.

description
​string · maxLength: 100 · optional

Optional description passed through to online.

DoPaymentFeeInquiryResponse

feeAmount
​number · double · required

The fee charged on the transaction.

bsmvAmount
​number · double · required

The BSMV levy on the transaction.

totalCommissionAmount
​number · double · required
uTID
​string · optional

The unique transaction identifier the platform gives a transaction, and the handle every later operation on it takes. Returned by the transaction listings.

authCode
​string · optional

The authorisation code the issuer returned when the transaction was approved. Six characters, from the scheme.

rrn
​string · optional

The retrieval reference number — the card scheme's handle for the transaction, and what a bank quotes when asking the scheme about it.

responseCode
​string · optional

The 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.

responseReasonCode
​string · optional

Why the downstream system answered as it did, where it narrows the response code.

responseCodeDescription
​string · optional

The description of responseCode, carried alongside it for display. It is not a key: match on the code.

DoPaymentTransactionRequest

transactionSource
​string · maxLength: 5 · required

Channel the payment comes from, forwarded as ChannelID to online. Prefer the three-digit channel code; see the Channels page.

transactionType
​string · maxLength: 4 · required

Payment kind online expects — INV, HGS, REL, SGK, TAX (and related institution types such as RINV).

amount
​number · double · required

Payment amount. Must be greater than zero.

tranDate
​string · required

Business 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.

Example: 2026-10-16T14:30:00Z
shadowCardNumber
​string · maxLength: 19 · required

The platform's card reference the payment is posted against.

institutionCode
​string · maxLength: 7 · required

Institution / biller code the payment is for.

referenceNumber
​string · maxLength: 50 · required

Caller reference for the payment; used for reconciliation and reverse.

feeAmount
​number · double · optional

Fee when calculated by the caller (IsFeeCalculatedExternally).

bsmvAmount
​number · double · optional

BSMV portion of the fee when calculated by the caller.

description
​string · maxLength: 100 · optional

Free-text description stored with the online payment.

DoPaymentTransactionResponse

isSuccess
​boolean · required

Whether 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.

uTID
​string · optional

The unique transaction identifier the platform gives a transaction, and the handle every later operation on it takes. Returned by the transaction listings.

authCode
​string · optional

The authorisation code the issuer returned when the transaction was approved. Six characters, from the scheme.

rrn
​string · optional

The retrieval reference number — the card scheme's handle for the transaction, and what a bank quotes when asking the scheme about it.

responseCode
​string · optional

The 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.

responseReasonCode
​string · optional

Why the downstream system answered as it did, where it narrows the response code.

responseCodeDescription
​string · optional

The description of responseCode, carried alongside it for display. It is not a key: match on the code.

EarlyCloseCandidateRow

customerNumber
​integer · int64 · required

The 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.

trnDate
​string · required

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.

Example: 2026-10-16T14:30:00Z
totalInstallmentAmount
​number · double · required

What the instalments come to together.

totalCapitalAmount
​number · double · required
totalInstallmentProfitAmount
​number · double · required
totalTaxAmount
​number · double · required
installmentCount
​integer · int32 · required

How many instalments to split the amount across. The available counts for a card and amount come from the simulation operations.

deferringMonthCount
​integer · int32 · required

How many months the purchase is deferred by.

remainingInstallmentAmount
​number · double · required
remainingCapitalAmount
​number · double · required
remainingInstallmentProfitAmount
​number · double · required
remainingTaxAmount
​number · double · required
remainingInstallmentCount
​integer · int32 · required

How many instalments are still to run.

shadowCardNumber
​string · optional

The 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.

authorizationNumber
​string · optional

The authorisation code the issuer returned when the transaction was approved. Six characters, from the scheme.

utid
​string · optional

The unique transaction identifier the platform gives a transaction, and the handle every later operation on it takes. Returned by the transaction listings.

Error

transactionId
​string · optional

The platform's identifier for this call, for tracing it in the logs.

errorCode
​string · optional

The platform's own code for the error, and what to match on.

description
​string · optional

The error in words. errorCode is the part to match on; this is for a log or a screen.

message
​string · optional

The error in words. errorCode is the part to match on.

messageFormat
​string · optional

The message before its arguments were substituted in, which is what groups two errors that differ only by their values.

arguments
​array · optional

The values substituted into messageFormat.

propertyName
​string · optional

Which field of the request the error is about.

detail
​string · optional

More about the error than message carries, where there is more.

​array · optional

The individual problems, where one error stands for several.

isTechnicalError
​boolean · optional

Whether the failure is the platform's rather than the request's. A technical error is worth retrying; a business one is not.

exceptionType
​string · optional

The platform's internal exception class. Useful in a support conversation and not something to match on.

GenerateCardVVRequest

channel
​string · maxLength: 3 · required

Three-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.

shadowCardNumber
​string · maxLength: 19 · required

The card to generate a verification value for.

keyDerivationIndex
​integer · int32 · optional

Which key the card's encrypted values were produced under. Returned with the card; a caller does not choose it.

bin
​string · maxLength: 8 · optional

The bank identification number — the leading digits of the card number that name the issuer and the product range.

expiryDateStr
​string · maxLength: 4 · optional

The card's expiry as MMYY.

clearPan
​string · optional

A card number is not stored by these services; the platform keeps a shadow card number instead.

GenerateCardVVResponse

hasError
​boolean · required

True 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.

errorText
​string · optional

The error in words, for a log or a screen rather than for matching.

verificationValue
​string · optional

The card verification value. Computed and compared rather than stored, and returned only where the operation is entitled to it.

GetAllWaitingInstallmentsRequest

shadowCardNumber
​string · maxLength: 19 · optional

Required 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.

GetAllWaitingInstallmentsResponse

​array · optional

The outcome, as the downstream system words it.

GetApplicableProductsByCustomerNumberRequest

channel
​string · maxLength: 3 · required

Three-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.

customerNumber
​integer · int64 · min: 1 · required

Customer whose applicable products are read. Three separate refusals: absent, zero, and negative each raise their own code.

mainCustomerNumber
​integer · int64 · min: 1 · optional

Main customer to read against. Not required, but when supplied it may be neither zero nor negative.

shadowCardNumber
​string · maxLength: 19 · optional

The 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.

​object · optional

Which rows to return. Left out, the operation returns them all.

GetApplicableProductsByCustomerNumberResponse

​array · optional

The products the search matched.

​array · optional

GetApplicableProductsByMainCustomerRequest

channel
​string · maxLength: 3 · required

Three-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.

mainCustomerNumber
​integer · int64 · min: 1 · required

The 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.

​object · required

Mandatory here, unlike on getApplicableProductsByCustomerNumber where the same filter may be left out: the service refuses a request whose filter.productGroupCode is absent.

GetApplicableProductsByMainCustomerResponse

isSuccess
​boolean · required

Whether 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

digitalAbility
​boolean · required

Whether the product can be issued as a digital card.

supplementaryCard
​boolean · required

Whether this is a supplementary card rather than a main one.

productNumber
​string · optional

The card product the card is issued on. Defined in the parameter tables; getCardProductList returns the ones a tenant may use.

productName
​string · optional

The card product's full name.

productShortName
​string · optional

The card product's short name, for a list or a statement line.

brand
​string · optional

Which scheme the card is issued on.

tenantId
​string · optional

Which tenant's records to read. Omitting it reads the rows that belong to no tenant rather than all of them.

​object · optional
cardAnnualFeeAmount
​number · double · optional

The annual fee the product carries.

GetAvailableCardStatusListRequest

channel
​string · maxLength: 3 · required

Three-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.

shadowCardNumber
​string · maxLength: 19 · required

The 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.

GetAvailableCardStatusListResponse

​array · optional

GetAvailableCardStatusListResponseItem

statusCode
​string · optional

Values:

  • A — valid
  • B — pending
  • C — stolen
  • D — cancelled by the bank
  • F — fraud
  • G — temporarily blocked
  • I — cancelled
  • L — lost
  • M — cancelled by the customer
  • T — corporate dummy
statusDescription
​string · optional

The description of statusCode, carried alongside it for display. It is not a key: match on the code.

reasonCode
​string · optional
reasonDescription
​string · optional

The description of reasonCode, carried alongside it for display. It is not a key: match on the code.

GetCalculatedStatementPeriodRequest

newStatementCode
​string · maxLength: 6 · required

The statement period to move the card to.

shadowCardNumber
​string · maxLength: 19 · optional

The 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

firstStatementDate
​string · optional

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.

Example: 2026-10-16T14:30:00Z
nextStatementDate
​string · optional

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.

Example: 2026-10-16T14:30:00Z

GetCancelableCashAdvanceListRequest

shadowCardNumber
​string · maxLength: 19 · required

The 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.

GetCancelableCashAdvanceListResponse

​array · optional

GetCancelableCashAdvanceModel

customerNumber
​integer · int64 · required

The 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.

mainCustomerNumber
​integer · int64 · required

The main customer of a corporate relationship, as a number. The employees and supplementary holders under it carry their own customerNumber.

trnAmount
​number · double · required

The amount of the transaction, in its own currency.

trnDate
​string · required

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.

Example: 2026-10-16T14:30:00Z
cardRefNumber
​string · optional

The card reference, which identifies one issued card including its renewals. Returned by the create and listing operations alongside the shadow number.

mainCardRefNumber
​string · optional

The 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.

shadowCardNumber
​string · optional

The 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.

trnDescription
​string · optional

The transaction in words, as it reached the platform.

utid
​string · optional

The unique transaction identifier the platform gives a transaction, and the handle every later operation on it takes. Returned by the transaction listings.

GetCancelableCashInstallmentListRequest

shadowCardNumber
​string · maxLength: 19 · required

The 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.

GetCancelableCashInstallmentListResponse

​array · optional

GetCancelableCashInstallmentModel

customerNumber
​integer · int64 · required

The 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.

mainCustomerNumber
​integer · int64 · required

The main customer of a corporate relationship, as a number. The employees and supplementary holders under it carry their own customerNumber.

trnAmount
​number · double · required

The amount of the transaction, in its own currency.

trnDate
​string · required

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.

Example: 2026-10-16T14:30:00Z
cardRefNumber
​string · optional

The card reference, which identifies one issued card including its renewals. Returned by the create and listing operations alongside the shadow number.

mainCardRefNumber
​string · optional

The 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.

shadowCardNumber
​string · optional

The 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.

trnDescription
​string · optional

The transaction in words, as it reached the platform.

utid
​string · optional

The unique transaction identifier the platform gives a transaction, and the handle every later operation on it takes. Returned by the transaction listings.

GetCancelableCreditCardDebtPaymentListRequest

shadowCardNumber
​string · maxLength: 19 · required

Card whose cancelable debt payments are listed. Empty throws 60002.

GetCancelableCreditCardDebtPaymentListResponse

​array · optional

GetCancelablePaymentModel

customerNumber
​integer · int64 · required

The 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.

mainCustomerNumber
​integer · int64 · required

The main customer of a corporate relationship, as a number. The employees and supplementary holders under it carry their own customerNumber.

trnAmount
​number · double · required

The amount of the transaction, in its own currency.

trnId
​integer · int64 · required

The platform's identifier for the transaction row.

trnDate
​string · required

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.

Example: 2026-10-16T14:30:00Z
cardRefNumber
​string · optional

The card reference, which identifies one issued card including its renewals. Returned by the create and listing operations alongside the shadow number.

mainCardRefNumber
​string · optional

The 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.

shadowCardNumber
​string · optional

The 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.

trnCurrencyCode
​string · optional

The currency the transaction was made in.

trnDescription
​string · optional

The description of trnId, carried alongside it for display. It is not a key: match on the code.

utid
​string · optional

The unique transaction identifier the platform gives a transaction, and the handle every later operation on it takes. Returned by the transaction listings.

GetCardAvailableLimitRequest

channel
​string · maxLength: 3 · required

Three-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.

cardRefNumber
​string · maxLength: 19 · optional

The card reference, which identifies one issued card including its renewals. Returned by the create and listing operations alongside the shadow number.

GetCardAvailableLimitResponse

availableLimit
​number · double · required

How much of the limit is left.

customerAvailableLimit
​number · double · required

How much of the customer's limit is left.

availableCashLimit
​number · double · required
customerAvailableCashLimit
​number · double · required
limit
​number · double · required

The limit to set.

customerLimit
​number · double · required

The limit of the customer behind the card.

cashLimit
​number · double · required
customerCashLimit
​number · double · required
limitUsed
​number · double · required

How much of the limit has been used.

customerLimitUsed
​number · double · required
cashLimitUsed
​number · double · required
customerCashLimitUsed
​number · double · required
supplementaryCard
​boolean · required

Whether this is a supplementary card rather than a main one.

mainCardAvailableLimit
​number · double · optional
mainCardAvailableCashLimit
​number · double · optional
mainCardLimit
​number · double · optional
mainCardCashLimit
​number · double · optional
mainLimitUsed
​number · double · optional
mainCashLimitUsed
​number · double · optional

GetCardDelinquencyInfoByCustomerNumberRequest

mainCustomerNumber
​integer · int64 · optional

The main customer of a corporate relationship, as a number. The employees and supplementary holders under it carry their own customerNumber.

GetCardDelinquencyInfoByCustomerNumberResponse

digitalCardLimit
​number · double · required
customerLimit
​number · double · required

The limit of the customer behind the card.

delinquencyDayCount
​integer · int32 · required
statementRemainAmount
​number · double · required

What is left of the statement.

delinquencyPeriod
​integer · int32 · required

How many periods the account has been in arrears.

newDeficientPaymentCounter
​integer · int32 · required
dayCoutAfterLimitIncrease
​integer · int32 · required
dayCoutAfterLimitDecrease
​integer · int32 · required
delinquencyStatus
​string · optional

Values:

  • N — normal
  • D — delinquent for the period
  • G — delinquent

GetCardFinancialInfoByCardRefNumberRequest

cardRefNumber
​string · maxLength: 19 · optional

The card reference, which identifies one issued card including its renewals. Returned by the create and listing operations alongside the shadow number.

customerNumber
​integer · int64 · optional

The 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.

shadowCardNumber
​string · maxLength: 19 · optional

The 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.

GetCardFinancialInfoByCardRefNumberResponse

​array · optional
​array · optional

GetCardIntermTransactionInfoRequest

channel
​string · maxLength: 3 · required

Three-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.

shadowCardNumber
​string · maxLength: 19 · optional

The 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.

addWaitingInstallments
​boolean · optional

Whether instalments not yet billed are included.

pageNumber
​integer · int32 · optional

Which page of results to return, counting from 1.

rowCount
​integer · int32 · optional

How many rows a page holds.

GetCardLimitationParametersRequest

shadowCardNumber
​string · maxLength: 19 · optional

The 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.

GetCardLimitationParametersResponse

​array · optional

GetCardListNewRequest

channelCode
​string · maxLength: 3 · required

Three-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.

customerNumber
​integer · int64 · optional

The 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.

mainCustomerNumber
​integer · int64 · optional

The main customer of a corporate relationship, as a number. The employees and supplementary holders under it carry their own customerNumber.

shadowCardNumber
​string · maxLength: 19 · optional

The 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.

barcode
​string · maxLength: 13 · optional

The delivery barcode the consignment is tracked by.

accountNumber
​integer · int64 · optional

The 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.

cardNumber
​string · minLength: 12 · maxLength: 19 · optional
purpose
​string · maxLength: 1 · optional
cardStatusCode
​string · maxLength: 2 · optional

Values:

  • A — valid
  • B — pending
  • C — stolen
  • D — cancelled by the bank
  • F — fraud
  • G — temporarily blocked
  • I — cancelled
  • L — lost
  • M — cancelled by the customer
  • T — corporate dummy
cardStatusReasonCode
​string · maxLength: 2 · optional

Why the status is being set. The valid reasons depend on the status: getAvailableCardStatusList returns the pairs a card may move to.

isCorporateAllCardList
​boolean · optional

Whether to return every card of the corporate relationship rather than the customer's own.

tenantId
​string · maxLength: 30 · optional

Which tenant's records to read. Omitting it reads the rows that belong to no tenant rather than all of them.

GetCardListRequest

channelCode
​string · maxLength: 3 · required

Three-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.

customerNumber
​integer · int64 · optional

The 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.

mainCustomerNumber
​integer · int64 · optional

The main customer of a corporate relationship, as a number. The employees and supplementary holders under it carry their own customerNumber.

shadowCardNumber
​string · maxLength: 19 · optional

The 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.

barcode
​string · maxLength: 13 · optional

The delivery barcode the consignment is tracked by.

accountNumber
​integer · int64 · optional

The 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.

cardNumber
​string · minLength: 12 · maxLength: 19 · optional

The 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.

purpose
​string · maxLength: 1 · optional

Narrows 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 status
  • C — open cards, status A
  • D — usable cards, and cards in status G
  • E — closed cards other than G
  • F — cards that may be reissued
cardStatusCode
​string · maxLength: 2 · optional

Values:

  • A — valid
  • B — pending
  • C — stolen
  • D — cancelled by the bank
  • F — fraud
  • G — temporarily blocked
  • I — cancelled
  • L — lost
  • M — cancelled by the customer
  • T — corporate dummy
cardStatusReasonCode
​string · maxLength: 2 · optional

Why the status is being set. The valid reasons depend on the status: getAvailableCardStatusList returns the pairs a card may move to.

branchCode
​integer · int32 · optional

The branch the card is opened at, as a number. Held as a number rather than text throughout.

customerNameSurname
​string · maxLength: 150 · optional

Matches 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.

identificationNumber
​string · maxLength: 11 · optional

Matches 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.

courierStatus
​string · maxLength: 3 · optional

Narrows the list to cards whose consignment is at this courier status, matched against the delivery integration record.

corpCardFlag
​boolean · optional

Whether to return corporate cards.

onlyLastCardFlag
​boolean · optional

Whether only the most recent card is included.

virtualCardFlag
​boolean · optional

Whether the card is a virtual one.

GetCardListResponse

​array · optional

The cards the search matched.

GetCardMemo

cardRefNumber
​string · optional

The card reference, which identifies one issued card including its renewals. Returned by the create and listing operations alongside the shadow number.

shadowCardNumber
​string · optional

The 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.

maskedCardNumber
​string · optional

The 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.

customerNumber
​integer · int64 · optional

The 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.

logCode
​string · optional

What kind of log entry this is.

logCodeDescription
​string · optional

The description of logCode, carried alongside it for display. It is not a key: match on the code.

oldValue
​string · optional

The value before the change, as the log recorded it.

newValue
​string · optional

The value after the change, as the log recorded it.

cardLogDetail
​string · optional
insertChannelId
​string · optional

Which channel created the row.

insertChannelDescription
​string · optional

The description of insertChannelId, carried alongside it for display. It is not a key: match on the code.

insertUserId
​string · optional

An 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.

insertDate
​string · optional

When 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.

Example: 2026-10-16T14:30:00Z

GetCardMemoRequest

startDate
​string · required

CanNotBeNullOrLessThanSqlMinValue — 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.

Example: 2026-10-16T14:30:00Z
endDate
​string · required

CanNotBeNullOrLessThanSqlMinValue — 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.

Example: 2026-10-16T14:30:00Z
shadowCardNumber
​string · maxLength: 19 · optional

One-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.

customerNumber
​integer · int64 · min: 1 · optional

One-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.

logCode
​string · maxLength: 10 · optional

What kind of log entry this is.

GetCardMemoResponse

​array · optional

GetCardMiscOptionRequest

channel
​string · maxLength: 3 · required

Three-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.

optionType
​string · enum · maxLength: 20 · optional

Values:

  • DS — digital slip — whether the cardholder's slip is printed
  • DC — dynamic CVV — whether the card's CVV is generated per period
customerNumber
​integer · int64 · optional

The 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.

mainCardRefNumber
​string · maxLength: 19 · optional

The 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.

cardRefNumber
​string · maxLength: 19 · optional

The card reference, which identifies one issued card including its renewals. Returned by the create and listing operations alongside the shadow number.

onlyMainCardFlag
​boolean · optional

Whether only main cards are included.

GetCardMiscOptionResponse

​array · optional

GetCardOperationLimitRequest

channel
​string · maxLength: 3 · required

Three-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.

cardRefNumber
​string · maxLength: 19 · required

The card whose limits are read.

GetCardOperationLimitResponse

​array · optional

The limit rows the search matched.

GetCardOperationLimitResponseItem

​object · optional

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.

perTrnAmount
​number · double · optional

The most the card may spend in one transaction.

perTrnAmountLimitRatio
​number · double · optional

The same cap as a share of the card's limit rather than an amount.

dailyTrnCount
​integer · int32 · optional

The most transactions the card may make in a day.

dailyTrnAmount
​number · double · optional

The most the card may spend in a day.

weeklyTrnCount
​integer · int32 · optional

The most transactions the card may make in a week.

weeklyTrnAmount
​number · double · optional

The most the card may spend in a week.

monthlyTrnCount
​integer · int32 · optional

The most transactions the card may make in a month.

monthlyTrnAmount
​number · double · optional

The most the card may spend in a month.

yearlyTrnCount
​integer · int32 · optional

The most transactions the card may make in a year.

yearlyTrnAmount
​number · double · optional

The most the card may spend in a year.

GetCardPermissionsRequest

shadowCardNumber
​string · maxLength: 19 · required

The card whose permissions are read.

GetCardPermissionsResponse

​array · optional

GetCardStatementAddressInformationRequest

mainCardRefNumber
​string · maxLength: 19 · optional

The 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

statementPostingFlag
​boolean · required

Whether the statement is posted on paper.

statementSmsSendFlag
​boolean · required

Whether the statement is announced by SMS.

statementEMailSendFlag
​boolean · required
addressId
​integer · int64 · required
addressType
​string · enum · optional

Values:

  • RA — home
  • AL — business
  • EA — employer
  • OO — alternative
  • WA — previous
  • SW — SWIFT
  • SS — SWIFT name and address
  • MR — Mernis, registered
  • MS — Mernis, stated

Not set is --.

statementSendAddressType
​string · optional
email
​string · optional

GetCardStatementDetailRequest

channel
​string · maxLength: 3 · required

Three-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.

mainCardRefNumber
​string · maxLength: 19 · required

The 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.

statementDate
​string · optional

Required 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.

Example: 2026-10-16T14:30:00Z
minStatementDate
​string · optional

How 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.

Example: 2026-10-16T14:30:00Z

GetCardStatementDetailResponse

​array · optional
prevTotalAmount
​number · double · optional

What the total came to before this change.

totalAmount
​number · double · optional

The amount of every entry in the list added together.

totalDebit
​number · double · optional
totalCredit
​number · double · optional
totalCash
​number · double · optional
totalProfitFeeTax
​number · double · optional
totalProfit
​number · double · optional
totalFee
​number · double · optional
totalTax1
​number · double · optional
totalTax2
​number · double · optional
​array · optional

GetCardStatementDetailSummaryRequest

mainCardRefNumber
​string · maxLength: 19 · optional

The 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.

statementDate
​string · optional

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.

Example: 2026-10-16T14:30:00Z

GetCardStatementDetailSummaryResponse

minimumPaymentAmount
​number · double · required

The least that may be paid this period.

prevTotalAmount
​number · double · required

What the total came to before this change.

remainingDebt
​number · double · required

What is still owed.

statementDate
​string · required

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.

Example: 2026-10-16T14:30:00Z
earnedPointAmount
​number · double · required
dueDate
​string · required

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.

Example: 2026-10-16T14:30:00Z
nextStatementDate
​string · required

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.

Example: 2026-10-16T14:30:00Z
nextDueDate
​string · required

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.

Example: 2026-10-16T14:30:00Z
statementDebt
​number · double · required

What the statement says is owed.

totalEarnedPointAmount
​number · double · required
remainingMinimumPaymentDebt
​number · double · required

What is left of the minimum payment.

​array · optional
currencyCode
​string · optional

The currency of the amount, as its three-letter code.

GetCardStatementListRequest

shadowCardNumber
​string · maxLength: 19 · optional

One-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.

mainCardRefNumber
​string · maxLength: 19 · optional

One-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

mainCardRefNumber
​string · maxLength: 19 · optional

The 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.

statementDate
​string · optional

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.

Example: 2026-10-16T14:30:00Z

GetCardStatementSummaryResponse

minimumPaymentAmount
​number · double · required

The least that may be paid this period.

prevTotalAmount
​number · double · required

What the total came to before this change.

remainingDebt
​number · double · required

What is still owed.

statementDate
​string · required

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.

Example: 2026-10-16T14:30:00Z
earnedPointAmount
​number · double · required
dueDate
​string · required

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.

Example: 2026-10-16T14:30:00Z
nextStatementDate
​string · required

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.

Example: 2026-10-16T14:30:00Z
nextDueDate
​string · required

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.

Example: 2026-10-16T14:30:00Z
statementDebt
​number · double · required

What the statement says is owed.

totalEarnedPointAmount
​number · double · required
remainingMinimumPaymentDebt
​number · double · required

What is left of the minimum payment.

currencyCode
​string · optional

The currency of the amount, as its three-letter code.

GetCashAdvanceInfoRequest

channelId
​string · maxLength: 3 · required

Three-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.

shadowCardNumber
​string · maxLength: 19 · optional

Required 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.

accountNumber
​string · optional

The 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.

cashAdvanceAmount
​number · double · optional

Required 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

isSuccess
​boolean · required

Whether 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.

cashAdvanceFeeAmount
​number · double · required
cashAdvanceInterestRate
​number · double · required
cashAdvanceAmount
​number · double · required

The amount to draw as cash.

totalAmount
​number · double · required

The amount of every entry in the list added together.

calculateCashProfit
​number · double · required
calculatedTotalAmount
​number · double · required
authCode
​string · optional

The authorisation code the issuer returned when the transaction was approved. Six characters, from the scheme.

responseCode
​string · optional

The 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.

responseReasonCode
​string · optional

Why the downstream system answered as it did, where it narrows the response code.

GetCashInstallmentParameterItem

minInstallmentCount
​integer · int32 · required
maxInstallmentCount
​integer · int32 · required
minTrnAmount
​number · double · required
maxTrnAmount
​number · double · required
profitRate
​number · double · required
feeAmount
​number · double · required

The fee charged on the transaction.

GetCashInstallmentParameterRequest

channelId
​string · maxLength: 3 · required

Three-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.

shadowCardNumber
​string · maxLength: 19 · required

The 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.

accountNumber
​string · optional

The 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.

transactionAmount
​number · double · optional

The amount of the transaction.

GetCashInstallmentParameterResponse

​array · optional

GetCorporateCustomerInfoByIndividualCustomerRequest

channel
​string · maxLength: 3 · required

Three-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.

customerNumber
​integer · int64 · required

The individual customer whose corporate relationships are read.

GetCorporateCustomerInfoByIndividualCustomerResponse

​array · optional

GetCreditApplicationIdByFromShadowCardNumberRequest

channel
​string · maxLength: 3 · required

Three-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.

shadowCardNumber
​string · maxLength: 19 · required

The 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

applicationId
​string · optional

The card application this request belongs to. Returned when an application is created, and carried through the card that comes out of it.

applicationDate
​string · optional

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.

Example: 2026-10-16T14:30:00Z

GetCreditCardAutoPaymentOrderRequest

At least one of mainCustomerNumber, mainCardRefNumber or shadowCardNumber is required. Sending all three empty returns 60002.
mainCustomerNumber
​integer · int64 · optional

Lists auto-payment orders for every card under the customer.

mainCardRefNumber
​string · maxLength: 19 · optional

Alternative card key when the shadow number is not held.

shadowCardNumber
​string · maxLength: 19 · optional

One of shadowCardNumber, mainCardRefNumber or mainCustomerNumber is required. All three empty throws 60002.

GetCreditCardAutoPaymentOrderResponse

​array · optional

GetCreditCardCollectionInfoByCardRefNumberRequest

channel
​string · maxLength: 3 · required

Three-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.

mainCardRefNumber
​string · maxLength: 19 · optional

The 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.

GetCreditCardCollectionInfoByCardRefNumberResponse

​array · optional

GetCreditCardCollectionInfoByMainCustomerNumberRequest

channel
​string · maxLength: 3 · required

Three-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.

mainCustomerNumber
​integer · int64 · optional

The main customer of a corporate relationship, as a number. The employees and supplementary holders under it carry their own customerNumber.

branchCode
​string · optional

The 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.

GetCreditCardCollectionInfoByMainCustomerNumberResponse

​array · optional

GetCreditCardCollectionTransactionListByDateRequest

date
​string · optional

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.

Example: 2026-10-16T14:30:00Z

GetCreditCardCollectionTransactionListByDateResponse

​array · optional

GetCreditCardCurrentTransactionListRequest

shadowCardNumber
​string · maxLength: 19 · optional

The 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.

mainCardRefNumber
​string · maxLength: 19 · optional

The 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.

GetCreditCardCurrentTransactionListResponse

​object · optional

GetCreditCardDateRangeForRewardByCustomerNumberReqSourceRequest

CustomerNumber
​integer · int64 · optional

The 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.

StatementDate
​string · optional

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.

Example: 2026-10-16T14:30:00Z
RequestSource
​string · optional

Read 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

BeginDate
​string · optional

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.

Example: 2026-10-16T14:30:00Z
EndDate
​string · optional

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.

Example: 2026-10-16T14:30:00Z

GetCreditCardInfoRequest

channel
​string · maxLength: 3 · required

Three-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.

shadowCardNumber
​string · maxLength: 19 · optional

One-of — The card to read. Send this or cardNumber; sending neither is refused.

cardNumber
​string · minLength: 12 · maxLength: 19 · optional

One-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

​object · optional

The card the operation is answering about.

​array · optional
​array · optional

GetCreditCardLastStatementRequest

channel
​string · maxLength: 3 · required

Three-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.

shadowCardNumber
​string · maxLength: 19 · optional

The 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

existingPoint
​number · double · required
​object · optional
​array · optional

GetCreditCardLimitRequest

channel
​string · maxLength: 3 · required

Three-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.

shadowCardNumber
​string · maxLength: 19 · required

The 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

availableCashAdvanceLimit
​number · double · required
totalLimit
​number · double · required

GetCreditCardPortfolioSummaryRequest

channelCode
​string · maxLength: 3 · required

Three-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.

mainCustomerNumber
​integer · int64 · optional

The main customer of a corporate relationship, as a number. The employees and supplementary holders under it carry their own customerNumber.

GetCreditCardPortfolioSummaryResponse

assets
​number · double · required
totalDebtAmount
​number · double · required
cardCount
​integer · int32 · required
totalDebtAmountUSD
​number · double · required
totalDebtAmountEUR
​number · double · required
productCode
​string · optional
productName
​string · optional

The card product's full name.

statementCurrency
​string · optional

The currency the statement is produced in.

GetCreditCardStatementSendPreferenceRequest

channel
​string · maxLength: 3 · required

Three-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.

customerNumber
​integer · int64 · optional

The 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.

GetCreditCardStatementSendPreferenceResponse

​array · optional

GetCreditCardTransactionAllRequest

channel
​string · maxLength: 3 · required

Three-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.

shadowCardNumber
​string · maxLength: 19 · optional

The 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.

mainCardRefNumber
​string · maxLength: 19 · optional

The 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.

beginDate
​string · optional

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.

Example: 2026-10-16T14:30:00Z
endDate
​string · optional

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.

Example: 2026-10-16T14:30:00Z
onlySuccessFlag
​boolean · optional

Whether to return only the transactions that succeeded.

GetCreditCardTransactionAllResponse

​object · optional
​object · optional

GetCreditCustomerLisfOfBranchRequest

channel
​string · maxLength: 3 · required

Three-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.

branchCode
​integer · int32 · optional

Required 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.

GetCreditCustomerListOfBranchResponse

customerOid
​array · optional

GetCustomerAssetsSummaryCreditCardModel

supplementaryCardFlag
​boolean · required

Whether this is a supplementary card rather than a main one.

cardLimit
​number · double · required

The card's own spending limit.

cardAvailableLimit
​number · double · required

How much of the card's limit is left.

currentDebt
​number · double · required

What is owed as of now.

totalDebt
​number · double · required
autoLimitIncreaseFlag
​boolean · required

Whether the card takes part in automatic limit increases.

shadowCardNumber
​string · optional

The 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.

maskedCardNumber
​string · optional

The 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.

cardRefNumber
​string · optional

The card reference, which identifies one issued card including its renewals. Returned by the create and listing operations alongside the shadow number.

mainCardRefNumber
​string · optional

The 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.

customerNumber
​string · optional

The 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.

mainCustomerNumber
​string · optional

The main customer of a corporate relationship, as a number. The employees and supplementary holders under it carry their own customerNumber.

productNumber
​string · optional

The card product the card is issued on. Defined in the parameter tables; getCardProductList returns the ones a tenant may use.

statementDate
​string · optional

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.

Example: 2026-10-16T14:30:00Z
statementDueDate
​string · optional

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.

Example: 2026-10-16T14:30:00Z
statementPeriod
​string · optional

Which statement period the card is billed on. The periods a product allows come from the reference data.

productName
​string · optional

The card product's full name.

productShortName
​string · optional

The card product's short name, for a list or a statement line.

expiryDateStr
​string · optional

The card's expiry as MMYY.

cardFormType
​string · enum · optional

Values:

  • P — physical
  • D — digital
  • B — physical and digital — a product setting, resolved to P or D on issue
  • H — HCE
  • T — token
  • V — virtual
cardStatusCode
​string · optional

Values:

  • A — valid
  • B — pending
  • C — stolen
  • D — cancelled by the bank
  • F — fraud
  • G — temporarily blocked
  • I — cancelled
  • L — lost
  • M — cancelled by the customer
  • T — corporate dummy
cardStatusCodeDescription
​string · optional

The description of cardStatusCode, carried alongside it for display. It is not a key: match on the code.

cardStatusReasonCode
​string · optional

Why the status is being set. The valid reasons depend on the status: getAvailableCardStatusList returns the pairs a card may move to.

cardStatusReasonCodeDescription
​string · optional

The description of cardStatusReasonCode, carried alongside it for display. It is not a key: match on the code.

cardStatusChangeChannel
​string · optional

Which channel last changed the card's status.

securityFlag
​boolean · optional

Whether the card is under a security restriction.

​array · optional

The accounts the card draws on.

GetCustomerAssetsSummaryCreditRequest

channelCode
​string · maxLength: 3 · required

Three-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.

customerNumber
​integer · int64 · optional

The 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.

GetCustomerAssetsSummaryCreditResponse

​array · optional

The cards the search matched.

GetCustomerAvailableLimitRequest

channel
​string · maxLength: 3 · required

Three-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.

mainCustomerNumber
​integer · int64 · optional

The main customer of a corporate relationship, as a number. The employees and supplementary holders under it carry their own customerNumber.

GetCustomerAvailableLimitResponse

availableLimit
​number · double · required

How much of the limit is left.

availableCashLimit
​number · double · required
limit
​number · double · required

The limit to set.

cashLimitUsed
​number · double · required
limitUsed
​number · double · required

How much of the limit has been used.

GetCustomerCreditCardListByTenantIdProductNumberResponse

​array · optional

GetCustomerCreditCardListByTenantIdProductNumberResult

cardLimit
​number · double · required

The card's own spending limit.

customerLimit
​number · double · required

The limit of the customer behind the card.

customerAvailableLimit
​number · double · required

How much of the customer's limit is left.

cardAvailableLimit
​number · double · required

How much of the card's limit is left.

delinquencyPeriod
​integer · int32 · required

How many periods the account has been in arrears.

pendingReplaceApplicationExists
​boolean · required

Whether a replacement has been asked for and not yet produced.

cardStatusCode
​string · optional

Values:

  • A — valid
  • B — pending
  • C — stolen
  • D — cancelled by the bank
  • F — fraud
  • G — temporarily blocked
  • I — cancelled
  • L — lost
  • M — cancelled by the customer
  • T — corporate dummy
cardStatusCodeDesc
​string · optional

The description of cardStatusCode, carried alongside it for display. It is not a key: match on the code.

cardStatusReasonCode
​string · optional

Why the status is being set. The valid reasons depend on the status: getAvailableCardStatusList returns the pairs a card may move to.

cardStatusReasonCodeDesc
​string · optional

The description of cardStatusReasonCode, carried alongside it for display. It is not a key: match on the code.

customerNumber
​integer · int64 · optional

The 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.

cardFormType
​string · enum · optional

Values:

  • P — physical
  • D — digital
  • B — physical and digital — a product setting, resolved to P or D on issue
  • H — HCE
  • T — token
  • V — virtual
mainCardRefNumber
​string · optional

The 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.

maskedCardNumber
​string · optional

The 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.

productNumber
​string · optional

The card product the card is issued on. Defined in the parameter tables; getCardProductList returns the ones a tenant may use.

productShortName
​string · optional

The card product's short name, for a list or a statement line.

shadowCardNumber
​string · optional

The 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.

statementCurrency
​string · optional

The currency the statement is produced in.

statementDate
​string · optional

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.

Example: 2026-10-16T14:30:00Z
nextDueDate
​string · optional

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.

Example: 2026-10-16T14:30:00Z
nextStatementDate
​string · optional

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.

Example: 2026-10-16T14:30:00Z
dueDate
​string · optional

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.

Example: 2026-10-16T14:30:00Z
cardRefNumber
​string · optional

The card reference, which identifies one issued card including its renewals. Returned by the create and listing operations alongside the shadow number.

expiryDateStr
​string · optional

The card's expiry as MMYY.

firstPinSetDate
​string · optional

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.

Example: 2026-10-16T14:30:00Z
barcode
​string · optional

The delivery barcode the consignment is tracked by.

noNameFlag
​boolean · optional

Whether the card was produced without a name on it.

delinquencyStatus
​string · optional

Values:

  • N — normal
  • D — delinquent for the period
  • G — delinquent
​array · optional

GetCustomerCreditCardListByTenantIdRequest

customerNumber
​integer · int64 · required

Customer whose cards are listed. A real null check — the field is nullable, so absence is refused rather than read as zero.

channelCode
​string · maxLength: 3 · optional

Three-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.

tenantId
​string · maxLength: 30 · optional

Which 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.

productNumbers
​array · optional

Narrows 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.

GetCustomerCreditCardListByTenantIdResponse

​array · optional

GetCustomerCreditCardListByTenantIdResult

cardLimit
​number · double · required

The card's own spending limit.

cardAvailableLimit
​number · double · required

How much of the card's limit is left.

customerLimit
​number · double · required

The limit of the customer behind the card.

customerAvailableLimit
​number · double · required

How much of the customer's limit is left.

pendingReplaceApplicationExists
​boolean · required

Whether a replacement has been asked for and not yet produced.

delinquencyPeriod
​integer · int32 · required

How many periods the account has been in arrears.

cardStatusCode
​string · optional

Values:

  • A — valid
  • B — pending
  • C — stolen
  • D — cancelled by the bank
  • F — fraud
  • G — temporarily blocked
  • I — cancelled
  • L — lost
  • M — cancelled by the customer
  • T — corporate dummy
cardStatusCodeDesc
​string · optional

The description of cardStatusCode, carried alongside it for display. It is not a key: match on the code.

cardStatusReasonCode
​string · optional

Why the status is being set. The valid reasons depend on the status: getAvailableCardStatusList returns the pairs a card may move to.

cardStatusReasonCodeDesc
​string · optional

The description of cardStatusReasonCode, carried alongside it for display. It is not a key: match on the code.

customerNumber
​integer · int64 · optional

The 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.

cardFormType
​string · enum · optional

Values:

  • P — physical
  • D — digital
  • B — physical and digital — a product setting, resolved to P or D on issue
  • H — HCE
  • T — token
  • V — virtual
mainCardRefNumber
​string · optional

The 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.

maskedCardNumber
​string · optional

The 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.

productNumber
​string · optional

The card product the card is issued on. Defined in the parameter tables; getCardProductList returns the ones a tenant may use.

productShortName
​string · optional

The card product's short name, for a list or a statement line.

shadowCardNumber
​string · optional

The 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.

statementCurrency
​string · optional

The currency the statement is produced in.

statementDate
​string · optional

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.

Example: 2026-10-16T14:30:00Z
nextDueDate
​string · optional

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.

Example: 2026-10-16T14:30:00Z
nextStatementDate
​string · optional

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.

Example: 2026-10-16T14:30:00Z
dueDate
​string · optional

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.

Example: 2026-10-16T14:30:00Z
cardRefNumber
​string · optional

The card reference, which identifies one issued card including its renewals. Returned by the create and listing operations alongside the shadow number.

​array · optional
expiryDateStr
​string · optional

The card's expiry as MMYY.

firstPinSetDate
​string · optional

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.

Example: 2026-10-16T14:30:00Z
barcode
​string · optional

The delivery barcode the consignment is tracked by.

noNameFlag
​boolean · optional

Whether the card was produced without a name on it.

bin
​string · optional

The bank identification number — the leading digits of the card number that name the issuer and the product range.

encryptedCardNumber
​string · optional

The card number encrypted under the platform's key, which is how it travels between services.

keyDerivationIndex
​integer · int32 · optional

Which key the card's encrypted values were produced under. Returned with the card; a caller does not choose it.

delinquencyStatus
​string · optional

Values:

  • N — normal
  • D — delinquent for the period
  • G — delinquent

GetCustomerCreditShadowCardsByTenantIdRequest

channel
​string · maxLength: 3 · required

Three-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.

customerNumber
​integer · int64 · required

Customer whose shadow cards are listed. A real null check — the field is nullable, so absence is refused.

tenantId
​string · maxLength: 30 · required

Which 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.

GetCustomerCreditShadowCardsByTenantIdResponse

​array · optional

GetCustomerCreditShadowCardsByTenantIdResult

cardType
​string · optional

Which kind of card, as the one-letter code the account type carries: C credit, D debit, P prepaid.

customerNumber
​integer · int64 · optional

The 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.

maskedCardNumber
​string · optional

The 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.

shadowCardNumber
​string · optional

The 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.

productNumber
​string · optional

The card product the card is issued on. Defined in the parameter tables; getCardProductList returns the ones a tenant may use.

productShortName
​string · optional

The card product's short name, for a list or a statement line.

cardStatusCode
​string · optional

Values:

  • A — valid
  • B — pending
  • C — stolen
  • D — cancelled by the bank
  • F — fraud
  • G — temporarily blocked
  • I — cancelled
  • L — lost
  • M — cancelled by the customer
  • T — corporate dummy
cardStatusCodeDesc
​string · optional

The description of cardStatusCode, carried alongside it for display. It is not a key: match on the code.

cardStatusReasonCode
​string · optional

Why the status is being set. The valid reasons depend on the status: getAvailableCardStatusList returns the pairs a card may move to.

cardStatusReasonCodeDesc
​string · optional

The description of cardStatusReasonCode, carried alongside it for display. It is not a key: match on the code.

GetCustomerLimitationParametersRequest

customerNumber
​integer · int64 · optional

The 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.

GetCustomerLimitationParametersResponse

​array · optional

GetCustomerOperationLimitRequest

channel
​string · maxLength: 3 · required

Three-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.

customerNumber
​integer · int64 · optional

Required 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.

GetCustomerOperationLimitResponse

​array · optional

The limit rows the search matched.

GetCustomerTotalLimitInfoRequest

channel
​string · maxLength: 3 · required

Three-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.

customerNumber
​integer · int64 · min: 1 · required

Customer whose total limit is read. Three separate refusals — absent, zero and negative each raise their own code.

productNumber
​string · maxLength: 5 · optional

The card product the card is issued on. Defined in the parameter tables; getCardProductList returns the ones a tenant may use.

GetCustomerTotalLimitInfoResponse

customerLimit
​number · double · optional

The limit of the customer behind the card.

cardApplicationNumber
​string · optional

GetCustomerTransactionDetailRequest

utid
​string · maxLength: 50 · optional

The unique transaction identifier the platform gives a transaction, and the handle every later operation on it takes. Returned by the transaction listings.

GetCustomerTransactionDetailResponse

​array · optional

GetDigitalSlipReceiptRequest

channel
​string · maxLength: 3 · required

Three-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.

utid
​string · maxLength: 50 · optional

The unique transaction identifier the platform gives a transaction, and the handle every later operation on it takes. Returned by the transaction listings.

GetDigitalSlipReceiptResponse

utid
​string · optional

The unique transaction identifier the platform gives a transaction, and the handle every later operation on it takes. Returned by the transaction listings.

refUtid
​string · optional

The transaction this one refers to — the original, for a reversal or a correction.

trnCodeMatrixId
​string · optional

Which row of the transaction-code matrix this transaction was classified by.

shadowCardNumber
​string · optional

The 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.

cardRefNumber
​string · optional

The card reference, which identifies one issued card including its renewals. Returned by the create and listing operations alongside the shadow number.

maskedCardNumber
​string · optional

The 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.

trnAmount
​number · double · optional

The amount of the transaction, in its own currency.

trnCurrencyCode
​string · optional

The currency the transaction was made in.

responseCode
​string · optional

The 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.

trnDatetime
​string · optional

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.

Example: 2026-10-16T14:30:00Z
trnStatus
​string · optional

Where the transaction has got to.

stan
​integer · int32 · optional

The system trace audit number — the scheme's sequence number for the message, unique within a day and a terminal.

rrn
​string · optional

The retrieval reference number — the card scheme's handle for the transaction, and what a bank quotes when asking the scheme about it.

authorizationNumber
​string · optional

The authorisation code the issuer returned when the transaction was approved. Six characters, from the scheme.

terminalNumber
​string · optional

The terminal the transaction was made at.

merchantNumber
​string · optional

The merchant's number with the acquirer.

merchantName
​string · optional

The merchant's name as it reached the platform from the scheme.

panEntryMode
​string · optional

How the card was read at the terminal — chip, stripe, contactless, keyed, or stored on file. The scheme's own code.

iccData84
​string · optional
iccData9f26
​string · optional
cardSeqNumber
​string · optional

Which chip on the card was used, where a customer holds more than one card on the same number.

merchantAddress
​string · optional

The merchant's address as it reached the platform.

GetDisputeListRequest

CaseNumber
​integer · int32 · optional

Restrict the search to one case. The contract holds a non-nullable integer, so a search that does not use this criterion sends 0.

DisputeTransactionId
​integer · int64 · optional

Restrict the search to one dispute transaction. The contract holds a non-nullable integer, so a search that does not use this criterion sends 0.

UTID
​string · maxLength: 50 · optional

Restrict the search to one unique transaction identifier.

CustomerNumber
​integer · int64 · optional

Restrict the search to one customer. The contract holds a non-nullable integer, so a search that does not use this criterion sends 0.

ShadowCardNumber
​string · maxLength: 19 · optional

Restrict the search to one card, by shadow number.

CardRefNumber
​string · maxLength: 19 · optional

Restrict the search to one card, by card reference number.

EncryptedCardNumber
​string · optional

Restrict the search to one card, by encrypted card number. The facade does not decrypt it.

CardNumber
​string · optional

Restrict the search to one card, by plain card number.

ExternalCaseId
​string · optional

Restrict the search to one case in the external dispute system. Only the integration route reads it.

GetDisputeListResponse

​array · optional

The transactions the case covers.

GetDisputeReasonDefResponse

​array · optional

GetEarlyCloseCandidateListRequest

shadowCardNumber
​string · maxLength: 19 · optional

The 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.

customerNumber
​integer · int64 · optional

The 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.

GetEarlyCloseCandidateListResponse

​array · optional

GetEarlyReleaseAvailableInstallmentsByCriteriasRequest

cardRefNumber
​string · maxLength: 19 · optional

The card reference, which identifies one issued card including its renewals. Returned by the create and listing operations alongside the shadow number.

mainCardRefNumber
​string · maxLength: 19 · optional

The 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.

shadowCardNumber
​string · maxLength: 19 · optional

The 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.

GetEarlyReleaseAvailableInstallmentsByCriteriasResponse

​array · optional

GetEarlyReleaseCashInstallmentRequest

shadowCardNumber
​string · maxLength: 19 · required

The 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.

utid
​string · maxLength: 50 · required

The unique transaction identifier the platform gives a transaction, and the handle every later operation on it takes. Returned by the transaction listings.

GetEarlyReleaseCashInstallmentResponse

transactionDate
​string · required

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.

Example: 2026-10-16T14:30:00Z
transactionAmount
​number · double · required

The amount of the transaction.

installmentCount
​integer · int32 · required

How many instalments to split the amount across. The available counts for a card and amount come from the simulation operations.

totalFeeAmount
​number · double · required
installmentProfitRate
​number · double · required
totalInstallmentAmount
​number · double · required

What the instalments come to together.

remainingInstallmentCount
​integer · int32 · required

How many instalments are still to run.

remainingInstallmentCapitalAmount
​number · double · required
earlyReleaseTotalAmount
​number · double · required
earlyReleaseInterestAmount
​number · double · required
earlyReleaseTotalTaxAmount
​number · double · required
earlyReleaseBsmvAmount
​number · double · required
earlyReleaseKkdfAmount
​number · double · required
shadowCardNumber
​string · optional

The 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.

mainCardRefNumber
​string · optional

The 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.

utid
​string · optional

The unique transaction identifier the platform gives a transaction, and the handle every later operation on it takes. Returned by the transaction listings.

GetEarlyReleaseCashInstallmentsRequest

shadowCardNumber
​string · maxLength: 19 · required

The 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.

GetEarlyReleaseCashInstallmentsResponse

​array · optional

GetInstallmentCountsByUtidRequest

Utid
​string · maxLength: 50 · optional

The unique transaction identifier the platform gives a transaction, and the handle every later operation on it takes. Returned by the transaction listings.

GetInstallmentCountsByUtidResponse

Amount
​number · double · required

The amount.

Date
​string · required

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.

Example: 2026-10-16T14:30:00Z
MinInstallmentCount
​integer · int32 · optional
MaxInstallmentCount
​integer · int32 · optional
MinDeferringMonthCount
​integer · int32 · optional
MaxDeferringMonthCount
​integer · int32 · optional
InstallmentCountLimit
​integer · int32 · optional
InstallmentCountMccGroupLimit
​integer · int32 · optional
InstallmentCountMccLimit
​integer · int32 · optional
InstallmentProfileDeferringLimit
​integer · int32 · optional
InstallmentProfileInstallmentLimit
​integer · int32 · optional
MccDefinitionInstallmentLimit
​integer · int32 · optional
Description
​string · optional

GetManuelInstallmentCancelRecordsByCardRefNumberRequest

cardRefNumber
​string · maxLength: 19 · optional

The card reference, which identifies one issued card including its renewals. Returned by the create and listing operations alongside the shadow number.

shadowCardNumber
​string · maxLength: 19 · optional

The 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.

GetManuelInstallmentCancelRecordsByCardRefNumberResponse

​array · optional

GetPendingCardEmbossListRequest

shadowCardNumber
​string · maxLength: 19 · required

The card whose pending emboss records are listed. The only field the request carries, and the only thing checked.

GetPendingCardEmbossListResponse

cardSeqNumber
​integer · int32 · optional

Which chip on the card was used, where a customer holds more than one card on the same number.

embossDate
​string · optional

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.

Example: 2026-10-16T14:30:00Z
applicationDate
​string · optional

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.

Example: 2026-10-16T14:30:00Z
embossReasonCode
​string · optional

Values:

  • N — new card
  • Y — renewal
embossReasonDescription
​string · optional

The description of embossReasonCode, carried alongside it for display. It is not a key: match on the code.

embossReasonSubCode
​string · optional

Values:

  • BRK — broken card
  • CHF — damaged chip
  • EXP — renewal at maturity
  • FRD — fraud
  • MGF — magnetic stripe error
  • NSU — name update
  • OTH — other
  • EXO — bulk renewal at maturity
  • LST — lost card
  • STL — stolen card

Not set is ---.

embossReasonSubDesc
​string · optional

The description of embossReasonSubCode, carried alongside it for display. It is not a key: match on the code.

embossStatus
​string · enum · optional

Values:

  • W — waiting
  • P — processing
  • C — emboss file created
  • E — embossed
  • T — PIN printed
  • D — delivered
  • R — emboss file removed
  • F — emboss faulty
  • N — emboss not completed
  • X — error

Not set is "".

maskedCardNumber
​string · optional

The 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.

productTypeCode
​string · enum · optional

Values:

  • C — credit
  • D — debit
  • P — prepaid
productTypeDescription
​string · optional

The description of productTypeCode, carried alongside it for display. It is not a key: match on the code.

shadowCardNumber
​string · optional

The 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.

validFlag
​boolean · optional

Whether the row is live. The platform sets it; a value sent here is replaced.

GetPendingProvisionListRequest

channel
​string · maxLength: 3 · required

Three-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.

shadowCardNumber
​string · maxLength: 19 · optional

The 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.

GetPendingProvisionListResponse

​array · optional

GetRenewCountByShadowCardNumberRequest

channel
​string · maxLength: 3 · required

Three-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.

shadowCardNumber
​string · maxLength: 19 · optional

The 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.

embossReasonSubCode
​string · maxLength: 3 · optional

Values:

  • BRK — broken card
  • CHF — damaged chip
  • EXP — renewal at maturity
  • FRD — fraud
  • MGF — magnetic stripe error
  • NSU — name update
  • OTH — other
  • EXO — bulk renewal at maturity
  • LST — lost card
  • STL — stolen card

Not set is ---.

GetRenewCountByShadowCardNumberResponse

shadowCardNumber
​string · optional

The 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.

cardRefNumber
​string · optional

The card reference, which identifies one issued card including its renewals. Returned by the create and listing operations alongside the shadow number.

mainCardRefNumber
​string · optional

The 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.

isSupplementary
​boolean · optional
​array · optional

GetStatementPeriodByProductNumberRequest

productNumber
​string · maxLength: 5 · required

The card product the card is issued on. Defined in the parameter tables; getCardProductList returns the ones a tenant may use.

GetStatementPeriodByProductNumberResponse

​array · optional

GetStatementPeriodChangeCountRequest

cardRefNumber
​string · maxLength: 19 · optional

The card reference, which identifies one issued card including its renewals. Returned by the create and listing operations alongside the shadow number.

GetStatementPeriodChangeCountResponse

changeCountExceeded
​boolean · required
changeCount
​integer · int32 · required

GetStatementPeriodChangeInfoRequest

cardRefNumber
​string · maxLength: 19 · required

The card reference, which identifies one issued card including its renewals. Returned by the create and listing operations alongside the shadow number.

GetStatementPeriodChangeInfoResponse

yearlyRemainingStatementChangeCount
​integer · int32 · required
statementDate
​string · optional

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.

Example: 2026-10-16T14:30:00Z
next1StatementDate
​string · optional

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.

Example: 2026-10-16T14:30:00Z
next2StatementDate
​string · optional

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.

Example: 2026-10-16T14:30:00Z
lastChangeDate
​string · optional

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.

Example: 2026-10-16T14:30:00Z
isStatementPeriodChangeAvailable
​string · optional

GetWaitingInstallmentDetailRequest

shadowCardNumber
​string · maxLength: 19 · required

The 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

shadowCardNumber
​string · maxLength: 19 · optional

The 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.

GetWaitingInstallmentSummaryResponse

​array · optional

HealthCheckResponse

date
​string · required

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.

Example: 2026-10-16T14:30:00Z
result
​string · optional

The outcome, as the downstream system words it.

IncreasePinTryCountRequest

channel
​string · maxLength: 3 · required

Three-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.

shadowCardNumber
​string · maxLength: 19 · required

The card the operation acts on, by its shadow card number — the platform's own reference, not the PAN.

increaseCount
​integer · int32 · min: 1 · required

How 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

DeferringDay
​number · double · required
AuthorizationNumber
​string · optional

The authorisation code the issuer returned when the transaction was approved. Six characters, from the scheme.

DeferringFlag
​boolean · optional
InstallmentCapitalAmount
​number · double · optional

The capital part of the instalment, without interest.

InstallmentCount
​integer · int32 · optional

How many instalments to split the amount across. The available counts for a card and amount come from the simulation operations.

InstallmentFeeAmount
​number · double · optional

The fee charged for splitting into instalments.

InstallmentProfitAmount
​number · double · optional

The interest charged across the instalments.

InstallmentTax1Amount
​number · double · optional
InstallmentTax2Amount
​number · double · optional
MaskedCardNumber
​string · optional

The card number with its middle digits masked, as the platform stores it. It is a display form, not a key.

MerchantName
​string · optional

The merchant's name as it reached the platform from the scheme.

RemainingCapitalAmount
​number · double · optional
RemainingFeeAmount
​number · double · optional
RemainingInstallmentAmount
​number · double · optional
RemainingInstallmentCount
​integer · int32 · optional

How many instalments are still to run.

RemainingInstallmentProfitAmount
​number · double · optional
RemainingInstallmentBsmvAmount
​number · double · optional
RemainingTax
​number · double · optional
Tax
​number · double · optional
RemainingInstallmentKkdfAmount
​number · double · optional
ShadowCardNumber
​string · optional

The 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.

TotalCapitalAmount
​number · double · optional
TotalInstallmentAmount
​number · double · optional

What the instalments come to together.

TotalInstallmentProfitAmount
​number · double · optional
TotalInstallmentBsmvAmount
​number · double · optional
TotalInstallmentKkdfAmount
​number · double · optional
TotalFeeAmount
​number · double · optional
TrnDate
​string · optional

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.

Example: 2026-10-16T14:30:00Z
TrnDescription
​string · optional

The transaction in words, as it reached the platform.

TrnInstallmentType
​string · optional
Utid
​string · optional

The unique transaction identifier the platform gives a transaction, and the handle every later operation on it takes. Returned by the transaction listings.

RemainingTaxAndFeeAmount
​number · double · optional
TotalTaxAndFeeAmount
​number · double · optional
CurrentTaxAndFeeAmount
​number · double · optional
DeferringBsmvAmount
​number · double · optional
DeferringProfitAmount
​number · double · optional
DeferringKkdfAmount
​number · double · optional
TotalDeferringBsmvAmount
​number · double · optional
TotalDeferringProfitAmount
​number · double · optional
TotalDeferringKkdfAmount
​number · double · optional
RemainingDeferringBsmvAmount
​number · double · optional
RemainingDeferringProfitAmount
​number · double · optional
RemainingDeferringKkdfAmount
​number · double · optional

KeyValuePair_2

LKSResultItem

isSuccess
​boolean · required

Whether 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.

transactionId
​string · optional

The platform's identifier for this call, for tracing it in the logs.

detail
​string · optional

More about the error than message carries, where there is more.

ListCardAccountByAccountNumberRequest

channel
​string · maxLength: 3 · required

Three-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.

accountNumber
​integer · int64 · optional

The 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

​array · optional

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

channel
​string · maxLength: 3 · required

Three-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.

shadowCardNumber
​string · maxLength: 19 · optional

The 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

​array · optional

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

CardRefNumber
​string · optional

The card reference, which identifies one issued card including its renewals. Returned by the create and listing operations alongside the shadow number.

Channel
​string · optional

Three-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.

DeferringDate
​string · optional

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.

Example: 2026-10-16T14:30:00Z
DeferringMonth
​number · double · optional
FeeRate
​number · double · optional
FixedFeeAmount
​number · double · optional
InsertUserId
​string · optional

An 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.

InstallmentAmount
​number · double · optional

What each instalment comes to.

InstallmentCode
​string · optional
InstallmentCount
​integer · int32 · optional

How many instalments to split the amount across. The available counts for a card and amount come from the simulation operations.

InstallmentProfitRate
​number · double · optional
InstallmentPriority
​integer · int32 · optional
InstallmentProfitAmount
​number · double · optional

The interest charged across the instalments.

MaskedCardNumber
​string · optional

The card number with its middle digits masked, as the platform stores it. It is a display form, not a key.

MerchantName
​string · optional

The merchant's name as it reached the platform from the scheme.

ProcessedDate
​string · optional

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.

Example: 2026-10-16T14:30:00Z
ProcessedFlag
​boolean · optional
RecordId
​integer · int64 · optional

The identifier of the row the operation created or acted on. Returned rather than sent in most operations that carry it.

InstallmentTaxAmount
​number · double · optional
TrnAmount
​number · double · optional

The amount of the transaction, in its own currency.

TrnDate
​string · optional

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.

Example: 2026-10-16T14:30:00Z
TrnSource
​integer · int32 · optional
ValidFlag
​boolean · optional

Whether the row is live. The platform sets it; a value sent here is replaced.

Utid
​string · optional

The unique transaction identifier the platform gives a transaction, and the handle every later operation on it takes. Returned by the transaction listings.

InstallmentOrderDate
​string · optional

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.

Example: 2026-10-16T14:30:00Z
ShadowCardNumber
​string · optional

The 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.

SupplementaryCardFlag
​boolean · optional

Whether this is a supplementary card rather than a main one.

ManuelInstallmentOrderRequest

installmentCount
​integer · int32 · optional

How many instalments to split the amount across. The available counts for a card and amount come from the simulation operations.

shadowCardNumber
​string · maxLength: 19 · optional

The 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.

utid
​string · maxLength: 50 · optional

Required in practice — The transaction to split, as in the simulation. The same key orders the plan that was simulated. Not validated here.

deferringMonthCount
​integer · int32 · optional

How many months the purchase is deferred by.

channelType
​string · maxLength: 5 · optional

The 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.

ManuelInstallmentOrderResponse

installmentOrderRecordId
​integer · int64 · required

ManuelInstallmentOrderSimulateRecord

installmentNumber
​integer · int32 · required

Which instalment this is.

installmentAmount
​number · double · required

What each instalment comes to.

installmentDate
​string · required

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.

Example: 2026-10-16T14:30:00Z
installmentCapitalAmount
​number · double · required

The capital part of the instalment, without interest.

remainingTotalAmount
​number · double · required

ManuelInstallmentOrderSimulateRequest

installmentCount
​integer · int32 · optional

Required in practice — How many instalments to plan for. Echoed back rather than answered — see the 200 description.

shadowCardNumber
​string · maxLength: 19 · optional

Required in practice — The card the transaction belongs to. It narrows the lookup; it does not select what is split. Not validated here.

utid
​string · maxLength: 50 · optional

Required 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.

deferringMonthCount
​integer · int32 · optional

Months to defer the first instalment by. Sending one makes the headline total understate the cost; see the 200 description.

ManuelInstallmentOrderSimulateResponse

installmentAmount
​number · double · required

What each instalment comes to.

profitRate
​number · double · required
totalPaymentAmount
​number · double · required
totalPFTAmount
​number · double · required
installmentCount
​integer · int32 · required

How many instalments to split the amount across. The available counts for a card and amount come from the simulation operations.

deferringMonthCount
​integer · int32 · required

How many months the purchase is deferred by.

​array · optional

NextPeriodInstallmentItem

statementDate
​string · required

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.

Example: 2026-10-16T14:30:00Z
totalAmount
​number · double · required

The amount of every entry in the list added together.

​array · optional

The transactions the search matched.

OperationLimitErrorItem

errorCode
​string · optional

The platform's own code for the error, and what to match on.

errorText
​string · optional

The error in words, for a log or a screen rather than for matching.

OperationLimitItem

​object · optional

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.

profileCode
​string · maxLength: 10 · optional

Which profile the card's limits come from.

profileDescription
​string · optional

Not 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.

perTrnAmount
​number · double · optional

The most the card may spend in one transaction.

perTrnAmountLimitRatio
​number · double · optional

The same cap as a share of the card's limit rather than an amount.

dailyTrnCount
​integer · int32 · optional

The most transactions the card may make in a day.

dailyTrnAmount
​number · double · optional

The most the card may spend in a day.

weeklyTrnCount
​integer · int32 · optional

The most transactions the card may make in a week.

weeklyTrnAmount
​number · double · optional

The most the card may spend in a week.

monthlyTrnCount
​integer · int32 · optional

The most transactions the card may make in a month.

monthlyTrnAmount
​number · double · optional

The most the card may spend in a month.

yearlyTrnCount
​integer · int32 · optional

The most transactions the card may make in a year.

yearlyTrnAmount
​number · double · optional

The most the card may spend in a year.

cardType
​string · maxLength: 1 · optional

Which kind of card, as the one-letter code the account type carries: C credit, D debit, P prepaid.

OperationLimitItemKeys

customLimitationChangeFlag
​boolean · required
limitProfileDetailId
​integer · int64 · optional

The limit row this entry belongs to.

trnLimitationGroupCode
​string · enum · maxLength: 10 · optional

Values:

  • SA — purchase
  • NA — cash advance
  • ST — purchase, main card
trnLimitationGroupDescription
​string · optional

Not 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.

trnMainLimitationGroupCode
​string · enum · maxLength: 10 · optional

Values:

  • SA — purchase
  • NA — cash advance
  • ST — purchase, main card
trnMainLimitationGroupDescription
​string · optional

Not 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.

networkType
​string · maxLength: 5 · optional

Values:

  • O — on-us
  • D — domestic, through BKM
  • M — Mastercard
  • V — Visa
networkDescription
​string · optional

Not 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.

channelType
​string · maxLength: 5 · optional

The channel a limit row applies to, which is not the channel the request is made on.

channelDescription
​string · optional

Not 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.

eventCode
​string · maxLength: 30 · optional

Which event the limit row is keyed on.

eventDescription
​string · optional

Not 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.

mcc
​string · maxLength: 4 · optional

The merchant category code — the four-digit code the scheme classifies the merchant's trade with.

mccGroup
​string · maxLength: 10 · optional

RecreateCustomerCardAccountsRequest

channel
​string · maxLength: 3 · required

Three-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.

shadowCardNumber
​string · maxLength: 19 · optional

The 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.

​array · optional

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

utid
​string · maxLength: 50 · optional

The unique transaction identifier the platform gives a transaction, and the handle every later operation on it takes. Returned by the transaction listings.

feeAmount
​number · double · optional

The fee charged on the transaction.

earlyReleaseType
​integer · int32 · optional

Which kind of early settlement is being asked for.

ReleasePendingInstallmentResponse

erLogRecordId
​integer · int64 · required
shadowCardNumber
​string · optional

The 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

channel
​string · maxLength: 3 · required

Three-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.

cardRefNumber
​string · maxLength: 19 · required

The card whose operation limits are removed.

​RemoveOperationLimitItemKeys[] · required

ListHasNoItem — Which operation limits to remove. An empty list is refused rather than treated as nothing to do.

RemoveCardOperationLimitResponse

​array · optional

One entry per item the request asked about.

RemoveCardOperationLimitResponseItem

actionType
​integer · enum · int32 · required

Which kind of change this entry records. — 0 None, 1 Insert, 2 Update, 3 Delete

Enum values:
0
1
2
3
success
​boolean · required

Whether 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.

​object · optional

Which limit row this is — group, network and channel.

​array · optional

What went wrong, one entry per problem. Present on a refusal; the HTTP status carries the kind.

RemoveCustomerOperationLimitRequest

channel
​string · maxLength: 3 · required

Three-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.

customerNumber
​integer · int64 · min: 1 · required

Customer whose operation limits are removed. Negative and zero are refused separately, each with its own code, and the customer must then exist.

​RemoveOperationLimitItemKeys[] · required

ListHasNoItem — Which limits to remove. An empty list is refused; a key naming no limit on this customer is refused as a business failure.

RemoveCustomerOperationLimitResponse

​array · optional

One entry per item the request asked about.

RemoveCustomerOperationLimitResponseItem

actionType
​integer · enum · int32 · required

Which kind of change this entry records. — 0 None, 1 Insert, 2 Update, 3 Delete

Enum values:
0
1
2
3
success
​boolean · required

Whether 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.

​array · optional

What went wrong, one entry per problem. Present on a refusal; the HTTP status carries the kind.

​object · optional

Which limit row this is — group, network and channel.

RemoveOperationLimitItemKeys

operationLimitRecordId
​integer · int64 · required

The limit row the operation acts on, as returned by the limit listing.

RenewCountItem

embossReasonSubCode
​string · optional

Values:

  • BRK — broken card
  • CHF — damaged chip
  • EXP — renewal at maturity
  • FRD — fraud
  • MGF — magnetic stripe error
  • NSU — name update
  • OTH — other
  • EXO — bulk renewal at maturity
  • LST — lost card
  • STL — stolen card

Not set is ---.

embossReasonSubDesc
​string · optional

The description of embossReasonSubCode, carried alongside it for display. It is not a key: match on the code.

renewAmount
​number · double · optional
renewCount
​integer · int64 · optional
maxRenewCount
​integer · int64 · optional

ReplaceCardRequest

channel
​string · maxLength: 3 · required

Three-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.

shadowCardNumber
​string · maxLength: 19 · required

The card being replaced.

cardEmbossReason
​string · maxLength: 3 · required

Why the card is reissued. Renew is the only value this operation accepts; anything else is refused.

Values:

  • N — new card
  • Y — renewal
cardEmbossSubReason
​string · maxLength: 3 · required

The sub-reason under cardEmbossReason.

Values:

  • BRK — broken card
  • CHF — damaged chip
  • EXP — renewal at maturity
  • FRD — fraud
  • MGF — magnetic stripe error
  • NSU — name update
  • OTH — other
  • EXO — bulk renewal at maturity
  • LST — lost card
  • STL — stolen card

Not set is ---.

embossName
​string · maxLength: 26 · optional

The name printed on the card.

deliveryType
​string · enum · maxLength: 1 · optional

How the card reaches the cardholder. Branch makes deliveryBranchCode mandatory; Post constrains deliveryAddressType.

Values:

  • P — by post
  • S — to the branch

Not set is "".

deliveryAddressType
​string · enum · maxLength: 2 · optional

Conditional — The address the card is posted to. When deliveryType is Post and this is sent, it may not be None.

Values:

  • RA — home
  • AL — business
  • EA — employer
  • OO — alternative
  • WA — previous
  • SW — SWIFT
  • SS — SWIFT name and address
  • MR — Mernis, registered
  • MS — Mernis, stated

Not set is --.

deliveryBranchCode
​integer · int32 · optional

Conditional — The branch the card is delivered to. Mandatory when deliveryType is Branch.

productNumber
​string · maxLength: 5 · optional

Reissue onto a different product. If sent it must be a product the platform defines; the product change scenario must exist too.

instantIssuingFlag
​boolean · optional

Default false — Issue the card at a branch on the spot. True makes embossBranchCode mandatory.

embossBranchCode
​integer · int32 · optional

Conditional — The branch that prints the card. Mandatory when instantIssuingFlag is true.

​object · optional

Permissions to carry onto the new card.

cardSendAddressId
​integer · int64 · optional

The stored address the card is sent to.

enrollMasterpass
​boolean · optional

Enrol the new card in Masterpass.

ReplaceCardRequestInfo

deliveryType
​string · enum · maxLength: 1 · optional

How 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 post
  • S — to the branch

Not set is "".

deliveryAddressType
​string · enum · maxLength: 2 · optional

Values:

  • RA — home
  • AL — business
  • EA — employer
  • OO — alternative
  • WA — previous
  • SW — SWIFT
  • SS — SWIFT name and address
  • MR — Mernis, registered
  • MS — Mernis, stated

Not set is --.

deliveryBranchCode
​integer · int32 · optional
embossName
​string · maxLength: 26 · optional

The name embossed on the card.

cardEmbossReason
​string · maxLength: 3 · optional

Required · 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 card
  • Y — renewal
cardEmbossSubReason
​string · maxLength: 3 · optional

Required · NotNullOrWhiteSpace — The sub-reason for the re-emboss, demanded alongside cardEmbossReason.

Values:

  • BRK — broken card
  • CHF — damaged chip
  • EXP — renewal at maturity
  • FRD — fraud
  • MGF — magnetic stripe error
  • NSU — name update
  • OTH — other
  • EXO — bulk renewal at maturity
  • LST — lost card
  • STL — stolen card

Not set is ---.

productNumber
​string · maxLength: 5 · optional

The card product the card is issued on. Defined in the parameter tables; getCardProductList returns the ones a tenant may use.

​object · optional

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.

cardSendAddressId
​integer · int64 · optional

Which of the customer's addresses to send the card to. The identifier of an address already held for that customer, not an address.

ReplaceCardResponse

newCardGenerated
​boolean · required

Whether the change produced a new card.

productChanged
​boolean · required

Whether the change moved the card to another product.

expiryDate
​string · required

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.

Example: 2026-10-16T14:30:00Z
shadowCardNumber
​string · optional

The 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.

cardRefNumber
​string · optional

The card reference, which identifies one issued card including its renewals. Returned by the create and listing operations alongside the shadow number.

maskedCardNumber
​string · optional

The 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.

​object · optional

What the operation wants to say about work it did anyway. A warning does not mean the operation failed.

ReplaceCardResponseInfo

newCardGenerated
​boolean · required

Whether the change produced a new card.

productChanged
​boolean · required

Whether the change moved the card to another product.

expiryDate
​string · required

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.

Example: 2026-10-16T14:30:00Z
shadowCardNumber
​string · optional

The 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.

cardRefNumber
​string · optional

The card reference, which identifies one issued card including its renewals. Returned by the create and listing operations alongside the shadow number.

maskedCardNumber
​string · optional

The 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

channel
​string · maxLength: 3 · required

Three-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.

customerNumber
​integer · int64 · min: 1 · required

The customer the card is for. Omitted it arrives as 0, which the service refuses, as it does a negative number.

applicationId
​integer · int64 · required

The replace application to issue the card from. Omitted it arrives as 0, which matches no application and is refused.

barcode
​string · maxLength: 20 · optional

The delivery barcode the consignment is tracked by.

ReplaceCardUsingNoNameApplicationResponse

recordId
​integer · int64 · required

The identifier of the row the operation created or acted on. Returned rather than sent in most operations that carry it.

maskedCardNumber
​string · optional

The 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.

shadowCardNumber
​string · optional

The 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.

cardRefNumber
​string · optional

The card reference, which identifies one issued card including its renewals. Returned by the create and listing operations alongside the shadow number.

mainCardRefNumber
​string · optional

The 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.

​object · optional

What the operation wants to say about work it did anyway. A warning does not mean the operation failed.

​object · optional

The card number, expiry and verification value, returned only where the operation and the channel are entitled to them.

ReplaceNoNameCardPermissions

eCommercePermitted
​boolean · optional

Whether the card may be used online.

ReplaceNoNameCardRequest

channel
​string · maxLength: 3 · required

Three-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.

shadowCardNumber
​string · maxLength: 19 · optional

The 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.

replaceReasonCode
​string · maxLength: 3 · optional

Why the card is being replaced. It decides what the replacement inherits and whether the card number changes.

​object · optional

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.

enrollMasterpass
​boolean · optional

Whether to enrol the new card with Masterpass. Forwarded to the issuing service, which does the enrolment; the card is created either way.

ReplaceNoNameCardResponse

applicationId
​integer · int64 · optional

The card application this request belongs to. Returned when an application is created, and carried through the card that comes out of it.

shadowCardNumber
​string · optional

The 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.

newCardGenerated
​boolean · optional

Whether the change produced a new card.

productChanged
​boolean · optional

Whether the change moved the card to another product.

maskedCardNumber
​string · optional

The 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.

cardRefNumber
​string · optional

The card reference, which identifies one issued card including its renewals. Returned by the create and listing operations alongside the shadow number.

ResetCardLimitRequest

channel
​string · maxLength: 3 · required

Three-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.

cardRefNumber
​string · maxLength: 19 · required

The 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.

ResetCardLimitResponse

changeLogRecordId
​integer · int64 · required

ResetCvvCounterRequest

channel
​string · maxLength: 3 · required

Three-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.

shadowCardNumber
​string · maxLength: 19 · required

The card the operation acts on, by its shadow card number — the platform's own reference, not the PAN.

ReverseCashAdvanceRequest

amount
​number · double · optional

The amount.

shadowCardNumber
​string · maxLength: 19 · optional

The 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.

uTID
​string · maxLength: 50 · optional

The unique transaction identifier the platform gives a transaction, and the handle every later operation on it takes. Returned by the transaction listings.

referenceNumber
​string · maxLength: 50 · optional

The caller's own reference for the transaction, carried into the institution transaction record. It is truncated to 50 characters rather than refused.

ReverseCashAdvanceResponse

isSuccess
​boolean · required

Whether 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.

uTID
​string · optional

The unique transaction identifier the platform gives a transaction, and the handle every later operation on it takes. Returned by the transaction listings.

authCode
​string · optional

The authorisation code the issuer returned when the transaction was approved. Six characters, from the scheme.

responseReasonCode
​string · optional

Why the downstream system answered as it did, where it narrows the response code.

ReverseCashInstallmentRequest

amount
​number · double · optional

The amount.

shadowCardNumber
​string · maxLength: 19 · optional

The 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.

uTID
​string · maxLength: 50 · optional

The unique transaction identifier the platform gives a transaction, and the handle every later operation on it takes. Returned by the transaction listings.

referenceNumber
​string · maxLength: 50 · optional

The caller's own reference for the transaction, carried into the institution transaction record. It is truncated to 50 characters rather than refused.

ReverseCashInstallmentResponse

isSuccess
​boolean · required

Whether 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.

uTID
​string · optional

The unique transaction identifier the platform gives a transaction, and the handle every later operation on it takes. Returned by the transaction listings.

authCode
​string · optional

The authorisation code the issuer returned when the transaction was approved. Six characters, from the scheme.

responseReasonCode
​string · optional

Why the downstream system answered as it did, where it narrows the response code.

ReversePaymentTransactionRequest

uTID
​string · maxLength: 50 · required

UTID returned by the original doPaymentTransaction.

referenceNumber
​string · maxLength: 50 · required

Same reference number as the original payment.

shadowCardNumber
​string · maxLength: 19 · required

Card the original payment was posted on.

authCode
​string · maxLength: 10 · required

Authorisation code from the original payment response.

amount
​number · double · optional

Present on the contract but not forwarded to online by the digital-channels layer; reverse is keyed by UTID / reference / auth.

ReversePaymentTransactionResponse

isSuccess
​boolean · required

Whether 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.

uTID
​string · optional

The unique transaction identifier the platform gives a transaction, and the handle every later operation on it takes. Returned by the transaction listings.

authCode
​string · optional

The authorisation code the issuer returned when the transaction was approved. Six characters, from the scheme.

responseCode
​string · optional

The 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.

responseCodeDescription
​string · optional

The description of responseCode, carried alongside it for display. It is not a key: match on the code.

responseReasonCode
​string · optional

Why the downstream system answered as it did, where it narrows the response code.

responseReasonCodeDescription
​string · optional

The description of responseReasonCode, carried alongside it for display. It is not a key: match on the code.

RewardDetail

rewardType
​string · optional

Which kind of reward was earned.

rewardTypeDescription
​string · optional

The description of rewardType, carried alongside it for display. It is not a key: match on the code.

availableBankReward
​number · double · optional

RewardItem

amount
​number · double · required

The amount.

rewardType
​string · optional

Which kind of reward was earned.

rewardTypeDescription
​string · optional

The description of rewardType, carried alongside it for display. It is not a key: match on the code.

RewardItems

amount
​number · double · required

The amount.

SaveCardPermissionsRequest

channel
​string · maxLength: 3 · required

Three-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.

​SaveCardPermissionsRequestItem[] · required

The permissions to write. Must be sent; an empty list is accepted and changes nothing.

cardRefNumber
​string · maxLength: 19 · optional

One-of · NotNull — The card to permit or restrict. Send this or shadowCardNumber; sending neither is refused with both named.

shadowCardNumber
​string · maxLength: 19 · optional

One-of · NotNull — The card to permit or restrict. Send this or cardRefNumber; when both are sent this one finds the card.

SaveCardPermissionsRequestItem

restrictionCode
​string · maxLength: 3 · required

The restriction this entry is about. Must be a restriction the platform defines; a bad one is reported against permissions.

Values:

  • SA — purchase
  • NA — cash
  • DN — domestic cash
  • YD — international sale
  • YN — international cash
  • AT — ATM
  • MO — mail order
  • EC — e-commerce, fully secure
  • EN — e-commerce, half secure
  • EX — e-commerce, not secure
  • CLS — contactless
  • TA — instalment
  • PTH — pre-authorisation
  • QC — quasi cash
  • CB — POS cashback
  • CSB — cashback
  • TCS — POS cash advance
  • FA — bill payment
  • VG — tax payment
  • CEK — cheque
  • FF — FastFund
  • PPP — project sharing programme
permitted
​boolean · optional

Default false — True permits, false restricts. Null is read as false.

startDate
​string · optional

When 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.

Example: 2026-10-16T14:30:00Z
endDate
​string · optional

When 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.

Example: 2026-10-16T14:30:00Z
transactionId
​string · maxLength: 50 · optional

The caller's own id for this entry.

SaveCardPermissionsResponse

changedCount
​integer · int32 · required

How 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.

listOfRecordId
​array · optional

SaveCreditCardAutoPaymentOrderRequest

accountNumber
​integer · int32 · required

Funding account number. Lifecycle rejects an empty or zero account.

shadowCardNumber
​string · maxLength: 19 · required

Card whose auto-payment order is created or updated.

paymentType
​string · maxLength: 3 · required

T (all / statement), A (minimum), or N (none). Blank defaults to T; any other value throws 60004.

accountOwnerName
​string · optional

Display name of the funding account owner.

Belongs to the core banking account rather than to a column here.

SaveCreditCardAutoPaymentOrderResponse

SensitiveCardData

pan
​string · optional

The card number in full. Returned only where the operation is entitled to it.

expiryDateStr
​string · optional

The card's expiry as MMYY.

cvv
​string · optional

SensitiveData

pan
​string · optional

The card number in full. Returned only where the operation is entitled to it.

cvv2
​string · optional

SetCardOperationLimitRequest

channel
​string · maxLength: 3 · required

Three-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.

cardRefNumber
​string · maxLength: 19 · required

The card whose limits are set.

​OperationLimitItem[] · required

ListHasNoItem — The limits to write. Must be sent and must hold at least one entry.

SetCardOperationLimitResponse

​array · optional

One entry per item the request asked about.

SetCardOperationLimitResponseItem

actionType
​integer · enum · int32 · required

Which kind of change this entry records. — 0 None, 1 Insert, 2 Update, 3 Delete

Enum values:
0
1
2
3
success
​boolean · required

Whether 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.

​array · optional

What went wrong, one entry per problem. Present on a refusal; the HTTP status carries the kind.

​object · optional

The operation limits in force.

SetCardPinRequest

channel
​string · maxLength: 3 · required

Three-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.

shadowCardNumber
​string · maxLength: 19 · optional

The 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.

clearPin
​string · optional

Exactly 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

success
​boolean · required

Whether 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.

encryptedPin
​string · optional

The PIN block as the key management service produced it. The PIN itself never travels.

SetCustomerOperationLimitRequest

channel
​string · maxLength: 3 · required

Three-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.

customerNumber
​integer · int64 · min: 1 · required

Customer 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.

​OperationLimitItem[] · required

ListHasNoItem — The limits to set. An empty list is refused rather than treated as nothing to do.

SetCustomerOperationLimitResponse

​array · optional

One entry per item the request asked about.

SetCustomerOperationLimitResponseItem

actionType
​integer · enum · int32 · required

Which kind of change this entry records. — 0 None, 1 Insert, 2 Update, 3 Delete

Enum values:
0
1
2
3
success
​boolean · required

Whether 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.

​array · optional

What went wrong, one entry per problem. Present on a refusal; the HTTP status carries the kind.

​object · optional

The operation limits in force.

SetRsaPinRequest

channel
​string · maxLength: 3 · required

Three-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.

shadowCardNumber
​string · maxLength: 19 · required

The card whose PIN is set.

ePB
​string · required

The 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.

operationDate
​string · required

The 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.

Example: 2026-10-16T14:30:00Z

SetRsaPinResponse

success
​boolean · required

Whether 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.

encryptedPin
​string · optional

The PIN block as the key management service produced it. The PIN itself never travels.

responseCode
​integer · int32 · optional

The 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.

responseDescription
​string · optional

The description of responseCode, carried alongside it for display. It is not a key: match on the code.

SimulateCashInstallmentForAllRequest

channelId
​string · maxLength: 3 · required

Three-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.

shadowCardNumber
​string · maxLength: 19 · required

The 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.

accountNumber
​string · optional

The 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.

transactionAmount
​number · double · optional

The amount of the transaction.

SimulateCashInstallmentForAllResponse

​array · optional

SimulateCashInstallmentInstallmentRow

installmentNumber
​integer · int32 · required

Which instalment this is.

installmentDate
​string · required

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.

Example: 2026-10-16T14:30:00Z
installmentAmount
​number · double · required

What each instalment comes to.

installmentCapitalAmount
​number · double · required

The capital part of the instalment, without interest.

installmentProfitAmount
​number · double · required

The interest charged across the instalments.

installmentBsmvAmount
​number · double · required
installmentKkdfAmount
​number · double · required
remainingTotalAmount
​number · double · required
remainingCapitalAmount
​number · double · required
remainingProfitAmount
​number · double · required
remainingBsmvAmount
​number · double · required
remainingKkdfAmount
​number · double · required

SimulateCashInstallmentRequest

channelId
​string · maxLength: 3 · required

Three-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.

shadowCardNumber
​string · maxLength: 19 · required

The 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.

accountNumber
​string · optional

The 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.

transactionAmount
​number · double · optional

The amount of the transaction.

installmentCount
​integer · int32 · optional

How many instalments to split the amount across. The available counts for a card and amount come from the simulation operations.

SimulateCashInstallmentResponse

​object · optional

SimulateCashInstallmentRow

totalAmount
​number · double · required

The amount of every entry in the list added together.

totalProfitAmount
​number · double · required
totalBsmvAmount
​number · double · required
totalKkdfAmount
​number · double · required
insterestRate
​number · double · required
firstInstallAmount
​number · double · required
installmentAmount
​number · double · required

What each instalment comes to.

installmentDate
​string · required

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.

Example: 2026-10-16T14:30:00Z
installmentCount
​integer · int32 · required

How many instalments to split the amount across. The available counts for a card and amount come from the simulation operations.

​array · optional

SimulateInstallmentEarlyReleaseRequest

shadowCardNumber
​string · maxLength: 19 · optional

The 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.

utid
​string · maxLength: 50 · optional

The unique transaction identifier the platform gives a transaction, and the handle every later operation on it takes. Returned by the transaction listings.

SimulateInstallmentEarlyReleaseResponse

CanceledFeeAndProfitAmount
​number · double · required
ProfitAmount
​number · double · required
FeeAmount
​number · double · required

The fee charged on the transaction.

EarlyReleaseDeferringAmount
​number · double · required
TrnDate
​string · required

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.

Example: 2026-10-16T14:30:00Z
EarlyPaymentAmount
​number · double · required
RemainingInstallmentCount
​integer · int32 · required

How many instalments are still to run.

TotalInstallmentCount
​integer · int32 · required

How many instalments the plan has in all.

AmountOfRemainingInstallment
​number · double · required
SummaryRecordId
​integer · int64 · required
CanceledProfitAmount
​number · double · required
CanceledKkdfAmount
​number · double · required
CanceledBsmvAmount
​number · double · required
CanceledFeeAmount
​number · double · required

StatementCodeInfo

statementCode
​string · optional
description
​string · optional

The error in words. errorCode is the part to match on; this is for a log or a screen.

StatementRemainingDebtList

currencyCode
​string · optional

The currency of the amount, as its three-letter code.

remainingDebt
​number · double · optional

What is still owed.

StatementRewardDetail

rewardType
​string · optional

Which kind of reward was earned.

rewardTypeDescription
​string · optional

The description of rewardType, carried alongside it for display. It is not a key: match on the code.

revolvingTotalReward
​number · double · optional

SubmitCardApplicationExtStatusRequest

channel
​string · maxLength: 3 · required

Three-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.

applicationId
​integer · int64 · min: 1 · required

Card 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.

externalStatusCode
​string · maxLength: 1 · required

The 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

cardApplicationExtStatusHistoryRecordId
​integer · int64 · required

TransferBranchCustomerRequest

channel
​string · maxLength: 3 · required

Three-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.

currentBranchCode
​integer · int32 · required

The 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.

targetBranchCode
​integer · int32 · required

The branch the customers are moved to.

listOfPersonId
​integer[] · required

Which customers to move. Checked for presence, not for contents.

TransferBranchCustomerResponse

oldBranch
​integer · int32 · required

The branch before the move.

newBranch
​integer · int32 · required

The branch after it.

changedCardCount
​integer · int32 · required

How many cards the operation changed.

listOfShadowCardNumbers
​array · optional

The cards the operation acted on.

VerifyCardPinRequest

channel
​string · maxLength: 3 · required

Three-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.

shadowCardNumber
​string · maxLength: 19 · optional

The 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.

clearCardNumber
​string · optional

A card number is not stored by these services; the platform keeps a shadow card number instead.

clearPin
​string · optional

Exactly 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

verified
​boolean · required

Whether the value presented matched the one held.

lastTryCount
​integer · int32 · required

How many failed attempts stand against the card.

tryCountExceed
​boolean · required

Whether the card has run out of attempts. The card is blocked when it has.

VerifyCardVerificationValueRequest

channel
​string · maxLength: 3 · required

Three-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.

shadowCardNumber
​string · maxLength: 19 · required

The card whose CVV is being checked.

verificationValue
​string · minLength: 3 · maxLength: 3 · required

NotNull · LengthNotEquals — The CVV to check. Exactly 3 characters; any other length is refused before the card is read.

VerifyCardVerificationValueResponse

verified
​boolean · required

Whether 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

channel
​string · maxLength: 3 · required

Three-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.

shadowCardNumber
​string · maxLength: 19 · required

The card whose CVV is being checked.

​KeyValuePair_2[] · required

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

verified
​boolean · required

True 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

channel
​string · maxLength: 3 · required

Three-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.

shadowCardNumber
​string · maxLength: 19 · required

The card the operation acts on, by its shadow card number — the platform's own reference, not the PAN.

ePB
​string · required

The 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.

operationDate
​string · required

The 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.

Example: 2026-10-16T14:30:00Z

VerifyRsaPinResponse

verified
​boolean · required

Whether the value presented matched the one held.

lastTryCount
​integer · int32 · required

How many failed attempts stand against the card.

tryCountExceed
​boolean · required

Whether the card has run out of attempts. The card is blocked when it has.

responseCode
​integer · int32 · required

The 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.

responseDescription
​string · optional

The description of responseCode, carried alongside it for display. It is not a key: match on the code.

VerifyRsaPinWithStaticSaltRequest

channel
​string · maxLength: 3 · required

Three-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.

shadowCardNumber
​string · maxLength: 19 · required

The card the operation acts on, by its shadow card number — the platform's own reference, not the PAN.

ePB
​string · required

The 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.

operationDate
​string · required

The 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.

Example: 2026-10-16T14:30:00Z
staticSalt
​string · required

The 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

verified
​boolean · required

Whether the value presented matched the one held.

lastTryCount
​integer · int32 · required

How many failed attempts stand against the card.

tryCountExceed
​boolean · required

Whether the card has run out of attempts. The card is blocked when it has.

responseCode
​integer · int32 · required

The 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.

responseDescription
​string · optional

The description of responseCode, carried alongside it for display. It is not a key: match on the code.

WaitingInstallmentCompositeInfo

​array · optional
​object · optional

WaitingInstallmentDetailInfo

recordId
​integer · int64 · required

The identifier of the row the operation created or acted on. Returned rather than sent in most operations that carry it.

statementDate
​string · required

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.

Example: 2026-10-16T14:30:00Z
installmentAmount
​number · double · required

What each instalment comes to.

amount
​number · double · required

The amount.

trnAmount
​number · double · required

The amount of the transaction, in its own currency.

creditCardStatementTransactionTypeIsBorrow
​boolean · required
creditCardStatementTransactionTypeIsLoan
​boolean · required
domesticAmount
​number · double · required
totalPointEarned
​number · double · required
installmentNumber
​integer · int32 · required

Which instalment this is.

originalAmount
​number · double · required
totalInstallmentCount
​integer · int32 · required

How many instalments the plan has in all.

transactionDate
​string · required

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.

Example: 2026-10-16T14:30:00Z
cardProductVirtualFlag
​boolean · required

Whether the product is a virtual one.

cardProductDigitalFlag
​boolean · required

Whether the product can be issued digitally.

remainInstallmentAmount
​number · double · required
supplementaryCardFlag
​boolean · required

Whether this is a supplementary card rather than a main one.

erOrderedFlag
​boolean · required
digitalSlipFlag
​boolean · required

Whether a digital receipt was produced.

utid
​string · optional

The unique transaction identifier the platform gives a transaction, and the handle every later operation on it takes. Returned by the transaction listings.

trnCodeMatrixId
​string · optional

Which row of the transaction-code matrix this transaction was classified by.

shadowCardNumber
​string · optional

The 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.

cardRefNumber
​string · optional

The card reference, which identifies one issued card including its renewals. Returned by the create and listing operations alongside the shadow number.

mainCardRefNumber
​string · optional

The 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.

maskedCardNumber
​string · optional

The 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.

installmentCurrencyCode
​string · optional
currencyCode
​string · optional

The currency of the amount, as its three-letter code.

trnCurrencyCode
​string · optional

The currency the transaction was made in.

mCCCode
​string · optional
mCCDescription
​string · optional

The description of mCCCode, carried alongside it for display. It is not a key: match on the code.

mCCGroupCode
​string · optional
mCCGroupDescription
​string · optional

The description of mCCGroupCode, carried alongside it for display. It is not a key: match on the code.

transactionCode
​string · optional
transactionDescription
​string · optional

The description of transactionCode, carried alongside it for display. It is not a key: match on the code.

productNumber
​string · optional

The card product the card is issued on. Defined in the parameter tables; getCardProductList returns the ones a tenant may use.

capitalRewardIndicator
​string · optional

Whether the reward counts towards the capital scheme.

trnEffect
​string · optional

Whether the transaction adds to the balance or takes from it.

channelType
​string · optional

The channel a limit row applies to, which is not the channel the request is made on.

bkmUniqueMerchantId
​string · optional

The merchant's identifier at BKM, the domestic switch.

digitalSlipValue
​string · optional

The digital receipt itself.

rewardType
​string · optional

Which kind of reward was earned.

rewardTypeDescription
​string · optional

The description of rewardType, carried alongside it for display. It is not a key: match on the code.

authorizationNumber
​string · optional

The authorisation code the issuer returned when the transaction was approved. Six characters, from the scheme.

bsmvAmount
​number · double · optional

The BSMV levy on the transaction.

kkdfAmount
​number · double · optional

The KKDF levy on the transaction.

installmentFeeAmount
​number · double · optional

The fee charged for splitting into instalments.

installmentProfitAmount
​number · double · optional

The interest charged across the instalments.

panEntryMode
​string · optional

How the card was read at the terminal — chip, stripe, contactless, keyed, or stored on file. The scheme's own code.

panEntryModeDescription
​string · optional

The description of panEntryMode, carried alongside it for display. It is not a key: match on the code.

merchantName
​string · optional

The merchant's name as it reached the platform from the scheme.

merchantNumber
​string · optional

The merchant's number with the acquirer.

WaitingInstallmentSummaryInfo

statementDate
​string · required

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.

Example: 2026-10-16T14:30:00Z
totalInstallmentAmount
​number · double · required

What the instalments come to together.

totalInstallmentBsmvAmount
​number · double · required
totalInstallmentCapitalAmount
​number · double · required
totalInstallmentFeeAmount
​number · double · required
totalInstallmentKkdfAmount
​number · double · required
totalInstallmentProfitAmount
​number · double · required
On this page
  • ActivateNoNameCardRequest
  • AddDocumentByCaseNumberRequest
  • ApplicableProductFilter
  • ApplicableProductFilters
  • AttachCardAccountRequest
  • AttachCardAccountResponse
  • CancelCardEmbossByShadowCardNumberRequest
  • CancelCashInstallEarlyReleasePaymentRequest
  • CancelCashInstallEarlyReleasePaymentResponse
  • CancelCreditCardDebtPaymentRequest
  • CancelCreditCardDebtPaymentResponse
  • CancelDisputeCaseRequest
  • CancelDisputeCaseResponse
  • CancelInstallmentEarlyReleaseRequest
  • CancelInstallmentEarlyReleaseResponse
  • CancelInstallmentTransactionOrderRequest
  • CancelInstallmentTransactionOrderResponse
  • CancelNoNameCardApplicationRequest
  • CardAccount
  • CardAccountInfo
  • CardAutoPaymentOrderEntity
  • CardFinancialInfoByCardRefNumberItem
  • CardInfo
  • CardIntermTransactionInfo
  • CardLimitationParameterData
  • CardMccAmountSummary
  • CardMccRewardSummary
  • CardMiscOptionData
  • CardMiscOptionResponse
  • CardStatementInfo
  • CardStatementInfoResponse
  • CashInstallmentEarlyReleaseDetailEntity
  • CashInstallmentEarlyReleaseSummaryEntity
  • ChangeAndReplaceCardRequest
  • ChangeAndReplaceCardResponse
  • ChangeAndReplaceNoNameCardReplaceModel
  • ChangeAndReplaceNoNameCardRequest
  • ChangeAndReplaceNoNameCardResponse
  • ChangeCardAutoLimitIncreaseRequest
  • ChangeCardAutoLimitIncreaseResponse
  • ChangeCardBranchRequest
  • ChangeCardBranchResponse
  • ChangeCardLimitDecreaseRequest
  • ChangeCardLimitDecreaseResponse
  • ChangeCardLimitRequest
  • ChangeCardLimitResponse
  • ChangeCardLimitReverseRequest
  • ChangeCardLimitReverseResponse
  • ChangeCardMiscOptionRequest
  • ChangeCardPinRequest
  • ChangeCardPinResponse
  • ChangeCardStatusRequest
  • ChangeCardStatusResponse
  • ChangeCorporateCardLimitDecreaseRequest
  • ChangeCorporateCardLimitIncreaseRequest
  • ChangeCorporateCardLimitResponse
  • ChangeCreditCardStatementPeriodRequest
  • ChangeCreditCardStatementPeriodResponse
  • ChangeCreditCardStatementSendPreferenceRequest
  • ChangeCreditCardStatementSendPreferenceResponse
  • ChangeCustomerBranchRequest
  • ChangeCustomerBranchResponse
  • ChangeCustomerCreditCardStatusRequest
  • ChangeCustomerCreditCardStatusResponse
  • ChangeIndividualCardLimitRequest
  • ChangeIndividualCardLimitResponse
  • ChangeRsaPinRequest
  • ChangeRsaPinResponse
  • ChangeVirtualCardLimitRequest
  • ChangeVirtualCardLimitResponse
  • CheckCreditCardForDebtPaymentRequest
  • CheckCreditCardForDebtPaymentResponse
  • CreateCardMiscOption
  • CreateCardPermissions
  • CreateCorporateCardRequest
  • CreateCorporateCardResponse
  • CreateDisputeCaseDetail
  • CreateDisputeCaseRequest
  • CreateDisputeCaseResponse
  • CreateDummyCorporateCardRequest
  • CreateDummyCorporateCardResponse
  • CreateIndividualCardAccount
  • CreateIndividualCardAutoPaymentAccount
  • CreateIndividualCardRequest
  • CreateIndividualCardResponse
  • CreateIndividualCreditCardPermissions
  • CreateIndividualSupplementaryCardRequest
  • CreateIndividualSupplementaryCardResponse
  • CreateNoNameCardAccount
  • CreateNoNameCardPermissions
  • CreateNoNameCardRequest
  • CreateNoNameCardResponse
  • CreateVirtualCardRequest
  • CreateVirtualCardResponse
  • CreditCardCollectionInfo
  • CreditCardCollectionTransactionItem
  • CreditCardCurrentPeriodTransactionModel
  • CreditCardCurrentPeriodTransactionModels
  • CreditCardDetailTransactionItem
  • CreditCardDetailTransactionItems
  • CreditCardIntermTransactionItem
  • CreditCardModel
  • CreditCardNextPeriodInstallmentModel
  • CreditCardPendingTransactionItem
  • CreditCardPermissions
  • CreditCardStatementItem
  • CreditCardStatementSendPreference
  • CreditCardTransactionItem
  • CreditCardTransactionItems
  • CreditCorporateCustomerInfo
  • CustomerAssetInfo
  • CustomerLimitationParameterData
  • DecreaseCustomerLimitRequest
  • DecreaseCustomerLimitResponse
  • DetachCardAccountByAccountNumberRequest
  • DetachCardAccountByAccountNumberResponse
  • DetachCardAccountRequest
  • DetachCardAccountResponse
  • DisputeList
  • DisputeReasonDefinitions
  • DisputeTransactionDetail
  • DmsReference
  • DmsReferences
  • DoCashAdvanceRequest
  • DoCashAdvanceResponse
  • DoCashInstallmentEarlyReleasePaymentRequest
  • DoCashInstallmentEarlyReleasePaymentResponse
  • DoCashInstallmentRequest
  • DoCashInstallmentResponse
  • DoCreditCardDebtPaymentRequest
  • DoCreditCardDebtPaymentResponse
  • DoEarlyCloseRequest
  • DoEarlyCloseResponse
  • DoPaymentFeeInquiryRequest
  • DoPaymentFeeInquiryResponse
  • DoPaymentTransactionRequest
  • DoPaymentTransactionResponse
  • EarlyCloseCandidateRow
  • Error
  • GenerateCardVVRequest
  • GenerateCardVVResponse
  • GetAllWaitingInstallmentsRequest
  • GetAllWaitingInstallmentsResponse
  • GetApplicableProductsByCustomerNumberRequest
  • GetApplicableProductsByCustomerNumberResponse
  • GetApplicableProductsByMainCustomerRequest
  • GetApplicableProductsByMainCustomerResponse
  • GetApplicableProductsItem
  • GetAvailableCardStatusListRequest
  • GetAvailableCardStatusListResponse
  • GetAvailableCardStatusListResponseItem
  • GetCalculatedStatementPeriodRequest
  • GetCalculatedStatementPeriodResponse
  • GetCancelableCashAdvanceListRequest
  • GetCancelableCashAdvanceListResponse
  • GetCancelableCashAdvanceModel
  • GetCancelableCashInstallmentListRequest
  • GetCancelableCashInstallmentListResponse
  • GetCancelableCashInstallmentModel
  • GetCancelableCreditCardDebtPaymentListRequest
  • GetCancelableCreditCardDebtPaymentListResponse
  • GetCancelablePaymentModel
  • GetCardAvailableLimitRequest
  • GetCardAvailableLimitResponse
  • GetCardDelinquencyInfoByCustomerNumberRequest
  • GetCardDelinquencyInfoByCustomerNumberResponse
  • GetCardFinancialInfoByCardRefNumberRequest
  • GetCardFinancialInfoByCardRefNumberResponse
  • GetCardIntermTransactionInfoRequest
  • GetCardLimitationParametersRequest
  • GetCardLimitationParametersResponse
  • GetCardListNewRequest
  • GetCardListRequest
  • GetCardListResponse
  • GetCardMemo
  • GetCardMemoRequest
  • GetCardMemoResponse
  • GetCardMiscOptionRequest
  • GetCardMiscOptionResponse
  • GetCardOperationLimitRequest
  • GetCardOperationLimitResponse
  • GetCardOperationLimitResponseItem
  • GetCardPermissionsRequest
  • GetCardPermissionsResponse
  • GetCardStatementAddressInformationRequest
  • GetCardStatementAddressInformationResponse
  • GetCardStatementDetailRequest
  • GetCardStatementDetailResponse
  • GetCardStatementDetailSummaryRequest
  • GetCardStatementDetailSummaryResponse
  • GetCardStatementListRequest
  • GetCardStatementSummaryRequest
  • GetCardStatementSummaryResponse
  • GetCashAdvanceInfoRequest
  • GetCashAdvanceInfoResponse
  • GetCashInstallmentParameterItem
  • GetCashInstallmentParameterRequest
  • GetCashInstallmentParameterResponse
  • GetCorporateCustomerInfoByIndividualCustomerRequest
  • GetCorporateCustomerInfoByIndividualCustomerResponse
  • GetCreditApplicationIdByFromShadowCardNumberRequest
  • GetCreditApplicationIdByFromShadowCardNumberResponse
  • GetCreditCardAutoPaymentOrderRequest
  • GetCreditCardAutoPaymentOrderResponse
  • GetCreditCardCollectionInfoByCardRefNumberRequest
  • GetCreditCardCollectionInfoByCardRefNumberResponse
  • GetCreditCardCollectionInfoByMainCustomerNumberRequest
  • GetCreditCardCollectionInfoByMainCustomerNumberResponse
  • GetCreditCardCollectionTransactionListByDateRequest
  • GetCreditCardCollectionTransactionListByDateResponse
  • GetCreditCardCurrentTransactionListRequest
  • GetCreditCardCurrentTransactionListResponse
  • GetCreditCardDateRangeForRewardByCustomerNumberReqSourceRequest
  • GetCreditCardDateRangeForRewardByCustomerNumberReqSourceResponse
  • GetCreditCardInfoRequest
  • GetCreditCardInfoResponse
  • GetCreditCardLastStatementRequest
  • GetCreditCardLastStatementResponse
  • GetCreditCardLimitRequest
  • GetCreditCardLimitResponse
  • GetCreditCardPortfolioSummaryRequest
  • GetCreditCardPortfolioSummaryResponse
  • GetCreditCardStatementSendPreferenceRequest
  • GetCreditCardStatementSendPreferenceResponse
  • GetCreditCardTransactionAllRequest
  • GetCreditCardTransactionAllResponse
  • GetCreditCustomerLisfOfBranchRequest
  • GetCreditCustomerListOfBranchResponse
  • GetCustomerAssetsSummaryCreditCardModel
  • GetCustomerAssetsSummaryCreditRequest
  • GetCustomerAssetsSummaryCreditResponse
  • GetCustomerAvailableLimitRequest
  • GetCustomerAvailableLimitResponse
  • GetCustomerCreditCardListByTenantIdProductNumberResponse
  • GetCustomerCreditCardListByTenantIdProductNumberResult
  • GetCustomerCreditCardListByTenantIdRequest
  • GetCustomerCreditCardListByTenantIdResponse
  • GetCustomerCreditCardListByTenantIdResult
  • GetCustomerCreditShadowCardsByTenantIdRequest
  • GetCustomerCreditShadowCardsByTenantIdResponse
  • GetCustomerCreditShadowCardsByTenantIdResult
  • GetCustomerLimitationParametersRequest
  • GetCustomerLimitationParametersResponse
  • GetCustomerOperationLimitRequest
  • GetCustomerOperationLimitResponse
  • GetCustomerTotalLimitInfoRequest
  • GetCustomerTotalLimitInfoResponse
  • GetCustomerTransactionDetailRequest
  • GetCustomerTransactionDetailResponse
  • GetDigitalSlipReceiptRequest
  • GetDigitalSlipReceiptResponse
  • GetDisputeListRequest
  • GetDisputeListResponse
  • GetDisputeReasonDefResponse
  • GetEarlyCloseCandidateListRequest
  • GetEarlyCloseCandidateListResponse
  • GetEarlyReleaseAvailableInstallmentsByCriteriasRequest
  • GetEarlyReleaseAvailableInstallmentsByCriteriasResponse
  • GetEarlyReleaseCashInstallmentRequest
  • GetEarlyReleaseCashInstallmentResponse
  • GetEarlyReleaseCashInstallmentsRequest
  • GetEarlyReleaseCashInstallmentsResponse
  • GetInstallmentCountsByUtidRequest
  • GetInstallmentCountsByUtidResponse
  • GetManuelInstallmentCancelRecordsByCardRefNumberRequest
  • GetManuelInstallmentCancelRecordsByCardRefNumberResponse
  • GetPendingCardEmbossListRequest
  • GetPendingCardEmbossListResponse
  • GetPendingProvisionListRequest
  • GetPendingProvisionListResponse
  • GetRenewCountByShadowCardNumberRequest
  • GetRenewCountByShadowCardNumberResponse
  • GetStatementPeriodByProductNumberRequest
  • GetStatementPeriodByProductNumberResponse
  • GetStatementPeriodChangeCountRequest
  • GetStatementPeriodChangeCountResponse
  • GetStatementPeriodChangeInfoRequest
  • GetStatementPeriodChangeInfoResponse
  • GetWaitingInstallmentDetailRequest
  • GetWaitingInstallmentSummaryRequest
  • GetWaitingInstallmentSummaryResponse
  • HealthCheckResponse
  • IncreasePinTryCountRequest
  • InstallmentEarlyReleaseRow
  • KeyValuePair_2
  • LKSResultItem
  • ListCardAccountByAccountNumberRequest
  • ListCardAccountByAccountNumberResponse
  • ListCardAccountByShadowCardNumberRequest
  • ListCardAccountByShadowCardNumberResponse
  • ManuelInstallmentCancelRecord
  • ManuelInstallmentOrderRequest
  • ManuelInstallmentOrderResponse
  • ManuelInstallmentOrderSimulateRecord
  • ManuelInstallmentOrderSimulateRequest
  • ManuelInstallmentOrderSimulateResponse
  • NextPeriodInstallmentItem
  • OperationLimitErrorItem
  • OperationLimitItem
  • OperationLimitItemKeys
  • RecreateCustomerCardAccountsRequest
  • ReleasePendingInstallmentRequest
  • ReleasePendingInstallmentResponse
  • RemoveCardOperationLimitRequest
  • RemoveCardOperationLimitResponse
  • RemoveCardOperationLimitResponseItem
  • RemoveCustomerOperationLimitRequest
  • RemoveCustomerOperationLimitResponse
  • RemoveCustomerOperationLimitResponseItem
  • RemoveOperationLimitItemKeys
  • RenewCountItem
  • ReplaceCardRequest
  • ReplaceCardRequestInfo
  • ReplaceCardResponse
  • ReplaceCardResponseInfo
  • ReplaceCardUsingNoNameApplicationRequest
  • ReplaceCardUsingNoNameApplicationResponse
  • ReplaceNoNameCardPermissions
  • ReplaceNoNameCardRequest
  • ReplaceNoNameCardResponse
  • ResetCardLimitRequest
  • ResetCardLimitResponse
  • ResetCvvCounterRequest
  • ReverseCashAdvanceRequest
  • ReverseCashAdvanceResponse
  • ReverseCashInstallmentRequest
  • ReverseCashInstallmentResponse
  • ReversePaymentTransactionRequest
  • ReversePaymentTransactionResponse
  • RewardDetail
  • RewardItem
  • RewardItems
  • SaveCardPermissionsRequest
  • SaveCardPermissionsRequestItem
  • SaveCardPermissionsResponse
  • SaveCreditCardAutoPaymentOrderRequest
  • SaveCreditCardAutoPaymentOrderResponse
  • SensitiveCardData
  • SensitiveData
  • SetCardOperationLimitRequest
  • SetCardOperationLimitResponse
  • SetCardOperationLimitResponseItem
  • SetCardPinRequest
  • SetCardPinResponse
  • SetCustomerOperationLimitRequest
  • SetCustomerOperationLimitResponse
  • SetCustomerOperationLimitResponseItem
  • SetRsaPinRequest
  • SetRsaPinResponse
  • SimulateCashInstallmentForAllRequest
  • SimulateCashInstallmentForAllResponse
  • SimulateCashInstallmentInstallmentRow
  • SimulateCashInstallmentRequest
  • SimulateCashInstallmentResponse
  • SimulateCashInstallmentRow
  • SimulateInstallmentEarlyReleaseRequest
  • SimulateInstallmentEarlyReleaseResponse
  • StatementCodeInfo
  • StatementRemainingDebtList
  • StatementRewardDetail
  • SubmitCardApplicationExtStatusRequest
  • SubmitCardApplicationExtStatusResponse
  • TransferBranchCustomerRequest
  • TransferBranchCustomerResponse
  • VerifyCardPinRequest
  • VerifyCardPinResponse
  • VerifyCardVerificationValueRequest
  • VerifyCardVerificationValueResponse
  • VerifyPartialCardVerificationValueRequest
  • VerifyPartialCardVerificationValueResponse
  • VerifyRsaPinRequest
  • VerifyRsaPinResponse
  • VerifyRsaPinWithStaticSaltRequest
  • VerifyRsaPinWithStaticSaltResponse
  • WaitingInstallmentCompositeInfo
  • WaitingInstallmentDetailInfo
  • WaitingInstallmentSummaryInfo