Card issuance and personalisation
Create individual, corporate and virtual cards, and check which products a customer is eligible to hold before you issue.
createIndividualCard
Creates a new individual credit card for a customer. Supports digital and physical cards, multiple accounts, addresses, auto payment, permissions, and optional card miscellaneous options. Returns card reference, shadow card number, masked card number, and sensitive card data if applicable.
Part of:
- Journey 01 · Launching a new card product — step 4, Issue the card
Headers
evrst-ptrnidCorrelation id for this request. Echo it in your own logs to trace the call through the platform.
createIndividualCard › Request Body
channelRequired · Enum · NotNull — Three-digit channel code. Must be a defined channel, and the product must list it as an applicable channel.
productNumberRequired · NotNull — The product the card is issued on. Must be defined, applicable, and have at least one applicable channel.
customerNumberRequired · NotNull — The customer the card is issued to.
branchCodeRequired · NotNull — The branch the card is issued from. Must be a defined branch.
digitalCardFlagDigital Card Flag
nameOnCardName On Card - [Optional]
secondNameOnCardSecond Name On Card - [Optional]
cardDeliveryTypeOptional — How the card reaches the cardholder. Branch makes cardDeliveryBranchCode mandatory.
cardSendAddressTypeCard Send Address Type - [Optional]
cardDeliveryBranchCodeConditional · NotNull — The branch the card is delivered to. Mandatory when cardDeliveryType is Branch.
cardSendAddressIdCard Send Address Id - [Optional]
Permissions - [Optional]
List Of Account - [Optional]
Card Misc Option - [Optional]
enrollMasterpassEnroll Masterpass - [Optional]
contractTypeContract Type - [Optional]
contractVersionNumberContract Version Number - [Optional]
statementPeriodStatement Period - [Optional]
statementCurrencyCodeStatement Currency Code - [Optional]
statementSendingAddressTypeStatement Sending Address Type - [Optional]
statementPostFlagStatement Post Flag - [Optional]
statementSmsSendFlagStatement Sms Send Flag - [Optional]
statementEmailSendFlagStatement Email Send Flag - [Optional]
statementSendAddressIdStatement Send Address Id - [Optional]
cardLimitValueCard Limit Value - [Optional]
customerLimitValueCustomer Limit Value - [Optional]
authorizationSmsSendFlagAuthorization Sms Send Flag - [Optional]
authorizationSmsSendMinimumAmountAuthorization Sms Send Minimum Amount - [Optional]
autoInstallmentCountAuto Installment Count - [Optional]
autoDeferringMonthCountAuto Deferring Month Count - [Optional]
autoLimitIncreaseFlagAuto Limit Increase Flag - [Optional]
autoPaymentFlagAuto Payment Flag - [Optional]
Auto Payment Account - [Optional]
applicationChannelApplication Channel - [Optional]
applicationIdApplication Id - [Optional]
applicationDateApplication Date - [Optional]
applicationContractIdApplication Contract Id - [Optional]
createIndividualCard › Responses
Success
recordIdRecord Id
maskedCardNumberMasked Card Number - [Optional]
shadowCardNumberShadow Card Number - [Optional]
cardRefNumberCard Ref Number - [Optional]
mainCardRefNumberMain Card Ref Number - [Optional]
Warnings - [Optional]
Sensitive Card Data - [Optional]
createIndividualSupplementaryCard
Creates a new individual supplementary credit card for a customer. Supports digital and physical cards, multiple accounts, addresses, auto payment, permissions, and optional card miscellaneous options. Returns card reference, shadow card number, masked card number, and sensitive card data if applicable.
Headers
evrst-ptrnidCorrelation id for this request. Echo it in your own logs to trace the call through the platform.
createIndividualSupplementaryCard › Request Body
productNumberProduct Number
channelThree-digit channel code (for example "002", not "Internet"). Used for entitlement, limits and the audit trail. See the Channels page (sidebar, or from Get started) for the full code list.
digitalCardFlagDigital Card Flag
customerNumberCustomer Number
shadowCardNumberShadow Card Number
nameOnCardName On Card
secondNameOnCardSecond Name On Card
branchCodeBranch Code
cardDeliveryTypeCard Delivery Type
cardSendAddressTypeCard Send Address Type
cardDeliveryBranchCodeCard Delivery Branch Code
cardSendAddressIdCard Send Address Id
Permissions
List Of Account
Card Misc Option
enrollMasterpassEnroll Masterpass
contractTypeContract Type
contractVersionNumberContract Version Number
cardLimitValueCard Limit Value
authorizationSmsSendFlagAuthorization Sms Send Flag
authorizationSmsSendMinimumAmountAuthorization Sms Send Minimum Amount
autoInstallmentCountAuto Installment Count
autoDeferringMonthCountAuto Deferring Month Count
applicationChannelApplication Channel
applicationIdApplication Id
applicationDateApplication Date
applicationContractIdApplication Contract Id
createIndividualSupplementaryCard › Responses
Success
recordIdRecord Id
maskedCardNumberMasked Card Number
shadowCardNumberShadow Card Number
cardRefNumberCard Ref Number
mainCardRefNumberMain Card Ref Number
Warnings
Sensitive Card Data
createDummyCorporateCard
Creates a new dummy corporate credit card. Supports specifying addresses, accounts, statement preferences, card limits, virtual card relation, auto payment accounts, and permissions. Returns card reference, shadow numbers, masked card number, record ID, warnings, and sensitive card data if applicable.
Headers
evrst-ptrnidCorrelation id for this request. Echo it in your own logs to trace the call through the platform.
createDummyCorporateCard › Request Body
productNumberProduct Number
channelThree-digit channel code (for example "002", not "Internet"). Used for entitlement, limits and the audit trail. See the Channels page (sidebar, or from Get started) for the full code list.
digitalCardFlagDigital Card Flag
customerNumberCustomer Number
nameOnCardName On Card
branchCodeBranch Code
statementPeriodStatement Period
statementCurrencyCodeStatement Currency Code
statementPostFlagStatement Post Flag
statementSmsSendFlagStatement Sms Send Flag
statementEmailSendFlagStatement Email Send Flag
statementSendingAddressTypeStatement Sending Address Type
statementSendAddressIdStatement Send Address Id
cardLimitValueCard Limit Value
customerLimitValueCustomer Limit Value
autoInstallmentCountAuto Installment Count
autoDeferringMonthCountAuto Deferring Month Count
autoLimitIncreaseFlagAuto Limit Increase Flag
autoPaymentFlagAuto Payment Flag
Auto Payment Account
applicationIdApplication Id
applicationDateApplication Date
applicationContractIdApplication Contract Id
createDummyCorporateCard › Responses
Success
cardMasterRecordIdCard Master Record Id
secureCardMasterRecordIdSecure Card Master Record Id
cardRefNumberCard Ref Number
mainCardRefNumberMain Card Ref Number
shadowCardNumberShadow Card Number
Warnings
createCorporateCard
Creates a new corporate credit card. Supports specifying addresses, accounts, statement preferences, card limits, virtual card relation, auto payment accounts, and permissions. Returns card reference, shadow numbers, masked card number, record ID, warnings, and sensitive card data if applicable.
Headers
evrst-ptrnidCorrelation id for this request. Echo it in your own logs to trace the call through the platform.
createCorporateCard › Request Body
productNumberProduct Number
channelThree-digit channel code (for example "002", not "Internet"). Used for entitlement, limits and the audit trail. See the Channels page (sidebar, or from Get started) for the full code list.
digitalCardFlagDigital Card Flag
customerNumberCustomer Number - [Optional]
shadowCardNumberShadow Card Number
nameOnCardName On Card - [Optional]
secondNameOnCardSecond Name On Card - [Optional]
branchCodeBranch Code - [Optional]
cardDeliveryTypeCard Delivery Type - [Optional]
cardSendAddressTypeCard Send Address Type - [Optional]
cardSendAddressIdCard Send Address Id - [Optional]
cardDeliveryBranchCodeCard Delivery Branch Code - [Optional]
enrollMasterpassEnroll Masterpass - [Optional]
Permissions - [Optional]
List Of Account - [Optional]
contractTypeContract Type - [Optional]
contractVersionNumberContract Version Number - [Optional]
cardLimitValueCard Limit Value - [Optional]
authorizationSmsSendFlagAuthorization Sms Send Flag - [Optional]
authorizationSmsSendMinimumAmountAuthorization Sms Send Minimum Amount - [Optional]
applicationChannelApplication Channel - [Optional]
applicationIdApplication Id - [Optional]
applicationDateApplication Date - [Optional]
applicationContractIdApplication Contract Id - [Optional]
createCorporateCard › Responses
Success
recordIdRecord Id
maskedCardNumberMasked Card Number - [Optional]
shadowCardNumberShadow Card Number - [Optional]
mainShadowCardNumberMain Shadow Card Number - [Optional]
cardRefNumberCard Ref Number - [Optional]
mainCardRefNumberMain Card Ref Number - [Optional]
Warnings - [Optional]
Sensitive Card Data - [Optional]
createVirtualCard
Creates a virtual credit card for a customer. Supports Masterpass enrollment, end-of-day limit flag, and configurable limits. Returns card reference, shadow card number, masked card number, record ID, warnings, and sensitive card data including PAN, CVV, and expiry date.
Part of:
- Journey 01 · Launching a new card product — step 4, Issue the card
Headers
evrst-ptrnidCorrelation id for this request. Echo it in your own logs to trace the call through the platform.
createVirtualCard › Request Body
channelThree-digit channel code (for example "002", not "Internet"). Used for entitlement, limits and the audit trail. See the Channels page (sidebar, or from Get started) for the full code list.
shadowCardNumberShadow Card Number - [Optional]
limitTypeLimit Type - [Optional]
endOfDayFlagEnd Of Day Flag - [Optional]
limitLimit - [Optional]
enrollMasterpassEnroll Masterpass - [Optional]
createVirtualCard › Responses
Success
recordIdRecord Id
maskedCardNumberMasked Card Number - [Optional]
shadowCardNumberShadow Card Number - [Optional]
cardRefNumberCard Ref Number - [Optional]
relatedCardRefNumberRelated Card Ref Number - [Optional]
mainCardRefNumberMain Card Ref Number - [Optional]
Warnings - [Optional]
Sensitive Card Data - [Optional]
getApplicableProductsByCustomerNumber
Retrieves all credit card products applicable to a customer. Returns both product-level and customer asset-level information, including digital card capabilities, annual fees, and main card details.
Part of:
- Journey 01 · Launching a new card product — step 2, Choose the product
Headers
evrst-ptrnidCorrelation id for this request. Echo it in your own logs to trace the call through the platform.
getApplicableProductsByCustomerNumber › Request Body
channelThree-digit channel code (for example "002", not "Internet"). Used for entitlement, limits and the audit trail. See the Channels page (sidebar, or from Get started) for the full code list.
customerNumberCustomer Number - [Optional]
mainCustomerNumberMain Customer Number - [Optional]
shadowCardNumberShadow Card Number - [Optional]
Filter - [Optional]
getApplicableProductsByCustomerNumber › Responses
Success
List Of Product - [Optional]
List Of Asset - [Optional]
getApplicableProductsByMainCustomerPreControl
Checks applicable credit card products for a main customer before control. Returns a success flag indicating whether the pre-control check passed.
Headers
evrst-ptrnidCorrelation id for this request. Echo it in your own logs to trace the call through the platform.
getApplicableProductsByMainCustomerPreControl › Request Body
channelThree-digit channel code (for example "002", not "Internet"). Used for entitlement, limits and the audit trail. See the Channels page (sidebar, or from Get started) for the full code list.
mainCustomerNumberMain Customer Number - [Optional]
Filter - [Optional]
getApplicableProductsByMainCustomerPreControl › Responses
Success
isSuccessIs Success
createNoNameCard
Creates a no-name credit card for a customer. Supports both digital and physical products, with configurable limits, permissions, accounts, and optional Masterpass enrollment. Returns card reference, shadow card number, masked card number, record ID, warnings, and sensitive card data if applicable.
Headers
evrst-ptrnidCorrelation id for this request. Echo it in your own logs to trace the call through the platform.
createNoNameCard › Request Body
productNumberProduct Number
barcodeBarcode - [Optional]
channelThree-digit channel code (for example "002", not "Internet"). Used for entitlement, limits and the audit trail. See the Channels page (sidebar, or from Get started) for the full code list.
customerNumberCustomer Number - [Optional]
mainCustomerNumberMain Customer Number - [Optional]
mainCardRefNumberMain Card Ref Number - [Optional]
branchCodeBranch Code - [Optional]
cardSendAddressTypeCard Send Address Type - [Optional]
enrollMasterpassEnroll Masterpass - [Optional]
Permissions - [Optional]
List Of Account - [Optional]
contractTypeContract Type - [Optional]
statementPeriodStatement Period - [Optional]
statementCurrencyCodeStatement Currency Code - [Optional]
cardLimitValueCard Limit Value - [Optional]
customerLimitValueCustomer Limit Value - [Optional]
autoLimitIncreaseFlagAuto Limit Increase Flag - [Optional]
applicationChannelApplication Channel - [Optional]
applicationIdApplication Id - [Optional]
applicationDateApplication Date - [Optional]
applicationContractIdApplication Contract Id - [Optional]
createNoNameCard › Responses
Success
recordIdRecord Id
maskedCardNumberMasked Card Number - [Optional]
shadowCardNumberShadow Card Number - [Optional]
cardRefNumberCard Ref Number - [Optional]
mainCardRefNumberMain Card Ref Number - [Optional]
Warnings - [Optional]
Sensitive Card Data - [Optional]
cancelCardEmbossByShadowCardNumber
Cancels the embossing process of a credit card using the shadow card number. Validates input before calling the issuing service proxy. Logs the operation start, failure, and completion.
Headers
evrst-ptrnidCorrelation id for this request. Echo it in your own logs to trace the call through the platform.
cancelCardEmbossByShadowCardNumber › Request Body
shadowCardNumberShadow Card Number
channelThree-digit channel code (for example "002", not "Internet"). Used for entitlement, limits and the audit trail. See the Channels page (sidebar, or from Get started) for the full code list.
cancelCardEmbossByShadowCardNumber › Responses
Success
getPendingCardEmbossList
Retrieves the pending card embossing details for a given ShadowCardNumber. Returns information including card sequence number, emboss date, application date, emboss reason codes and descriptions, emboss status, masked card number, product type code and description, and validity flag. Validates the request to ensure ShadowCardNumber is not null or empty. Logs execution status and errors if the emboss retrieval fails.
Headers
evrst-ptrnidCorrelation id for this request. Echo it in your own logs to trace the call through the platform.
getPendingCardEmbossList › Responses
Success
cardSeqNumberCard Seq Number - [Optional]
embossDateEmboss Date - [Optional]
applicationDateApplication Date - [Optional]
embossReasonCodeEmboss Reason Code - [Optional]
embossReasonDescriptionEmboss Reason Description - [Optional]
embossReasonSubCodeEmboss Reason Sub Code - [Optional]
embossReasonSubDescEmboss Reason Sub Desc - [Optional]
embossStatusEmboss Status - [Optional]
maskedCardNumberMasked Card Number - [Optional]
productTypeCodeProduct Type Code - [Optional]
productTypeDescriptionProduct Type Description - [Optional]
shadowCardNumberShadow Card Number - [Optional]
validFlagValid Flag - [Optional]