Card lifecycle
Move a card through its states after issuance — status changes, replacement, renewal, blocking and closure.
List credit cards for a customer or account
Retrieves a list of credit cards based on various filters (card number, customer number, main customer number, barcode, account number, branch code, identification, courier status, etc.). Aggregates card product, branch, limit, debt, account info, annual fee, sensitive data (PAN/CVV2), and currency conversion details. Uses parallel async calls for efficiency and maps results to CreditCardModel objects.
List credit cards for a customer or account › Request Body
corpCardFlagCorp Card Flag - [Optional]
onlyLastCardFlagOnly Last Card Flag - [Optional]
virtualCardFlagVirtual Card Flag - [Optional]
customerNumberCustomer Number - [Optional]
mainCustomerNumberMain Customer Number - [Optional]
shadowCardNumberShadow Card Number - [Optional]
barcodeBarcode - [Optional]
accountNumberAccount Number - [Optional]
cardNumberCard Number - [Optional]
purposePurpose - [Optional]
channelCodeChannel Code - [Optional]
cardStatusCodeCard Status Code - [Optional]
cardStatusReasonCodeCard Status Reason Code - [Optional]
branchCodeBranch Code - [Optional]
customerNameSurnameCustomer Name Surname - [Optional]
identificationNumberIdentification Number - [Optional]
courierStatusCourier Status - [Optional]
List credit cards for a customer or account › Responses
Success
List Of Card - [Optional]
Card renewal service
Replaces a card by generating a new one with specified parameters such as emboss reason, delivery details, and card permissions. Returns the generated card details like masked card number, expiry date, and warnings.
Part of:
- Journey 02 · Managing a card product — step 2, Replace and renew
Card renewal service › Request Body
channelChannel - [Optional]
shadowCardNumberShadow Card Number - [Optional]
embossNameEmboss Name - [Optional]
deliveryTypeDelivery Type - [Optional]
deliveryAddressTypeDelivery Address Type - [Optional]
deliveryBranchCodeDelivery Branch Code - [Optional]
cardEmbossReasonCard Emboss Reason - [Optional]
cardEmbossSubReasonCard Emboss Sub Reason - [Optional]
productNumberProduct Number - [Optional]
instantIssuingFlagInstant Issuing Flag - [Optional]
embossBranchCodeEmboss Branch Code - [Optional]
Permissions - [Optional]
cardSendAddressIdCard Send Address Id - [Optional]
enrollMasterpassEnroll Masterpass - [Optional]
Card renewal service › Responses
Success
newCardGeneratedNew Card Generated - [Optional]
productChangedProduct Changed - [Optional]
expiryDateExpiry Date - [Optional]
shadowCardNumberShadow Card Number - [Optional]
cardRefNumberCard Ref Number - [Optional]
maskedCardNumberMasked Card Number - [Optional]
Warnings - [Optional]
Service that lists memo entries defined for the card
Retrieves a list of card memo entries for a given credit card, filtered by shadow card number, log code, customer number, and date range. Maps results from Lifecycle service to GetCardMemo objects including card reference, masked number, log details, old/new values, insert channel, user, and date.
Service that lists memo entries defined for the card › Request Body
customerNumberCustomer Number - [Optional]
startDateStart Date - [Optional]
endDateEnd Date - [Optional]
shadowCardNumberShadow Card Number - [Optional]
logCodeLog Code - [Optional]
Service that lists memo entries defined for the card › Responses
Success
Get Card Memo List - [Optional]
Service that allows updating the card’s status
Changes the status of a credit card. Calls the Lifecycle service to update the card status and reason code, optionally reissues the card, and can apply changes only to the specified shadow card. Returns information about the new status, affected shadow cards, card references for limit reset, customer limit reset flag, and a new shadow card number if applicable.
Part of:
-
Journey 01 · Launching a new card product — step 5, Activate and set the PIN
-
Journey 01 · Launching a new card product — step 4, Activate, PIN, transact
-
Journey 02 · Managing a card product — step 1, Status changes
Service that allows updating the card’s status › Request Body
reissueCardReissue Card - [Optional]
changeMeOnlyChange Me Only - [Optional]
shadowCardNumberShadow Card Number - [Optional]
cardStatusCodeCard Status Code - [Optional]
cardStatusReasonCodeCard Status Reason Code - [Optional]
channelChannel - [Optional]
transactionIdTransaction Id - [Optional]
closeRequestDateClose Request Date - [Optional]
Service that allows updating the card’s status › Responses
Success
toStatusActiveTo Status Active - [Optional]
resetCustomerLimitReset Customer Limit - [Optional]
listOfShadowCardNumberForClosedCardList Of Shadow Card Number For Closed Card - [Optional]
listOfCardRefNumberForResetLimitList Of Card Ref Number For Reset Limit - [Optional]
newShadowCardNumberNew Shadow Card Number - [Optional]
Service that updates the status of all cards owned by the customer
Changes the credit card status for a given customer. Validates input parameters, calls the lifecycle service to update card statuses, and returns a list of shadow card numbers for cards that were closed. Supports optional activation of cards and ensures proper rollback and logging on failure.
Service that updates the status of all cards owned by the customer › Request Body
channelChannel - [Mandatory]
customerNumberCustomer Number - [Mandatory]
cardStatusCodeCard Status Code - [Optional]
cardStatusReasonCodeCard Status Reason Code - [Optional]
activateCardActivate Card - [Optional]
Service that updates the status of all cards owned by the customer › Responses
Success
listOfShadowCardNumberForClosedCardList Of Shadow Card Number For Closed Card - [Optional]
Service that updates a card to a renewable status and performs card renewal
Changes the status of a credit card and replaces it with a new card if requested. Validates input, executes ChangeCardStatus via lifecycle service, then ReplaceCard via credit issuing service. Returns details about status change and replaced card.
Service that updates a card to a renewable status and performs card renewal › Request Body
channelChannel - [Optional]
shadowCardNumberShadow Card Number - [Optional]
cardStatusCodeCard Status Code - [Optional]
cardStatusReasonCodeCard Status Reason Code - [Optional]
closeRequestDateClose Request Date - [Optional]
Replace Info - [Optional]
Service that updates a card to a renewable status and performs card renewal › Responses
Success
toStatusActiveTo Status Active - [Optional]
resetCustomerLimitReset Customer Limit - [Optional]
listOfShadowCardNumberForClosedCardList Of Shadow Card Number For Closed Card - [Optional]
listOfCardRefNumberForResetLimitList Of Card Ref Number For Reset Limit - [Optional]
Replace Result - [Optional]
Get Renew Count By Shadow Card Number
Request Body
channelChannel
shadowCardNumberShadow Card Number
embossReasonSubCodeEmboss Reason Sub Code
Responses
Success
shadowCardNumberShadow Card Number
cardRefNumberCard Ref Number
mainCardRefNumberMain Card Ref Number
isSupplementaryIs Supplementary
List Of Renew Count
Service that retrieves detailed credit card information based on card data
Retrieves detailed credit card information using ShadowCardNumber or CardNumber. Validates input parameters, resolves ShadowCardNumber when CardNumber is provided, and fetches card details including virtual and corporate cards. Returns card information along with card-level and customer-level reward details such as available rewards, reward types, and descriptions.
Service that retrieves detailed credit card information based on card data › Request Body
channelChannel - [Optional]
shadowCardNumberShadow Card Number - [Optional]
cardNumberCard Number - [Optional]
Service that retrieves detailed credit card information based on card data › Responses
Success
Card Info - [Optional]
Card Reward Details - [Optional]
Customer Reward Details - [Optional]
Service that lists cards by customer’s Tenant information
Retrieves a list of credit cards for a customer filtered by TenantId and optionally by ProductNumbers. Validates the request, checks card status, filters closed or renewed cards, calculates total debt, fetches statement remaining debt, card limits, and other card attributes. Returns detailed credit card information including masked card numbers, limits, delinquency, due dates, digital card flags, and pending replace applications.
Service that lists cards by customer’s Tenant information › Request Body
customerNumberCustomer Number - [Optional]
tenantIdTenant Id - [Optional]
channelCodeChannel Code - [Optional]
productNumbersProduct Numbers - [Optional]
Service that lists cards by customer’s Tenant information › Responses
Success
Customer Credit Card List - [Optional]
Service that returns masked and shadow card information along with card status
Retrieves a list of a customer's credit shadow cards filtered by TenantId. It validates the request, retrieves all shadow cards for the customer from the repository, and returns them with details such as card type, masked number, product info, and status codes/descriptions.
Service that returns masked and shadow card information along with card status › Request Body
customerNumberCustomer Number - [Optional]
tenantIdTenant Id - [Optional]
channelChannel - [Optional]
Service that returns masked and shadow card information along with card status › Responses
Success
Customer Credit Shadow Card List - [Optional]
Service that lists cards by customer’s Tenant and product information
Retrieves a customer's credit card list filtered by TenantId and optionally by ProductNumber. It validates the request, filters out closed or invalid cards based on status, debt, and digital/physical card rules, and enriches each card with statement remaining debt and available limit information retrieved from the limit service proxy.
Service that lists cards by customer’s Tenant and product information › Request Body
customerNumberCustomer Number - [Optional]
tenantIdTenant Id - [Optional]
channelCodeChannel Code - [Optional]
productNumbersProduct Numbers - [Optional]
Service that lists cards by customer’s Tenant and product information › Responses
Success
Customer Credit Card List - [Optional]
Retrieves a list of credit cards based on various filters (card number, customer number, main customer number, barcode, account number, branch code, identification, courier status, etc.). Aggregates card product, branch, limit, debt, account info, annual fee, sensitive data (PAN/CVV2), and currency conversion details. Uses parallel async calls for efficiency and maps results to CreditCardModel objects.
Request Body
isCorporateAllCardListIs Corporate All Card List - [Optional]
customerNumberCustomer Number - [Optional]
mainCustomerNumberMain Customer Number - [Optional]
shadowCardNumberShadow Card Number - [Optional]
barcodeBarcode - [Optional]
accountNumberAccount Number - [Optional]
cardNumberCard Number - [Optional]
purposePurpose - [Optional]
channelCodeChannel Code - [Optional]
cardStatusCodeCard Status Code - [Optional]
cardStatusReasonCodeCard Status Reason Code - [Optional]
tenantIdTenant Id - [Optional]
Responses
Success
List Of Card - [Optional]