Overview
FNB's Business Banking API offers SA account operations + payments + DebiCheck mandates + accounting integration. The Automize FNB connector covers these.
- Regions: South Africa.
- Plans: FNB Business Banking API agreement.
Setting up the connection
Auth type: OAuth 2.0 (Client Credentials).
- FNB business banking → enrol for API access.
- Receive Client ID + Secret.
- In Automize → Settings → Connectors → FNB. Paste credentials.
Find your credentials at https://www.fnb.co.za/business-banking/.
Rate limits
Per-customer agreement.
Data model
Banking primitives:
Account ─┬─ Balance
├─ Transactions
├─ Statements
└─ DebiCheck Mandates (recurring debit auth)
Payments + Accounting Integration (push to Sage/Xero/etc.)Available operations
11 operations available. Click any row to jump to its detail.
| Operation | Category | What it does |
|---|---|---|
| Get Account | Accounts | Get account details by account number |
| Get Balance | Accounts | Get current and available balance |
| Get Statement | Accounts | Download a statement (used by Pastel/Sage/Xero accounting integrations) |
| Get Transactions | Accounts | Get transactions (date range supported) |
| List Accounts | Accounts | List accounts linked to the Integration Channel profile |
| Cancel DebiCheck Mandate | DebiCheck | Cancel an active DebiCheck mandate |
| Create DebiCheck Mandate | DebiCheck | Create a DebiCheck (authenticated debit order) mandate |
| Get DebiCheck Mandate | DebiCheck | Get DebiCheck mandate status |
| Get Payment | Payments | Get payment status |
| Initiate Payment | Payments | Initiate an EFT payment |
| List Beneficiaries | Payments | List saved beneficiaries |
Operations
Cancel DebiCheck Mandate
Cancel an active DebiCheck mandate
| Parameter | Required | Type | Description |
|---|---|---|---|
Mandate Id mandate_id | Yes | text |
Create DebiCheck Mandate
Create a DebiCheck (authenticated debit order) mandate
| Parameter | Required | Type | Description |
|---|---|---|---|
Debtoraccount debtorAccount | No | text | |
Debtoridnumber debtorIdNumber | No | text | |
Amount amount | No | text | |
Frequency frequency | No | text | |
Startdate startDate | No | text | |
Enddate endDate | No | text | |
Contractreference contractReference | No | text |
Tips
- Customer authorises recurring debit. Returns mandate_id.
Get Account
Get account details by account number
| Parameter | Required | Type | Description |
|---|---|---|---|
Account Id account_id | Yes | text |
Get Balance
Get current and available balance
| Parameter | Required | Type | Description |
|---|---|---|---|
Account Id account_id | Yes | text |
Get DebiCheck Mandate
Get DebiCheck mandate status
| Parameter | Required | Type | Description |
|---|---|---|---|
Mandate Id mandate_id | Yes | text |
Get Payment
Get payment status
| Parameter | Required | Type | Description |
|---|---|---|---|
Payment Id payment_id | Yes | text |
Get Statement
Download a statement (used by Pastel/Sage/Xero accounting integrations)
| Parameter | Required | Type | Description |
|---|---|---|---|
Account Id account_id | Yes | text |
Tips
- PDF, MT940, or CSV.
Get Transactions
Get transactions (date range supported)
| Parameter | Required | Type | Description |
|---|---|---|---|
Account Id account_id | Yes | text |
Initiate Payment
Initiate an EFT payment
| Parameter | Required | Type | Description |
|---|---|---|---|
Debtoraccount debtorAccount | No | text | |
Creditoraccount creditorAccount | No | text | |
Amount amount | No | text | |
Currency currency | No | text | |
Reference reference | No | text | |
Beneficiaryreference beneficiaryReference | No | text |
Tips
- EFT or RTC. Async – poll for settlement.
List Accounts
List accounts linked to the Integration Channel profile
No input parameters.
Tips
- Returns accessible accounts.
List Beneficiaries
List saved beneficiaries
| Parameter | Required | Type | Description |
|---|---|---|---|
Account Id account_id | Yes | text |
FAQ
- DebiCheck – what?
- Mandatory debit-order auth scheme in SA. Customer authorises mandate amount + max frequency. Reduces unauthorised debit disputes.