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.

  1. The row naming the most facts wins. A band counts as one fact.
  2. Between rows naming the same number of facts, the latest effective date wins.
  3. 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

  1. Select Add row.
  2. Choose the price type and the currency.
  3. Pick a value for each selector, or leave it as Any.
  4. Enter the band, if the price depends on the amount.
  5. Enter the value, and for a rate the minimum and maximum fee.
  6. 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.