Branch management
Move a customer or a card between branches, and read the cards a branch holds.
changeCardBranch
Provides methods to change the branch associated with a card or customer. Includes ChangeCardBranch to update a card's branch, ChangeCustomerBranch to update all cards of a customer, and TransferBranchCustomer to transfer multiple customers from one branch to another. Validates requests and returns success status, old/new branch codes, changed card count, and affected shadow card numbers.
Headers
evrst-ptrnidCorrelation id for this request. Echo it in your own logs to trace the call through the platform.
changeCardBranch › 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.
targetBranchCodeThe branch to move the card or customer to.
changeCardBranch › Responses
Success
isSuccessWhether 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.
oldBranchThe branch before the move.
newBranchThe branch after it.
changeCustomerBranch
Changes the branch assignment of a customer or their cards. Provides methods to change a single card's branch, change all cards for a customer, or transfer multiple customers from one branch to another. Validates input and returns details including old and new branch codes and affected card counts.
Headers
evrst-ptrnidCorrelation id for this request. Echo it in your own logs to trace the call through the platform.
changeCustomerBranch › 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.
targetBranchCodeThe branch to move the card or customer to.
changeCustomerBranch › Responses
Success
oldBranchThe branch before the move.
newBranchThe branch after it.
changedCardCountHow many cards the operation changed.
listOfShadowCardNumbersThe cards the operation acted on.
transferBranchCustomer
Transfers the customer to a new branch, including associated card details, and returns information about the transfer process.
Headers
evrst-ptrnidCorrelation id for this request. Echo it in your own logs to trace the call through the platform.
transferBranchCustomer › 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.
currentBranchCodeThe 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.
targetBranchCodeThe branch the customers are moved to.
listOfPersonIdWhich customers to move. Checked for presence, not for contents.
transferBranchCustomer › Responses
Success
oldBranchThe branch before the move.
newBranchThe branch after it.
changedCardCountHow many cards the operation changed.
listOfShadowCardNumbersThe cards the operation acted on.
getCreditCustomerListOfBranch
Retrieves the list of credit customers associated with a given branch using BranchCode and channel. Validates request parameters, calls the lifecycle service to fetch customer identifiers, and returns a list of customer OIDs for the specified branch.
Headers
evrst-ptrnidCorrelation id for this request. Echo it in your own logs to trace the call through the platform.
getCreditCustomerListOfBranch › 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.
branchCodeRequired 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.
getCreditCustomerListOfBranch › Responses
Success
customerOid