The price matrix
One price type can carry more than one price on a price list. Each price can apply to particular facts about the thing being priced — a withdrawal abroad, a credit card — and to a range of amounts. The price matrix is how a price list holds all of them.
What you see
Open a price list. The price sheet shows one line for each price, with the selector values and the band in the line’s name. Each currency has its own column. See price lists.
The line with no selectors and no band is the fallback. It is the price charged when no other row matches.
How a price is chosen
When something is priced, the platform looks at the rows effective on the value date and keeps the ones that match. A row matches when every selector it names has that value, and its band contains the amount.
- The row naming the most facts wins. A band counts as one fact.
- Between rows naming the same number of facts, the latest effective date wins.
- When nothing else matches, the fallback applies.
Worked example, for an ATM fee priced on 15 March:
| Row | Price |
|---|---|
| Fallback | 10.00 |
region abroad |
60.00 |
region abroad, channel atm, from 1 March |
75.00 |
region home, amounts 0 to under 2,000 |
8.00 |
| Priced | Charged | Why |
|---|---|---|
| An ATM withdrawal abroad | 75.00 | Two facts match |
| An online purchase abroad | 60.00 | Only the region matches |
| 500 at home | 8.00 | The region and the band match |
| 2,000 at home | 10.00 | A band excludes its top |
| An ATM withdrawal abroad on 1 February | 60.00 | The two-fact row is not yet effective |
Bands
A band includes its bottom and excludes its top, so 0 to under 1,000 and 1,000 and above never overlap. Leave the top blank for no upper limit. A rate applies to the whole amount, never only to the part above the band’s bottom.
Rates with a minimum and a maximum
A rate row can carry a minimum fee and a maximum fee. The fee is the rate times the amount, lifted to the minimum, held to the maximum, then rounded half up to the currency’s minor unit (ISO 4217). Nothing is charged on an amount of zero, or when the rate is zero.
A rate of 2.00% with a minimum of 10.00 and a maximum of 100.00:
| Amount | Rate times amount | Fee |
|---|---|---|
| 200.00 | 4.00 | 10.00 |
| 2,538.25 | 50.765 | 50.77 |
| 10,000.00 | 200.00 | 100.00 |
Adding and changing a row
- Select Add row.
- Choose the price type and the currency.
- Pick a value for each selector, or leave it as Any.
- Enter the band, if the price depends on the amount.
- Enter the value, and for a rate the minimum and maximum fee.
- Enter the effective date, then select Save.
To change a row that exists, select the pencil on its cell.
A change to a row on a date it already has replaces that value. A new date adds a dated value to the same row.
To stop a row applying, select Add row and add a value marked Retire. From that date the next most specific row applies. A value of zero is different: it waives the fee.
What is refused
| You tried to | Why it is refused |
|---|---|
| Name a selector or value the price type does not declare | It would never match. Declare it on the price type first |
| Add a row before the list has a fallback on or before that date | Something priced on that date would have no price |
| Add a row as specific as another that could match the same thing | Neither row would win |
| Give an amount a minimum or a maximum | Only a rate has them |
Customer overrides
A customer’s override replaces the value of whichever row is chosen, from the override’s own date. A rate keeps its row’s minimum and maximum. A waived row, with a value of zero, stays waived for every customer.
Regulatory ceilings
Above the matrix, the Regulatory ceilings panel checks this price list against the fee caps your organisation’s regulatory regimes set. The National Credit Act §101 row of the standards register describes which charges it covers. The panel warns; it never stops you saving a price. The platform still refuses or caps the fee when it is charged.
The panel checks every row live today, not only the fallback. A row with a band is checked at the bottom of its band.
| The panel lists | What it means |
|---|---|
| Above the ceiling | A fee whose price is more than its cap, with the row that sets it |
| In no charge class | A fee the regime counts but has not put in a charge class, so no cap applies to it |
| Not checked | A fee the panel cannot price ahead of time, with the reason |
When nothing is listed, every fee the list prices is within its ceiling.
The panel checks your organisation’s base currency only. Caps are set in that currency. If the list also prices other currencies, the panel names them as not checked.
Worked example, against a monthly service fee cap of 60.00 and an ATM fee cap of 30.00:
| Row | Price | Shown as |
|---|---|---|
| Service fee, fallback | 69.00 | Above the ceiling: 69.00 against 60.00 |
| ATM fee, fallback | 25.00 | Within its ceiling, so not listed |
ATM fee, region western-cape |
35.00 | Above the ceiling, naming the region |
| ATM fee as a rate of 2.00% with a maximum of 50.00 | up to 50.00 | Above the ceiling: the maximum is checked |
| Currency conversion fee as a rate of 2.75% with no maximum | no upper limit | Not checked: a rate with no maximum has no worst case |
To clear a finding, lower the row’s price or, for a rate, set a maximum at or under the cap. If you cannot read the advisories, the panel does not appear.
What your organisation configures
Your organisation decides which price types carry selectors, which values each selector allows, and every row on every price list. Your organisation also sets the regulatory regimes, their caps and their charge classes. The platform decides how a row is chosen, how a fee is rounded, and how a cap is checked.
From the LedgerTM product guide, as shipped with the software and written with it. Copied from the platform repository on 2026-11-11.