The bank registry

The Banks tab under Settings lists the banks your organisation can name on an external account. You pick a bank and type an account number. The system adds the bank’s branch code for you.

Column What it tells you
Bank Id A short name for the bank, such as fnb
Bank Name The name people see
Universal Branch Code The six-digit code the payment rail addresses the bank by
Active Whether people can pick the bank

Universal branch codes

A universal branch code is one six-digit code for a whole bank. It works for both credits and debit orders. PayInc, formerly BankservAfrica, publishes these codes to its participants.

The standards register lists PayInc universal branch codes as a planned row. There is no open feed to load. You keep the list yourself.

The South African retail template (za-retail, built on the za country layer) seeds the published list. First National Bank has the bank id fnb and the code 250655. Alex picks First National Bank and types an account number. The payment goes out under 250655.

Where the registry is used

A bank that is not in the registry is refused. The message reads “Bank ‘x’ is not in the bank registry.” For accounts you pay out to, see adding a beneficiary.

Adding a bank

  1. Open Settings and select Banks.
  2. Select the add button.
  3. Enter a Bank Id in lowercase letters, digits and hyphens.
  4. Enter the Bank Name.
  5. Enter the six-digit Universal Branch Code.
  6. Save.

The code must be exactly six digits. If the bank id already exists, the add does nothing.

Editing a bank

You can change the name, the code and whether the bank is active. The bank id is fixed.

A changed code applies to payments from then on. A payment that is already initiated keeps the code it went out with.

A renamed bank can still show its old name on accounts you registered earlier. Payments still go to the right bank, because the code is read when the payment is made.

What your organisation configures

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