Add or Remove Account Holders
Banks allow multiple account holders (for example, joint holders) to be recorded on accounts and also allow these account holders to be modified during the life of the account. This section describes how the bank can modify the involved account holders of an existing account.
-
Update the customer details of the account such as add or remove the joint customers, tax liability percentange, limit liability percentage of the joint customers
-
Update the customer details of the account such as add or remove the joint customers, tax liability percentange, limit liability percentage of the joint customers
Posting Restriction
Banks employ posting restrictions to regulate transactions in accounts. Posting restrictions are transaction-based rules that prevent transactions from being posted to an account for the purpose of operational control. A typical business case in which a bank uses a posting restrictions to regulate credits into an account is for non-resident accounts, where there may be restrictions on depositing local currency amounts into the account.
-
Update the account details to block or unblock the account by setting the posting restriction and to change the nick name of the account
-
Update the account details to block or unblock the account by setting the posting restriction and to change the nick name of the account
Payment Schedule
A payment schedule is the agreed-upon timeline and frequency for making payments on a loan or credit account. The payment schedule specifies when the payments are due, the amount due, and the total number of payments required to pay off the account.
-
Update the payment schedule condition such as payment method from capitalise to pay, payment frequency from monthly to quarterly etc., on an account
-
Retrieves the payment schedule of an arrangement account
Statement Frequency
Banks generate account statements to notify the customers about the account's activity at defined intervals.
-
Update the statement frequency of an account.
-
Retrieves the statement frequency of an account
Renegotitaion
This service helps you to modify the terms and conditions of the account. You can enable a variety of account maintenance activities, both financial and non-financial. Some of the key maintenance activities are maintenance of account titles, restrictions on account, credit and debit interest information and revisions of settlement account.
-
Perform the renegotiation of the account contract details such as payment frequency, payment start date, interest rate, statement frequency and settlement details, etc.
Manage Interest
Banks can pay an interest to the customers on credit balances held in their accounts. Credit interest or debit interest can be changed in the account at any time during the entire life cycle of the account.
Update Interest
PUTUpdate the interest conditions of the account such as interest rate, tier details, margin amount etc.
-
Retrieves the interest details of an account such as interest rate , interest type and interest amount
-
Retrieve the past period's interest accruals
-
Retrieves the interest accrued for the current period of an account
-
Retrieves the interest accruals of the previous year
Account Facilities
Facilities for an account control the list of available services or facilities for the arrangement account. For example, if an account has the facility of overdraft, passbook, cheque, and so on can be found using the facility property.
-
Update the service availability for an account like block or unblock of cheque,card,sweep etc.,
-
Retrieves the service availability for an account like block or unblock of cheque,card,sweep etc.,
Manage Cheques and Cards
Below are the service operations and their respective APIs involved in requesting a card.
Card Issue
POSTCreate card issue request with details such as card status, issue date, pin issue date and charges
Update Card
PUTUpdate card issue request with card status, issue date, pin issue date, cancellation date & reason
Remove Issue Card
DELETEDelete or revoke the card issue request for an account
Cheque Issue
POSTIssue a new cheque
-
Update issued cheque details
Remove Cheque Book
DELETEDelete the issued cheque
Manage Alerts
This service helps you to subscribe or unsubscribe to alerts for events and Digital Account Officer (DAO).
-
Initiate an alert request or external subscription.
-
Initiate an alert request or external subscription.
-
Update alert subscription details
-
Retrieves subscribed alerts details
-
Retrieves eligible alerts for the account
-
Retrieves the details of active alerts for a given account number
Account Settlement
Account settlement information outlines the details of how an account balance is paid or settled, either by the account holder or by a third party. This information can include the amount of the payment, payment method, payment date, and any associated fees or charges.
-
Update the settlement conditions of the account such as payin account, payin percentage, payin amount, payout account, payout percentage, payout amount, etc
-
Retrieves the settlement details for the given arrangement such as payment type, payin account, payin percentage, payin amount, payout account, payout percentage, payout amount, etc
Manage Limits
Limit information highlights the specific restrictions or caps imposed on certain account activities or transactions. Common types of limits that may be placed on accounts are transaction limits, withdrawal limits, transfer limits, and spending limits.
-
Update the limit conditions of the account with the secondary limit amount and other limit details
-
Retrieves the currency, balances, limit details and arrangement details of the account
Account Dormancy
Account dormancy is a period of inactivity on a financial account, such as a bank account or credit card account, during which no transactions or other account activity occurs. The length of time that an account can remain dormant before it is considered inactive or dormant varies depending on the financial institution and the type of account. Typically, an account is considered dormant if no customer-initiated transactions, such as deposits or withdrawals have occurred for a specified length of time, which can range from six months to two years.
Reset Dormancy
PUTReset the dormant account to active status manually
Update Dormancy
PUTDeactivates the savings account and moves it to given dormancy status.
-
Retrieves the dormancy setup details for the account such as dormancy period, status etc
Stop Payment
Stop payment is a service that allows a customer to stop payment on a check that they have made, typically if the check has been lost, stolen, or if there is an issue with the payment.
-
Initiate a stop cheque request for an account
-
Update an existing stop cheque request for an account
-
Retrieves the list of Payment Stop requests details such Cheque nos, Amount range, Beneficiary, Period and Charge details available for a specific account
-
Retrieves the list of Payment Stop requests available in the system with details such as Account Reference, Cheque nos, Amount range, Beneficiary, Period and Charge details
Change Product
Changing product is the process of switching from one type of account product to another within a same product group offered by the bank or financial institution that may involve additional fees and charges.
Change Product
PUTChange account from one product to another such as changing savings account to current account
-
Update the action such as proof and publish for the specific product
Change Branch
You can transfer an existing account from one branch of a bank or financial institution to another. This service requires the account holders to provide the required information such as their account number, personal identification, and the new branch location.
Change Branch
PUTUpdates the branch of an account
Change Channel
You can update the sourcing channel for the existing customer accounts. Sourcing channel can be prominent information for reporting. The available channels are OLB, and MB.
Change Channel
PUTUpdates the channel of the account
Change Line of Business
In the organization hierarchy, the line of business is defined to distinctly define different cost centers for bank, and align them later to a particular branch depending on its construct and requirement. This endpoint is used to update the line of business.
-
Updates the type of line of business of the account
Notice Withdrawal Conditions
Notice withdrawal is a feature that may be offered on certain types of accounts, such as savings accounts. With notice withdrawal, the account holder must provide advance notice to the financial institution before withdrawing funds from the account. The notice period may vary depending on the account terms and the financial institution's policies
Create a Notice
PUTNotifies the withdrawal of amount from account by providing the withdrawal date and amount etc. This is applicable only for notice type of accounts.
Update Notice
PUTUpdates the notice of withdrawal of amount from account by providing the withdrawal date, bill reference and amount etc. This is applicable only for notice type of accounts.
Cancel Notice
PUTCancels the notification of withdrawal of amount from account.
-
Retrieves the details of notice bills
Migration
Migration of accounts involves the process of updating and transitioning the account from an older or existing account. Below are the service operations and their APIs involved in the process.
Migrate Accounts
POSTMigration of a legacy system account contract to the given account product by providing the original contract date, account name, statement, payment frequency and start date, etc.
Migrate Bills
PUTCaptures the bill information of the account such as bill id, property names, bill amount etc. This is used to migrate the bills of a legacy contract which is migrated from other system & update the bill details
Migrate Balances
PUTCaptures the balance details of the account such as balance type, due amount etc. This is used to migrate the balances of a legacy contract which is migrated from other system & update the balance details
Account Closure
Customers usually initiate account closures. However, banks may also initiate account closure activities for example, when an account is inactive or has a zero, negative, or below a threshold balance for a period of time.
-
Perform the settlement of payoff amount for the savings account by providing the transaction amount, currency and also settlement instructions
Close Account
PUTPerform the closure of the savings account after settlement of payoff amount. The account moves to closed status based on the closure conditions defined in the system
-
Calculate the payoff amount for the current account which includes the outstanding amounts and also amounts such as account balances, interest, and charge amounts
-
Approves account closure information to allow closing of an account which is no longer in use
-
Retrieves the account closure information of the account such as closure date and reason, mode of closure, balances on the date of closing and pending charges
-
Retrieves the payoff details of an account
Creating a Bundle
Creating a cash management structure (bundle) has three stages.Draft, Preliminary, Live
-
Allows creation of master / bundle arrangement for summary, currency, transaction and master transaction accounts.
-
Updates the bundle arrangement status from draft to pending live with all the accounts created.
Set GoLive Date
PUTUpdates golive date for the master arrangement. This is the date from which the master arrangement will become effective.
Add Accounts
PUTUpdates new accounts to the preliminary or modify the existing accounts from the preliminary structure.
Creating Internal FX
You can define an intra-cash pool transaction between transaction Accounts that are in different currencies without affecting the currency top accounts balances using the exchange rates set as Internal FX. In AA, a new product is created under the “Relationship Pricing” product line called, Internal FX. Under this product, the user can define the exchange rates for each currency pair that is used when the system performs intra-cash pool transactions. Internal FX will allow the corporate customer to perform cross-currency movements without affecting the bank’s currency positions.
Creating Internal FX
POSTInternal foreign exchange allows the corporate customer to perform cross-currency movements without affecting the bank currency positions.
Account Sweep
Account Sweeps are a movement of funds from one virtual account to another targeting to maintain the defined minimum or maximum amount of account balances. With this functionality, you can set up balance sweeps among virtual accounts that are part of the same structure and currency. You can also perform sweeps among accounts in a cash pool group.
Define Sweep Type
POSTCreates sweep type for virtual accounts.
Amend Sweep
PUTAmend existing sweep setup for example the sequence , minimum and maximum amount
-
Creates the basic details of a group for a sweep. A group is a collection of accounts that are linked for cash pooling purposes
Create a Sweep
POSTCreates sweep with rules which will be checked against to see if a transfer of funds needs to be made from one account to another.
-
Amends the basic details of a group for a sweep. A group is a collection of accounts that are linked for cash pooling purposes.
-
Creates intra-day sweep for virtual accounts. This is used to run the cash pooling on-line if the group permits.
Update Settlement Instructions
You can define the settlement process of the defined interest conditions between the bank and the customer. The settlement instruction includes credit and debit interest, settlement accounts, settlement mode, and so on for pay-in and pay-out activities.
-
Updates settlement instructions on summary accounts
-
Updates settlement instructions on trading account
Manage Interest
You can define the fixed and floating interest rates for credit balance, debit balance, and penalty charges for summary accounts and currency summary accounts. The interest conditions defined for the summary accounts are inherited from their underlying virtual accounts.
-
Allows to update credit interest condition for a summary account
-
Updates the penalty interest conditions on summary accounts
-
Update credit interest condition for a summary account
Manage Payment Schedule
You can define the conditions for the schedule and frequency of pay-in and pay-out transactions when the structure is in the live stage. You can also define the schedule for individual summary accounts within the structure (provided they are in the live stage).
-
Updates payment schedule on a bundle in live structure.
-
Updates payment schedule on summary account
Block or Unblock Accounts
You can temporarily deactivate either an entire structure or individual virtual accounts, thereby preventing both the structure and its associated virtual accounts from conducting transactions during that specific period.
Block Structure
POSTCreate Customer Mass Block for a specific Cash Pool Arrangement Structure over a specified period
-
Create Block on Currency Summary Accounts
-
Unblocks a particular virtual account and transactions can be initiated post the defined blocked end date.
-
Unblocks a particular summary account and transactions can be initiated post the defined blocked end date.
Update Internal FX
You can choose to set an Internal FX rate for each customer, and these rates can be applied across different structures for the same customer within the bank.
-
Updates forex pricing to master account
-
Retrieve the internal forex details of a bundle
Secondary Limit
You can set secondary limits for an account that has one or more child accounts. A primary limit is the minimum and maximum limit of a parent account (for example, a summary account or currency summary account) whereas a secondary limit indicates the minimum and maximum limit of the virtual accounts under the parent account. For instance, if a summary account with two transaction accounts has a primary limit of 10000 EUR, you can set the secondary limit for each transaction account at 5000 EUR.
-
Updates the secondary limit for summary accounts. This helps in monitoring the availability and utilisation of limits.
-
Updates the secondary limit for virtual accounts. This helps in monitoring the availability and utilisation of limits.
Closure
You can close the entire structure at any stage, which eventually closes all its underlying virtual accounts.
Bundle Closure
PUTCloses the bundle or cashpool.
Account Closure
PUTStructural changes of virtual accounts in live status - for example, removing one virtual account from a sweep group to another sweep group triggered by the bank user
Bundle Restructure
The bundle is restructured by changing the parent or pool for a particular account provided with the same currency.
Change Pool
PUTStructural changes of virtual accounts in live status - for example, removing one virtual account from a sweep group to another sweep group triggered by the bank user
Change Parent
PUTStructural changes of virtual accounts in live status - for example, removing one virtual account from a sweep group to another sweep group triggered by the bank user
Interest Accruals
Interest accrual is the accumulation of interest on funds that are deposited into an interest-bearing account over a period. It can occur daily, monthly, quarterly, or annually depending on the account terms. The below service operations are used to retrieve the interest accrued for various time frames.
-
Retrieve the accrued interest details of virtual accounts for the current period.
-
Retrieve the interest details of virtual accounts for the previous period.
-
Retrieve the total interest details of virtual accounts.
Sweep
Sweeps are a movement of funds from one virtual account to another targeting to maintain the defined minimum or maximum amount of account balances. You can set up balance sweeps among virtual accounts that are part of the same structure and currency. You can also perform sweeps among accounts in a cash pool group.
-
Retrieve the processed sweeps.
-
Retrieves sweep with rules which will be checked against to see if a transfer of funds needs to be made from one account to another.
-
Retrieves the cashpool group details of the virtual accounts.
Balances
Finances of a cash management structure has the following balance information.
-
Retrieves the balances of Master/Bundle Arrangement
-
Simulated Balances
-
Retrieves the balances of a TR Account
Account Details
Account details include displaying of transaction account summary and the details of the accounts individually under a bundle.
-
Retrieve the arrangement details of a bundle, summary accounts, currency summary accounts and virtual accounts.
-
Retrieves the account details of a Bundle arrangement