Statements and billing
Produce the statement a cardholder reads, and manage the period, delivery preference and address behind it.
getCardStatementSummary
Retrieves a summary of a credit card statement for a given main card reference and statement date. Returns information such as minimum payment amount, previous total amount, remaining debt, statement date, earned points, due date, next statement date, next due date, currency code, statement debt, total earned points, and remaining minimum payment debt.
Headers
evrst-ptrnidCorrelation id for this request. Echo it in your own logs to trace the call through the platform.
getCardStatementSummary › Request Body
mainCardRefNumberThe card reference of the main card. On a supplementary card this is the card it hangs from; on a main card it is the card's own reference.
statementDateA date and time as a string, in RFC 3339 form: 2026-10-16T14:30:00Z, or with an offset, 2026-10-16T17:30:00+03:00.
getCardStatementSummary › Responses
Success
minimumPaymentAmountThe least that may be paid this period.
prevTotalAmountWhat the total came to before this change.
remainingDebtWhat is still owed.
statementDateA date and time as a string, in RFC 3339 form: 2026-10-16T14:30:00Z, or with an offset, 2026-10-16T17:30:00+03:00.
earnedPointAmountdueDateA date and time as a string, in RFC 3339 form: 2026-10-16T14:30:00Z, or with an offset, 2026-10-16T17:30:00+03:00.
nextStatementDateA date and time as a string, in RFC 3339 form: 2026-10-16T14:30:00Z, or with an offset, 2026-10-16T17:30:00+03:00.
nextDueDateA date and time as a string, in RFC 3339 form: 2026-10-16T14:30:00Z, or with an offset, 2026-10-16T17:30:00+03:00.
statementDebtWhat the statement says is owed.
totalEarnedPointAmountremainingMinimumPaymentDebtWhat is left of the minimum payment.
currencyCodeThe currency of the amount, as its three-letter code.
getCardStatementDetail
Retrieves detailed credit card statement information including transaction rows, totals, installment details, reward points, and payment history. Supports filtering by statement date and channel, handles historical and current statement data, and maps results to CreditCardDetailTransactionItem objects.
Part of:
- Journey 02 · Managing a card product — step 1, Retrieve statements
Headers
evrst-ptrnidCorrelation id for this request. Echo it in your own logs to trace the call through the platform.
getCardStatementDetail › Request Body
channelThree-digit code identifying the channel on behalf of which the request is made (e.g. 002 for Internet). Mandatory in every request. Used for entitlement checks, limit enforcement and audit logging. Channel codes are managed through configuration parameters and may change over time. Refer to the Channels page for the current list of valid codes.
mainCardRefNumberThe main card's reference, and nothing else will do. A supplementary card's own reference fetches no statement — its spending appears as rows on the main card's. This is the one field any operation on this side checks itself.
statementDateRequired in practice — The statement to read. The schema marks it nullable and the code does not treat it as optional: the header totals are read with this date before the branch for an absent one can take effect, so a request without it does not succeed. Send it.
A date and time as a string, in RFC 3339 form: 2026-10-16T14:30:00Z, or with an offset, 2026-10-16T17:30:00+03:00.
minStatementDateHow far back the detail rows may reach. Ignored when statementDate is sent, and when neither is sent it defaults to the first of the month seven months back — which is the window, and why an older period cannot be reached by widening this field alone.
A date and time as a string, in RFC 3339 form: 2026-10-16T14:30:00Z, or with an offset, 2026-10-16T17:30:00+03:00.
getCardStatementDetail › Responses
A statement's totals and its rows — read separately, and either can be empty while the other is not.
The totals are looked for in the current statement table first. Where that holds no row and a statementDate was given, a history table is read instead. If both are empty the totals stay at zero and this is still a 200, so zero totals beside a list of rows is a state a caller has to handle rather than a contradiction. Reward detail is a third read, against the same date.
The channel changes which rows come back. Beyond stamping the read, it is matched against one channel in the catalogue for which reward transactions are removed from the detail; and independently of the channel, instalment rows in one transaction group are removed unless they are cash-instalment early releases. The same statement read on two channels is not guaranteed to carry the same rows.
prevTotalAmountWhat the total came to before this change.
totalAmountThe amount of every entry in the list added together.
totalDebittotalCredittotalCashtotalProfitFeeTaxtotalProfittotalFeetotalTax1totalTax2getCreditCardStatementSendPreference
Retrieves credit card statement delivery preferences for a customer using CustomerNumber and channel. Fetches customer-level statement delivery settings and active main credit cards, and returns per-card preferences including statement email, SMS, and physical posting options along with the posting address type.
Headers
evrst-ptrnidCorrelation id for this request. Echo it in your own logs to trace the call through the platform.
getCreditCardStatementSendPreference › Request Body
channelThree-digit code identifying the channel on behalf of which the request is made (e.g. 002 for Internet). Mandatory in every request. Used for entitlement checks, limit enforcement and audit logging. Channel codes are managed through configuration parameters and may change over time. Refer to the Channels page for the current list of valid codes.
customerNumberThe customer at the bank's core banking system, as a number. The platform stores it rather than issuing it, so it comes from the core.
getCreditCardStatementSendPreference › Responses
Success
getCardStatementList
Retrieves a list of credit card statements for a given main card reference or shadow card number. Returns statement information including total amount, minimum amount, statement date, next statement date, due date, next due date, currency code, document ID, and associated reward details for each statement.
Part of:
- Journey 02 · Managing a card product — step 1, Retrieve statements
Headers
evrst-ptrnidCorrelation id for this request. Echo it in your own logs to trace the call through the platform.
getCardStatementList › Request Body
shadowCardNumberOne-of — The card whose statements are listed. Send this or mainCardRefNumber; sending neither is refused as a business failure rather than a field one, so no propertyName arrives with it. When this is the one sent, the facade looks the card master up to find the main card reference.
mainCardRefNumberOne-of — The main card reference the statements hang off. Send this or shadowCardNumber; when both are sent this one is used and no card lookup is done.
getCardStatementList › Responses
Success
getCreditCardLastStatement
Retrieves the most recent credit card statement information using ShadowCardNumber and channel. Validates card identifiers, resolves the main card reference number, and fetches the latest statement summary. Returns existing reward points, detailed last statement data, and a list of recent statement summaries ordered by statement period.
Headers
evrst-ptrnidCorrelation id for this request. Echo it in your own logs to trace the call through the platform.
getCreditCardLastStatement › Request Body
channelThree-digit code identifying the channel on behalf of which the request is made (e.g. 002 for Internet). Mandatory in every request. Used for entitlement checks, limit enforcement and audit logging. Channel codes are managed through configuration parameters and may change over time. Refer to the Channels page for the current list of valid codes.
shadowCardNumberThe platform's own handle for a card, and the identifier most operations take. It is returned by every operation that creates a card and by the card listings; a caller does not compose one.
getCreditCardLastStatement › Responses
Success
existingPointgetCreditCardLastStatementNew
Retrieves the most recent credit card statement information using ShadowCardNumber and channel. Validates card identifiers, resolves the main card reference number, and fetches the latest statement summary. Returns existing reward points, detailed last statement data, and a list of recent statement summaries ordered by statement period.
Headers
evrst-ptrnidCorrelation id for this request. Echo it in your own logs to trace the call through the platform.
getCreditCardLastStatementNew › Request Body
channelThree-digit code identifying the channel on behalf of which the request is made (e.g. 002 for Internet). Mandatory in every request. Used for entitlement checks, limit enforcement and audit logging. Channel codes are managed through configuration parameters and may change over time. Refer to the Channels page for the current list of valid codes.
shadowCardNumberThe platform's own handle for a card, and the identifier most operations take. It is returned by every operation that creates a card and by the card listings; a caller does not compose one.
getCreditCardLastStatementNew › Responses
Success
existingPointgetCardStatementDetailSummary
Retrieves a summary of credit card statement details including transaction rows, total amounts, minimum payments, remaining debt, earned points, due dates, and currency information. Uses GetCardStatementDetail or GetCardStatementDetailNew internally and maps results to GetCardStatementDetailSummaryResponse objects.
Headers
evrst-ptrnidCorrelation id for this request. Echo it in your own logs to trace the call through the platform.
getCardStatementDetailSummary › Request Body
mainCardRefNumberThe card reference of the main card. On a supplementary card this is the card it hangs from; on a main card it is the card's own reference.
statementDateA date and time as a string, in RFC 3339 form: 2026-10-16T14:30:00Z, or with an offset, 2026-10-16T17:30:00+03:00.
getCardStatementDetailSummary › Responses
Success
minimumPaymentAmountThe least that may be paid this period.
prevTotalAmountWhat the total came to before this change.
remainingDebtWhat is still owed.
statementDateA date and time as a string, in RFC 3339 form: 2026-10-16T14:30:00Z, or with an offset, 2026-10-16T17:30:00+03:00.
earnedPointAmountdueDateA date and time as a string, in RFC 3339 form: 2026-10-16T14:30:00Z, or with an offset, 2026-10-16T17:30:00+03:00.
nextStatementDateA date and time as a string, in RFC 3339 form: 2026-10-16T14:30:00Z, or with an offset, 2026-10-16T17:30:00+03:00.
nextDueDateA date and time as a string, in RFC 3339 form: 2026-10-16T14:30:00Z, or with an offset, 2026-10-16T17:30:00+03:00.
statementDebtWhat the statement says is owed.
totalEarnedPointAmountremainingMinimumPaymentDebtWhat is left of the minimum payment.
currencyCodeThe currency of the amount, as its three-letter code.
getCardStatementDetailSummaryNew
Retrieves a summary of credit card statement details including transaction rows, total amounts, minimum payments, remaining debt, earned points, due dates, and currency information. Uses GetCardStatementDetail or GetCardStatementDetailNew internally and maps results to GetCardStatementDetailSummaryResponse objects.
Headers
evrst-ptrnidCorrelation id for this request. Echo it in your own logs to trace the call through the platform.
getCardStatementDetailSummaryNew › Request Body
mainCardRefNumberThe card reference of the main card. On a supplementary card this is the card it hangs from; on a main card it is the card's own reference.
statementDateA date and time as a string, in RFC 3339 form: 2026-10-16T14:30:00Z, or with an offset, 2026-10-16T17:30:00+03:00.
getCardStatementDetailSummaryNew › Responses
Success
minimumPaymentAmountThe least that may be paid this period.
prevTotalAmountWhat the total came to before this change.
remainingDebtWhat is still owed.
statementDateA date and time as a string, in RFC 3339 form: 2026-10-16T14:30:00Z, or with an offset, 2026-10-16T17:30:00+03:00.
earnedPointAmountdueDateA date and time as a string, in RFC 3339 form: 2026-10-16T14:30:00Z, or with an offset, 2026-10-16T17:30:00+03:00.
nextStatementDateA date and time as a string, in RFC 3339 form: 2026-10-16T14:30:00Z, or with an offset, 2026-10-16T17:30:00+03:00.
nextDueDateA date and time as a string, in RFC 3339 form: 2026-10-16T14:30:00Z, or with an offset, 2026-10-16T17:30:00+03:00.
statementDebtWhat the statement says is owed.
totalEarnedPointAmountremainingMinimumPaymentDebtWhat is left of the minimum payment.
currencyCodeThe currency of the amount, as its three-letter code.
changeCreditCardStatementPeriod
Changes the statement period of a credit card. Validates input, retrieves the card master data, and calls the lifecycle service to update the statement period. Returns the record ID of the change. Also supports calculating the next statement dates without updating.
Headers
evrst-ptrnidCorrelation id for this request. Echo it in your own logs to trace the call through the platform.
changeCreditCardStatementPeriod › Request Body
statementPeriodWhich statement period the card is billed on. The periods a product allows come from the reference data.
shadowCardNumberThe platform's own handle for a card, and the identifier most operations take. It is returned by every operation that creates a card and by the card listings; a caller does not compose one.
changeCreditCardStatementPeriod › Responses
Success
changeRecordIdgetStatementPeriodChangeCount
Retrieves the count of statement period changes for a given credit card. The service calls the lifecycle service proxy with the CardRefNumber and returns a GetStatementPeriodChangeCountResponse containing the number of changes (ChangeCount) and a flag indicating whether the allowed change count has been exceeded (ChangeCountExceeded).
Headers
evrst-ptrnidCorrelation id for this request. Echo it in your own logs to trace the call through the platform.
getStatementPeriodChangeCount › Request Body
cardRefNumberThe card reference, which identifies one issued card including its renewals. Returned by the create and listing operations alongside the shadow number.
getStatementPeriodChangeCount › Responses
Success
changeCountExceededchangeCountgetCalculatedStatementPeriod
Calculates the first and next statement dates for a given shadow card number based on the provided new statement period code.
Headers
evrst-ptrnidCorrelation id for this request. Echo it in your own logs to trace the call through the platform.
getCalculatedStatementPeriod › Request Body
newStatementCodeThe statement period to move the card to.
shadowCardNumberThe platform's own handle for a card, and the identifier most operations take. It is returned by every operation that creates a card and by the card listings; a caller does not compose one.
getCalculatedStatementPeriod › Responses
Success
firstStatementDateA date and time as a string, in RFC 3339 form: 2026-10-16T14:30:00Z, or with an offset, 2026-10-16T17:30:00+03:00.
nextStatementDateA date and time as a string, in RFC 3339 form: 2026-10-16T14:30:00Z, or with an offset, 2026-10-16T17:30:00+03:00.
getStatementPeriodByProductNumber
Retrieves the statement periods associated with a given credit card product number. The service validates that the ProductNumber is not null or empty, calls the repository to get statement period information, and returns a GetStatementPeriodByProductNumberResponse containing a list of StatementCodeInfo objects with StatementCode and Description.
Headers
evrst-ptrnidCorrelation id for this request. Echo it in your own logs to trace the call through the platform.
getStatementPeriodByProductNumber › Request Body
productNumberThe card product the card is issued on. Defined in the parameter tables; getCardProductList returns the ones a tenant may use.
getStatementPeriodByProductNumber › Responses
Success
changeCreditCardStatementSendPreference
Updates the credit card statement delivery preferences. Allows changing email, SMS, and postal delivery flags for the main card. Calls the lifecycle service to persist the preferences and returns an empty response object.
Headers
evrst-ptrnidCorrelation id for this request. Echo it in your own logs to trace the call through the platform.
changeCreditCardStatementSendPreference › Request Body
mainCardRefNumberThe card reference of the main card. On a supplementary card this is the card it hangs from; on a main card it is the card's own reference.
emailSendFlagWhether the statement is sent by e-mail.
postingFlagWhether the statement is posted on paper.
smsSendFlagWhether the statement is announced by SMS.
postingAddressTypeWhich kind of address the statement is posted to.
changeCreditCardStatementSendPreference › Responses
getCardStatementAddressInformation
Retrieves statement delivery preferences for a credit card based on MainCardRefNumber. Includes flags for statement posting, email, and SMS delivery. Fetches CardMaster and CustomerMaster data.
Headers
evrst-ptrnidCorrelation id for this request. Echo it in your own logs to trace the call through the platform.
getCardStatementAddressInformation › Request Body
mainCardRefNumberThe card reference of the main card. On a supplementary card this is the card it hangs from; on a main card it is the card's own reference.
getCardStatementAddressInformation › Responses
Success
statementPostingFlagWhether the statement is posted on paper.
statementSmsSendFlagWhether the statement is announced by SMS.
statementEMailSendFlagaddressIdaddressTypeValues:
RA— homeAL— businessEA— employerOO— alternativeWA— previousSW— SWIFTSS— SWIFT name and addressMR— Mernis, registeredMS— Mernis, stated
Not set is --.
statementSendAddressTypeemailgetCardFinancialInfoByCardRefNumber
Retrieves detailed financial information for a card based on CardRefNumber, including limits, debts, statement info, delinquency status, and reward details for the card and customer.
Headers
evrst-ptrnidCorrelation id for this request. Echo it in your own logs to trace the call through the platform.
getCardFinancialInfoByCardRefNumber › Request Body
cardRefNumberThe card reference, which identifies one issued card including its renewals. Returned by the create and listing operations alongside the shadow number.
customerNumberThe customer at the bank's core banking system, as a number. The platform stores it rather than issuing it, so it comes from the core.
shadowCardNumberThe platform's own handle for a card, and the identifier most operations take. It is returned by every operation that creates a card and by the card listings; a caller does not compose one.
getCardFinancialInfoByCardRefNumber › Responses
Success
getStatementPeriodChangeInfo
Retrieves detailed information about statement period changes for a specific credit card. The service validates the CardRefNumber, fetches the card master record, and then retrieves statement change info from the repository. The response includes the current StatementDate, the next two statement dates (Next1StatementDate, Next2StatementDate), the LastChangeDate, the remaining allowed yearly statement changes (YearlyRemainingStatementChangeCount), and a flag indicating whether a statement period change is currently available (IsStatementPeriodChangeAvailable).
Headers
evrst-ptrnidCorrelation id for this request. Echo it in your own logs to trace the call through the platform.
getStatementPeriodChangeInfo › Request Body
cardRefNumberThe card reference, which identifies one issued card including its renewals. Returned by the create and listing operations alongside the shadow number.
getStatementPeriodChangeInfo › Responses
Success
yearlyRemainingStatementChangeCountstatementDateA date and time as a string, in RFC 3339 form: 2026-10-16T14:30:00Z, or with an offset, 2026-10-16T17:30:00+03:00.
next1StatementDateA date and time as a string, in RFC 3339 form: 2026-10-16T14:30:00Z, or with an offset, 2026-10-16T17:30:00+03:00.
next2StatementDateA date and time as a string, in RFC 3339 form: 2026-10-16T14:30:00Z, or with an offset, 2026-10-16T17:30:00+03:00.
lastChangeDateA date and time as a string, in RFC 3339 form: 2026-10-16T14:30:00Z, or with an offset, 2026-10-16T17:30:00+03:00.
isStatementPeriodChangeAvailable