Withholding regime

The Withholding page shows the rules your organisation follows when it holds back tax on interest it pays. It has four tabs: Payer classes, Income classes, Rules and Exemptions.

You maintain the payer classes and the income classes here. The rules and exemptions come from your organisation’s tenant setup, and this page shows them read-only.

Payer classes

A payer class says what kind of payer an operating entity is in tax law. Some kinds of payer are exempt from withholding. A registered bank paying interest in South Africa is one example.

Column What it means
Label The name people see. A retired class also shows Retired.
Key The stable identity of the class, such as registered-bank.

You pick an entity’s payer class with Change Tax Registration. See Changing an entity’s tax registration.

Add a payer class

Example: Alex adds mutual banks, so an entity can be recorded as one.

  1. Select Add payer class.
  2. Enter the key mutual-bank.
  3. Enter the label Mutual Bank.
  4. Select Save.
  5. Submit the staged change from the bar to publish it.

The class appears in the list. Once the change is published, it also appears in the payer-class picker on every operating entity.

A key is lower-case words joined by hyphens. A key such as Mutual Bank is refused. You cannot change a key after you add it. To use a different key, add a new class.

Change a label

  1. Select Edit on the class.
  2. Change the label.
  3. Select Save.

Entities that hold the class show the new label.

Retire a payer class

Select Retire to stop offering a class. A retired class stays on the entities that already hold it, and they still show its label. It no longer appears in the picker for any other entity. Select Reactivate to offer it again.

If an exemption names a class, you cannot retire it. In the shipped South African setup, the exemption names Registered bank, so that class cannot be retired.

Income classes

An income class names a kind of income tax is withheld from, such as interest. Each withholding tax rule names one. So does each regime rule and exemption on this page, in its Income class column.

Column What it means
Label The name people see. A retired class also shows Retired.
Key The stable identity of the class, such as interest.

Add an income class

  1. Select the Income classes tab.
  2. Select Add income class.
  3. Enter the key, such as interest.
  4. Enter the label, such as Interest.
  5. Select Save.
  6. Submit the staged change from the bar to publish it.

A key is lower-case words joined by hyphens. You cannot change a key after you add it.

Retire an income class

Select Retire to stop offering a class. If a tax rule or a regime rule still names the class, publishing is refused. The message names each rule that uses it.

Example: Woodgrove Bank withholds tax on interest capitalisation, under the income class Interest. Alex retires Interest. The change is refused, naming the withholding tax rule on InterestCapitalised. Interest stays available.

A class nothing names can be retired.

Rules

Each rule names the country the payer is taxed in, the country the payee lives in, and the kind of income. It also names the rate that applies. A rule with no payee country is the statutory rule for that payer country. A rule for one payee country is a treaty rule, and it can require evidence such as a treaty declaration.

Countries are two-letter ISO 3166-1 alpha-2 codes, such as ZA for South Africa. Its register row is ISO 3166-1 alpha-2.

The rule shapes follow Article 11 of the OECD Model Tax Convention. Its register row is OECD Model Tax Convention Article 11, status Partial. The treaty rates the template ships are demonstration values. They are not a maintained treaty table.

An operating entity can only be taxed in a country that has a statutory rule. If no rule names the country, the entity’s change is refused and the message names the country.

Exemptions

An exemption says that a payer class in one country withholds nothing on one kind of income. It names the law that grants it.

Payer country Payer class Income class Authority
ZA Registered bank Interest ITA s50D

The shipped setup records this one exemption. Whether a real entity belongs to an exempt payer class is a tax opinion. The platform holds the class you choose. It does not decide it for you.

What your organisation configures

The platform fixes the country-code standard and the rule that a key never changes.

From the LedgerTM product guide, as shipped with the software and written with it. Copied from the platform repository on 2026-11-11.