Account linking
Attach and detach the accounts a card draws on, and read back what a card is currently linked to.
attachCardAccount
Provides methods to attach, deattach, and list card accounts for a customer. Includes operations for attaching an account to a card, removing it, recreating multiple accounts, and listing accounts by shadow card number or account number.
Headers
evrst-ptrnidCorrelation id for this request. Echo it in your own logs to trace the call through the platform.
attachCardAccount › 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.
accountNumberThe account being linked to the card. It must exist, belong to the card's customer, and be neither shared nor a foreign-currency account — each is its own refusal.
fecCodeThe foreign-currency code of the account, where the card draws on one.
accountBranchIdThe branch that holds the account, as core banking numbers it.
accountTypeValues:
A— main accountV— virement
accountSuffixThe suffix that distinguishes one account from another under the same number at core banking.
shadowCardNumberRequired in practice — The card the operation acts on. Not validated as a field — a request that names no card, or names one that does not exist, is refused as a business failure with no card found rather than as a missing field.
accountAliasA name for the account, shown to the cardholder where the account is listed. The platform stores it and does not interpret it.
ibanThe account's IBAN, stored alongside the account number.
accountOrderFlagNot read when sent. Attaching an account has the line commented out, and card creation writes false whatever is sent. The account listings return the stored value.
attachCardAccount › Responses
Success
recordIdThe identifier of the row the operation created or acted on. Returned rather than sent in most operations that carry it.
detachCardAccount
Detach Card Account
Headers
evrst-ptrnidCorrelation id for this request. Echo it in your own logs to trace the call through the platform.
detachCardAccount › 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.
recordIdThe card-to-account link being removed, by its record id — not the account number. A sibling operation detaches by account number instead, and it is a different request.
shadowCardNumberThe card the account is unlinked from.
detachCardAccount › Responses
Success
recordIdThe identifier of the row the operation created or acted on. Returned rather than sent in most operations that carry it.
detachCardAccountByAccountNumber
Detach Card Account By Account Number
Headers
evrst-ptrnidCorrelation id for this request. Echo it in your own logs to trace the call through the platform.
detachCardAccountByAccountNumber › 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.
accountNumberThe account at the bank's core banking system that the card draws on. It must already exist, belong to the card's customer, and be neither shared nor a foreign-currency account.
accountSuffixThe suffix that distinguishes one account from another under the same number at core banking.
detachCardAccountByAccountNumber › Responses
listCardAccountByAccountNumber
Retrieves a list of card accounts associated with a given account number. Uses the lifecycle service proxy to fetch all accounts and maps them to CardAccount objects including details such as account alias, branch, suffix, type, IBAN, currency, validity, and audit information.
Headers
evrst-ptrnidCorrelation id for this request. Echo it in your own logs to trace the call through the platform.
listCardAccountByAccountNumber › 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.
accountNumberThe account at the bank's core banking system that the card draws on. It must already exist, belong to the card's customer, and be neither shared nor a foreign-currency account.
listCardAccountByAccountNumber › Responses
Success
The accounts to attach to the card as it is created. Each entry carries the account's own identifiers; attaching one later is attachCardAccount.
listCardAccountByShadowCardNumber
Retrieves a list of card accounts associated with a given shadow card number. The method uses the lifecycle service proxy to fetch accounts and maps them to CardAccount objects, including details such as account alias, branch, suffix, type, IBAN, currency, validity, and audit information (insert/update user, token, and date).
Headers
evrst-ptrnidCorrelation id for this request. Echo it in your own logs to trace the call through the platform.
listCardAccountByShadowCardNumber › 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.
listCardAccountByShadowCardNumber › Responses
Success
The accounts to attach to the card as it is created. Each entry carries the account's own identifiers; attaching one later is attachCardAccount.
recreateCustomerCardAccount
Recreates all card accounts for a customer's credit card. Accepts a list of card account details (account number, suffix, type, alias, branch, FEC code, IBAN, record ID, and currency code) and sets their ValidFlag to true. The service replaces existing accounts for the given ShadowCardNumber with the provided list through the lifecycle service.
Headers
evrst-ptrnidCorrelation id for this request. Echo it in your own logs to trace the call through the platform.
recreateCustomerCardAccount › 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.
The accounts to attach to the card as it is created. Each entry carries the account's own identifiers; attaching one later is attachCardAccount.
recreateCustomerCardAccount › Responses
Success