Payoff
The Payoff Property Class can be included in Products, where the user wants to generate payoff statement at the arrangement level. The payoff statement includes the details such as Principal, Interest, and Charges that are due as a result of the payoff.
The payoff calculation produces a record with the itemized calculated amounts. It is possible to adjust the system calculated amounts and show them along with the original calculated amounts in payoff statement.
Periodic Attribute Classes are used to display error or override in case of under or over payments.
Product Lines
The following Product Lines use the Payoff Property Class:
- Accounts
- Facility
- Lending
- Safe Deposit Box
Property Class type
The Payoff Property Class uses the following Property Class types:
- Dated
- Enabled For Memo
- Tracking
Property Type
Payoff Property Class is not associated with any Property Type.
Balance Prefix and Suffix
Payoff Property Class is not associated with the balance prefix and suffix.

The attributes of the Payoff Product Condition are explained below.

It allows the user to define the expiry date for the payoff bill. The number of days defined are considered as working days and expiry date for the payoff bill can be calculated by adding Payoff date and the number of working days defined in this attribute. When the expiry date is reached, the system invalidates (deletes) the payoff bill.

It allows the user to specify if the amount made due to the customer between the simulation start date and payoff effective date should be considered settled or not.
Setting this attribute to YES enables the auto settlement of future dues. Setting it as NULL or NO does not allow to settle the due amounts automatically.

It allows the user to define the tolerance value defined as a percentage of the total payoff amount.

It allows the user to define a currency specific absolute tolerance amount.

It allows the user to define the currency code for currency specific tolerance amounts.

It allows the user to define the Action that should happen with any shortfall within tolerance.
The available value is:
WRITE.OFF – The amount will be written off according to the accounting rules defined by the bank.
- Overrides are generated if the payoff amount less than repay amount.
- When payoff amount is within the tolerance amount, the override ’AA-PAY.WITHIN.TOL’ is generated indicating payment amount, payoff amount and the tolerance used.
- An error is generated when the payoff amount is greater than the tolerance amount.
If the attribute is left blank, the short balances remains on the loan for the bank to deal with manually. If the shortage is on an interest bearing balance (for example, principal), it can continue to accrue interest.

It allows the user to define the settlement Activity to be automatically invoked while calculating payoff amount in simulation mode or when the arrangement is paid off in live using SETTLE Activity of Payoff Property Class.
This allocation Activity is used to settle the payoff bill. This Activity will be run against the Payoff Activity to calculate the pre-payment penalty charges. Any prepayment charges needs to be attached to this Activity.
When there are existing dues apart from current dues, the system looks for settlement definitions under Payment Rules Product condition.

It allows the user to define the settlement Activity to be automatically invoked when due amounts between simulation start date and Payoff effective date are to be considered as settled.
When the arrangement has unallocated credit balance during a payoff request, this UNC balance is reduced to arrive at the payoff amount automatically

Payoff Bill is generated through either AA.SIMULATION.CAPTURE application.
Following are the steps involved in creating a Payoff Bill using Simulation Capture:
- The user has to input Simulation Capture for an arrangement with Activity set to LENDING-CALCULATE-PAYOFF.
- The Effective Date field indicates whether Payoff date is forward or today.
- On authorising the Simulation Capture, the system triggers the LENDING-ISSUE-PAYOFF Activity and creates a record in AA.SIMULATION.RUNNER. Simulation runner contains the list of Activities to be triggered from today to Payoff.
- After authorising the Simulation Capture and running the AA.SIMULATION.SERVICE service, the system updates the $SIM files.
- When the user commit and authorise the simulation runner with the Execute Simulation field set to Yes and running the AA.SIMULATION.SERVICE service, the system writes the Payoff Bill in live files.
- When payoff is forward dated (Simulation capture date: 4th Dec and Payoff Date: 14th Dec), the system can be set up either to consider the interim bills are settled or outstanding ( any scheduled payments between the capture date and Payoff date).
- During Payoff, if the Expiry Days field is left blank and if the settlement does not happen on 14th Dec, the system invalidates the payoff bill on the same day close of business.

- Payoffs can be requested at any point during the life of the loan and the effective date can be either equal to the system date or forward dated.
- The payoff statements are for only information so the customer is not expected to make the payment on the payoff effective date. It is just another simulation Activity like Loan modelling.
- LENDING-CALCULATE-PAYOFF Activity can only be run in simulation mode and cannot be triggered by the user or scheduled. The Activity should use the CALCULATE Action to determine the payoff amounts. The action routine calculates the total outstanding amount of the loan contract as on the payoff date including all overdue amounts and current amounts.
- SIMULATION.RUNNER is used to simulate LENDING-CALCULATE-PAYOFF Activity with the simulation end date as the required payoff and the Payoff Activity need to be captured with the Activity date as the required payoff date.
- Prepayment charges can be set as a periodic rule or Activity charge. Usually, banks allow prepayments up to a certain limit, which can be a percentage of the loan amount or a fixed amount for a rolling period like anniversary period (in a year, the customer is allowed to prepay a percentage of the loan and is usually cumulative).
- To define this in AA, a periodic rule can be setup in Payment Rules Property to calculate the prepayment charges when excess prepayments are done, or the prepayment charges may simply be a fixed amount, which can be setup as Activity Charges on prepayment Activity.
- Consider that payoff is forward dated (Simulation capture date: 4th Dec and Payoff Date: 14th Dec), and there is a scheduled payment on 10th Dec. If the Settle Dues attribute is set to Yes, the system triggers the repayment Activity automatically.

Consider an arrangement with no overdue, and the Expiry Days attribute is set as 1. For the arrangement, the payoff bill gets invalidated after one working day. For example, the payoff date is 29th Dec and expiry date is 1st Jan (assume after 29th Dec next working day is 1st Jan). Then the system updates per diem for 30th Dec, 31st Dec and 1st Jan in payoff bill.

- The user can generate the payoff bill online as well. For example, a payoff bill generated by the system was used in the previous case.
- The user can change the Property amounts using the LENDING-ADJUST.INFO.BILL-BALANCE.MAINTENANCE Activity so that the payoff bill is updated with the adjusted amounts.
- The user can trigger the LENDING-ISSUE-PAYOFF Activity manually so that delivery messages can be triggered with new payoff bill details.
Add Payoff Property to Existing Arrangements
The financial institutions can add the Payoff property to the existing arrangements of the Accounts, Lending, and Multi-Currency Accounts product lines using the Add New Property, New Prop Avl, and New Prop Avl Date fields in AA.PRODUCT.MANAGER.
Though the Payoff Property is mandatory for the Accounts products in the latest system releases, the Payoff Property is enabled in Add New Property feature to be added to the existing arrangements to support the upgrade from older release to latest release.
Read Add New Property for more information on the configuration.
Periodic Attribute Classes
The Payoff Property Class is associated with the following Periodic Attribute Classes:
Periodic Attribute Class | Description |
---|---|
PAYOFF.NEG.DIFF | During payoff bill settlement, when the repayment amount is greater than the payoff bill amount, this Periodic Attribute Class can be used such that the system generates an error message. When the settlement is made against the payoff bill payment allocation is made based on the apply payment activity. |
PAYOFF.POS.DIFF | During payoff bill settlement, when the repayment amount is less than the payoff bill amount, this Periodic Attribute Class can be used such that the system generates override messages. |
Actions
Individual AA.PROPERTY.CLASS.ACTION records control which Product Line it’s associated.The Payoff Property Class performs the following Actions:
Action Name | Description |
---|---|
APPLY.PAY | When the settlement is made against the payoff bill payment allocation is made based on the apply payment activity. |
CALCULATE | This action routines builds payoff bill details record with the following details: Current Balances to be Settled Overdue Balances Due Balances Per Diem Interest Charges (if any) The system writes the Payoff Bill in $SIM files. |
CALCULATE.ALL | The alculation to produce a record with the itemised calculated amounts. It is possible to adjust the system calculated amounts and possible to show the adjusted amounts along with the original calculated amounts in payoff statement. |
CANCEL | This action routine deletes the Payoff Bill reference from AA.BILL.DETAILS and AA.ACCOUNT.DETAILS. This can be triggered as a scheduled Activity or user-defined Activity. |
CLOSURE.VALIDATE | Payoff bill validated on the same day close of business when the Payoff effective date is not defined. |
ISSUE | This action routine reads the payoff bill from $SIM file and writes it in live file. |
SETTLE | This action routine is triggered when the customer makes payments against the payoff bill. |
SETTLE.ALL | To settle all child action as well for the Payoff. |
SETTLE.BILL | To settle the bills to complete the Payoff. |
UPDATE | This action routine is triggered when the user amends the payoff designer using update Activity. |
Accounting Events
The Payoff Property Class does not perform any Actions that generate Accounting events.
Limits Interaction
The Payoff Property Class does not perform any Actions that impact on the limits system.
In this topic