Price lists
A price list is a named set of fees. Each fee states its own currency, so one list can price several currencies. A pricing plan charges from one price list. The Price Lists tab under Settings lists them. Staff pricing, premium pricing and standard pricing are three lists.
What the page shows
| Column | What it tells you |
|---|---|
| Description | The name people read on screen |
| Currencies | The currencies the list prices in |
| Price types | How many price types the list prices |
| Plans | How many pricing plans charge from the list |
| Active | Whether the list is offered |
The page shows active lists. Choose to show all lists to see inactive ones too.
Adding and editing a list
- Open Settings and select Price Lists.
- Select Add price list.
- Enter a description.
- To start from another list, choose it under Copy from and enter a Start date.
- Select Save.
If you copy a list, the form counts the prices it copies. A change scheduled on the old list is not copied, and the form counts those too. The start date must be after today.
To edit a list, change its description or whether it is active. A list’s currencies come from its prices, so you add a currency on the list itself.
A currency is an ISO 4217 code. Its register row is ISO 4217. A rate fee from a price list rounds half away from zero to the currency’s minor unit.
A fixed amount states a currency. So does a percentage with a floor or a cap. A percentage with neither states no currency, and it applies in every currency.
If an account’s currency has no row for a fee the list prices, the fee refuses with PRICE_NOT_IN_CURRENCY. It never converts from another currency.
The prices on a list
Select a list to open its price sheet. Each line is a price, and each column is a currency.
- A cell shows the price standing today.
- A price not yet in force shows its amount, with from and its date beneath.
- A dash means the list does not price that line in that currency.
- A percentage with no floor or cap takes one cell, marked every currency.
- Retired means the price has stopped.
The sheet shows selector and band prices on lines of their own. If more than one price matches, the most specific row wins. Then the latest effective date wins. See the price matrix. The kinds of price are on price types.
Changing a price
- Select the pencil on the cell.
- Enter the new value.
- Enter the Value date. The earliest date is tomorrow.
- Check the preview, which shows the value until the day before and the value from your date.
- Select Save.
A cell with more than one dated value shows a history button. The button turns into a calendar clock when a change is scheduled. Select it to read the dated values beneath the line, newest first. You can edit, re-date or cancel a scheduled value. A value in force or in the past has no actions, because it may already have been charged.
Adding a price or a currency
Select Add price to price a new price type. Enter an amount per currency, or one rate. A blank currency is not priced.
Select Add row for a price that depends on a selector or a band. You can also retire a row there.
Select Add currency to put a new currency on the list. The form asks for every price the list holds and shows the reference amount beside each one. A blank field leaves that price unpriced, and the form counts the blanks. A percentage asks only for its floor and cap, because the rate itself carries over.
Comparing currencies
If a list has more than one currency, select Compare currencies. Choose a reference currency, a rate date and a tolerance. Each amount then shows its reference amount converted at that rate, and how far it drifts from the converted amount. A drift beyond the tolerance is flagged. no rate means your organisation has no exchange rate for that pair on that date.
With GBP as the reference, a GBP 50.00 payout minimum converts to 60.50 USD. The list prices it at 65.00 USD, so the cell shows +7.4%. Drift is a straight percentage of the converted amount, with no rounding convention beyond one decimal place. A tolerance of 5% flags it.
The compare view also offers a suggested amount in the edit form, and Use all suggestions in the Add currency form. A suggestion is a starting point. Nothing is saved until you select Save.
Closing Compare currencies hides the converted amounts, the drift and the suggestions. Rates never change a price on their own: an account is charged the price stated for its currency.
A worked example
The South African retail template (za-retail) sets up three lists in ZAR. Each takes effect on 2020-01-01.
| Price list | service-fee | initiation-fee | early-settlement-fee |
|---|---|---|---|
| Premium Customer | 45.00 | 805.00 | 250.00 |
| Standard | 60.00 | 1050.00 | 500.00 |
| Staff | 20.00 | 0.00 | 0.00 |
Alex opens an account on the Standard list. The monthly service fee is 60.00 ZAR. If Alex moves to Premium Customer, the fee falls to 45.00 ZAR.
What your organisation configures
- Which price lists exist, and the currency of each price.
- The price of each fee on each list.
- Which price list each pricing plan uses.
From the LedgerTM product guide, as shipped with the software and written with it. Copied from the platform repository on 2026-11-11.