Overview
Nedbank's Open Banking API offers SA bank account operations + AVS + CashOut vouchers. The Automize Nedbank connector covers accounts, balances, transactions, payments, mandates, and CashOut vouchers.
- Regions: South Africa.
- Plans: Nedbank Open Banking – apply via developer portal (paid commercial).
Setting up the connection
Auth type: OAuth 2.0 (Client Credentials).
- Nedbank Developer Portal → register app → receive Client ID + Secret.
- In Automize → Settings → Connectors → Nedbank. Paste credentials.
Find your credentials at https://api.nedbank.co.za/.
Rate limits
Per-customer agreement. Conservative defaults.
Data model
Banking primitives:
Account ─┬─ Balance
├─ Transactions
├─ Statements
└─ Mandates (DebiCheck)
Payments (EFT + DebiCheck collections)
CashOut Vouchers (recipient redeems at ATM)Available operations
10 operations available. Click any row to jump to its detail.
| Operation | Category | What it does |
|---|---|---|
| Get Account | Accounts | Get account details by account ID |
| Get Balance | Accounts | Get available and current balance |
| Get Statement | Accounts | Download a bank statement for a period |
| Get Transactions | Accounts | Get account transactions (filterable by date) |
| List Accounts | Accounts | List accounts accessible to the authenticated customer |
| Cancel CashOut Voucher | CashOut | Cancel an unredeemed CashOut voucher |
| Create CashOut Voucher | CashOut | Generate a CashOut voucher redeemable at any Nedbank ATM or partner retailer |
| Get CashOut Voucher | CashOut | Get voucher status and redemption details |
| Get Customer | Customers | Get customer profile from Nedbank's core banking record |
| Verify Bank Account (AVS Real-Time) | Verification (AVS) | Verify an account number belongs to the supplied person/entity |
Operations
Cancel CashOut Voucher
Cancel an unredeemed CashOut voucher
| Parameter | Required | Type | Description |
|---|---|---|---|
Voucher Id voucher_id | Yes | text |
Create CashOut Voucher
Generate a CashOut voucher redeemable at any Nedbank ATM or partner retailer
| Parameter | Required | Type | Description |
|---|---|---|---|
Amount amount | No | text | |
Reference reference | No | text | |
Beneficiarymobilenumber beneficiaryMobileNumber | No | text | |
Expiryhours expiryHours | No | text |
Tips
- Generate a one-time voucher code. Recipient redeems at Nedbank ATM (no card needed).
Get Account
Get account details by account ID
| Parameter | Required | Type | Description |
|---|---|---|---|
Account Id account_id | Yes | text |
Get Balance
Get available and current balance
| Parameter | Required | Type | Description |
|---|---|---|---|
Account Id account_id | Yes | text |
Tips
- account_id. Real-time balance.
Get CashOut Voucher
Get voucher status and redemption details
| Parameter | Required | Type | Description |
|---|---|---|---|
Voucher Id voucher_id | Yes | text |
Get Customer
Get customer profile from Nedbank's core banking record
| Parameter | Required | Type | Description |
|---|---|---|---|
Customer Id customer_id | Yes | text |
Get Statement
Download a bank statement for a period
| Parameter | Required | Type | Description |
|---|---|---|---|
Account Id account_id | Yes | text |
Get Transactions
Get account transactions (filterable by date)
| Parameter | Required | Type | Description |
|---|---|---|---|
Account Id account_id | Yes | text |
Tips
- Filter by date range.
List Accounts
List accounts accessible to the authenticated customer
No input parameters.
Tips
- Returns accessible accounts.
Verify Bank Account (AVS Real-Time)
Verify an account number belongs to the supplied person/entity
| Parameter | Required | Type | Description |
|---|---|---|---|
Accountnumber accountNumber | No | text | |
Branchcode branchCode | No | text | |
Accounttype accountType | No | text | |
Idnumber idNumber | No | text | |
Idtype idType | No | text | |
Initials initials | No | text | |
Surname surname | No | text | |
Companyregistrationnumber companyRegistrationNumber | No | text |
FAQ
- Voucher use case?
- Send money to recipients without bank accounts. Recipient gets SMS with voucher code + redeems at ATM.