Set and manage index rates

An index rate is a benchmark rate, such as a prime rate or another published reference rate, that some loans' interest is based on. On a loan whose interest is set as a spread (a margin added to an index), Peach adds the loan's own rate to the index rate to get the loan's interest rate, before any promotional rate or rate cap applies. Use the Manage index rates and Add index rate screens in the Admin Portal to define these rates for each loan type and change them over time.

• Portal: Admin Portal

• Admin Portal layout: The Admin Portal has two layouts. The legacy layout has an Admin options menu in the header at the top of the page. The updated layout has no Admin options menu; you reach index rates from your name at the bottom of the sidebar. Both layouts have a card in the side navigation for switching: Try it now moves you to the updated layout, and Go back returns you to the legacy layout. New browsers start in the legacy layout. Both layouts show the same two index-rate screens, with the same fields and rules; only the way you reach them differs. Switching layouts takes you to Teams, not back to index rates.

• Role: In the updated layout, the menu entry requires the admin role or the peach-support role. In the legacy layout, the menu entry checks permissions instead of a role (see Permissions below).

• Permissions: To view rates you need admin.portal:read, indexrates:read and indexrates:list. To change rates you also need the permission for that action: indexrates:create to add (+ Add index rate and Add), indexrates:update to edit (Update index rate), or indexrates:delete to delete (the delete icon). If you're missing the permission for a button, the button is greyed out, not hidden.

• Why you might reach the screen but not be able to use it: The menu entry that opens index rates doesn't check all of these permissions. In the legacy layout, the Admin options entry checks indexrates:list, indexrates:read and indexrates:update, and is greyed out and doesn't respond if you're missing any one of them. In the updated layout, the entry checks your role, not your permissions, and doesn't appear at all unless you have the admin or peach-support role. Opening the screen's web address directly needs only admin.portal:read. Neither entry checks indexrates:create or indexrates:delete, and the updated entry checks no index-rate permission at all. So you can reach the screen and still find buttons greyed out or the rate list not loading. Whatever the portal shows, Peach checks your permissions on the server for every action.

• Feature flags: None. Which layout you see is saved in your browser, not set by a feature flag, so it can differ between browsers and devices.

• Status: Available in both Admin Portal layouts, with no feature flag.

• Index rates enter the interest calculation only on loans whose interest rate is set as a spread. The interest type is stored on each loan's own interest rate, not on the loan type. The portal lets you attach an index rate to any loan type. A replay after a change still covers every active loan on the loan type, whatever its interest type; see the warning below.

• Adding a rate rewrites another rate's end date. When a loan type already has rates, Peach changes the end date of the rate with the latest start date to one day before your new rate starts. If your new rate overlaps that rate, Peach won't add it.

• A rate's start date is fixed once the rate exists. You can change the rate value, the description, and the end date afterwards, but not the start date.

Index rates are not in the main sidebar. In the updated Admin Portal layout, select your name (with your initials beside it) at the bottom of the sidebar, then select Manage Index Rates. (In the legacy layout, select Admin options in the header, where it sits in the left group after the company logo and, if you have access to more than one company, the Current Company selector, then Manage index rates.)

The Manage index rates screen opens. It is where you view, edit, and start adding rates; the legacy Admin options menu has no separate entry for the Add screen.

Select a loan type from Applicable to. Until you do, the Rates section reads Select a loan type to view index rates. A loan type with no rates yet reads No index rates have been defined for this loan type.

Each row shows the rate's ID, its date range, and its rate as a percentage. A rate with no end date shows End of loan instead. A description, where one was entered, appears as a tooltip beside the percentage. Rows run earliest start date first, and deleted rates are not listed.

The Add index rate screen opens. Back to manage index rates is the only way back — this screen has no Cancel.

Select the loan type in Applicable to, then enter the rate in Annual rate as a percentage — enter 12.5 for 12.5%. Set Start date; it defaults to today and resets to today each time you change the loan type. Country is required. External ID and Index description are optional.

End date appears only when the loan type already has at least one rate. When you add the first rate on a loan type, the section is absent from the form entirely and the rate is created with no end date. From the second rate onward, choose End of loan or pick a date later than the start date; changing the start date clears an end date that is no longer later than it.

Index rate added successfully confirms the rate was created.

On Manage index rates, select the loan type, then select the rate's row. Its current values load into New rate, Index description, and End date.

These are the only three values you can change here. The loan type, start date, country, and external ID cannot be changed here. An end date earlier than the rate's start date shows End date cannot be before start date.

You can't change a rate with a set end date back to End of loan from this screen. Selecting End of loan appears to work, but the rate keeps its end date.

Index rate updated successfully confirms the change. Cancel does more than undo your edits. It resets the whole screen: the loan type, the selected rate, any message and every field are cleared, and you start from the beginning.

Select the delete icon on the rate's row. Peach asks Delete index rate — Are you sure you want to delete this index rate?

Index rate deleted successfully confirms it. The rate disappears from the list.

The two screens do not share a form. External ID, Country, and Start date exist only when adding, and the rate value is labelled Annual rate when adding and New rate when editing, so each screen's editable fields are listed separately.

Editable fields — Add index rate:

Editable fields — Manage index rates:

On a freshly opened screen, Update index rate becomes available as soon as you select a rate, before you change any field.

The button is greyed out while New rate is empty and no date is filled in under End date. That check reads the date itself, not whether End of loan is selected. A rate that loads with an end date keeps that date when you select End of loan, so the button stays available even with New rate empty.

A validation error from an earlier edit is not cleared when you select another rate or select Cancel. For example, if you empty New rate on a rate that has no end date and then select a different rate, the button stays greyed out even though New rate now shows a value. The error is checked again, and the button can become available, the next time you edit New rate, Index description or End date.

Read-only fields — each row of the Rates list:

The rate is stored against the loan type and appears in its Rates list. If the loan type already had rates, Peach sets the end date of the rate with the latest start date to the day before yours begins. That is not always the rate just before yours. Peach also accepts a rate dated before the latest one when your rate ends before the latest one starts and the latest one either has no end date or has an end date earlier than your rate's start date (which happens only when that end date is already earlier than its own start date). In that case the latest rate is given an end date earlier than its own start date.

If the rate's start date is today or earlier, adding, editing or deleting it replays every active loan on the loan type. A deleted rate leaves the list and no other rate changes.

• Loan type configurations — Find the loan types you can choose in Applicable to and view each one's configuration.

• Admin Portal overview — Find the rest of the Admin Portal screens and how the two layouts work.
• Index Rates API — The endpoint contract for these five operations, including the fields this screen does not expose.