¶ FNB bank integration add-on
¶ Overview
The FNB bank integration add-on for Splynx automates the reconciliation of bank transactions with your FNB account and supports multiple bank accounts.
By securely connecting to the FNB API using OAuth credentials (Client ID and Secret), this add-on retrieves bank statements on a schedule and matches incoming payments to customer accounts or invoices using a predefined reference.
Once matched, payments are automatically recorded in Splynx under a designated payment method (e.g., “FNB”), eliminating the need for manual imports or reconciliations.
This integration streamlines financial workflows, enhances billing accuracy, and ensures customer accounts are updated with minimal administrative effort.
¶ Installation
You can install the add-on via the CLI or through the Splynx Web UI.
- CLI installation:
Run the following commands:
apt-get update
apt-get install splynx-fnb
- Web UI installation:
Navigate to Config → Integrations → Addons:
Locate or search for the "splynx-fnb" addon and click on the install button in the Actions column:
Click the OK, confirm button to begin the installation process:
¶ FNB integration requirements
To enable the FNB API integration, the requirements listed below must be fulfilled on the FNB side.
¶ Account conversion
The FNB account must be converted to an Enterprise Business Account to allow API access.
If you currently have a standard Business Account, please email chris@splynx.com with the subject line: Splynx FNB IntegrationInclude the following details in your email:
- Business Name:
- FNB Account Number:
- Person Responsible for the Account:
- Contact Number:
- Contact Email:
We will then submit these details to FNB, and their Integration Channel Manager for your region will contact you to assist with the account upgrade.
¶ Activating Integration Channel
Once your account is upgraded to Enterprise, follow these steps:
-
Log in to FNB Online Banking.
-
Navigate to
Business Solutions → Integration Channel. -
Click
Get Started, then accept the terms and conditions. -
Click
View My Service Tasks. -
Change the integration type from Host-to-Host to API.
-
Scroll down and subscribe to the Statements service.
¶ Configuring API Access
During the subscription process, follow these steps:
-
Consumption Method – Select “On my own behalf”.
-
Connectivity Protocols – Click
Add Connectivity Protocol.-
Set a connectivity nickname of your choice.
-
Set Connectivity Type to REST API.
-
Acknowledge that a Client ID and Client Secret will be generated and must be securely stored.
-
-
Context – Add the contact person responsible for the integration.
Complete the process to generate the Client ID and Client Secret.
These credentials are only shown once. If they are lost, they cannot be recovered.
¶ Entering credentials in Splynx
Once you have the credentials:
-
Go to Splynx Admin Portal:
Config → Integrations → Module list → Splynx FNB Bank Integration. -
Enter the Client ID, Client Secret, and the linked bank account number.
¶ FNB pricing notice
Please note that FNB currently provides 30 statement requests per month for free.
This means:
-
If you run the integration daily, the integration will typically be free.
-
If you choose to run the integration more frequently (e.g. hourly), you will be billed per request after the free limit is reached.
The current cost is approximately R1 per additional request.
It is up to you to decide whether to prioritize cost efficiency (daily sync) or more frequent updates (hourly sync) depending on your operational needs.
¶ Splynx configuration
To configure the add-on in Splynx after completing all necessary settings on the FNB side, go to Config → Integrations → Modules list and locate the 'splynx_fnb_bank_integration' module. Then, click the Edit icon:
You need to configure the Common settings here for the add-on to function properly in Splynx:
-
Payment method ID - create payment method FNB at
Config → Finance → Payment methodsand enter its ID here. Or simply use an existing method ID. -
Reference value - set the customer's identifier: either Portal login or Portal name.
-
Bank statements group - group payment statements by Month or Day.
Then proceed to the Bank account settings:
-
Enable processing bank account - enable the toggle to activate processing for this bank account.
-
Client ID and Client Secret - these credentials are obtained after configuring API access on the FNB side.
-
Account number - set the linked account number.
-
Transaction fetch frequency - set the transaction fetch frequency for this bank account.
(Disabled, Daily, Hourly, Once every 2 days).
30 free requests per month. Increasing frequency may result in charges from your bank.
- Process at - set the scheduled time for processing payments.
After this, transactions will be processed automatically at the specified time.
¶ Multiple bank accounts
To activate multiple bank accounts, switch on the corresponding toggle and enter the required details:
You can enable up to five bank accounts.
In the Import preview section of the FNB Integration, the bank account ID will be shown in its respective column:
In the Payment statement history, each bank account will have a separate entry with its corresponding number:
¶ Manual fetch
To manually fetch transactions from FNB, select the desired period in Finance → FNB integration and click Search.
A preview table will appear, showing the customer's entries along with the transaction status, customer name, total amount, date, reference number, and Entry ID.
You can filter the entries by status using the dropdown in the top-right corner of the table.
If all details are correct, click Import at the bottom of the table to begin the process.
