The FNB bank integration add-on for Splynx automates the reconciliation of bank transactions with your FNB account.
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.
You can install the add-on via the CLI or through the Splynx Web UI.
Run the following commands:
apt-get update
apt-get install splynx-fnb
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:
To enable the FNB API integration, the requirements listed below must be fulfilled on the FNB side.
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.
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.
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.
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.
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.
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 methods
and enter its ID here. Or simply use an existing method ID.
Client ID and Client Secret - these credentials are obtained after configuring API access on the FNB side.
Reference value - set the customer's identifier: either Portal login or Portal name.
Account number - set the linked account number.
Bank statements group - group payment statements by Month or Day.
Transaction fetch frequency - set the transaction fetch frequency (Disabled, Daily, Hourly, Once every 2 days).
30 free requests per month. Increasing frequency may result in charges from your bank.
After this, transactions will be processed automatically at the specified time.
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.