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
- Registering an external account. A South African account names a bank from this list.
- The bank picker. It offers active banks only.
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
- Open Settings and select Banks.
- Select the add button.
- Enter a Bank Id in lowercase letters, digits and hyphens.
- Enter the Bank Name.
- Enter the six-digit Universal Branch Code.
- 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
- Which banks are listed. The template seeds the published South African list.
- The code for each bank. You change it when the scheme re-codes a bank.
- Which banks are active.
From the LedgerTM product guide, as shipped with the software and written with it. Copied from the platform repository on 2026-11-11.