# Bank Feeds Integration

# Bank Feeds

## Overview

Bank Feeds in NexWave provides automatic synchronisation of bank transactions using Akahu, New Zealand's secure open finance platform. Once connected, your bank transactions are automatically imported into NexWave, ready for reconciliation.

 ![](https://docs.nexwaveapp.com/api/files.get?sig=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJrZXkiOiJ1cGxvYWRzL2YxMTg5ZTEzLTdlMTQtNDA1ZC04MDI1LWMxZmI0Y2Y2MTg0ZC9hMmFlNDg4Yi0xMzk2LTQwYzQtODNmZC0wOTJhNTAzMWUwYmEvaW1hZ2UucG5nIiwidHlwZSI6ImF0dGFjaG1lbnQiLCJpYXQiOjE3OTI2MjA5MDAsImV4cCI6MTc5MjcwNzMwMH0.Mi8wxMkUuDgoOuKAVV4ZTopW0zH6wh_rWVoa19tb3MI " =1295x1225")

## Supported Banks

NexWave Bank Feeds supports all major New Zealand banks through Akahu's secure API:

### Major Banks

| Bank | Status |
|------|--------|
| ANZ  | Supported |
| ASB  | Supported (12 months history limit on first sync) |
| BNZ  | Supported |
| Westpac | Supported |
| Kiwibank | Supported (credit cards limited to 180 days history) |

### Other Banks & Financial Institutions

| Institution | Status |
|-------------|--------|
| The Co-operative Bank | Supported |
| Heartland Bank | Supported |
| TSB         | Supported |
| SBS Bank    | Supported |
| Rabobank    | Supported (agribusiness accounts only) |
| NZHL (NZ Home Loans) | Supported |

### Credit Cards & Other Accounts

| Provider | Status |
|----------|--------|
| American Express | Supported |
| Gem Visa (Latitude) | Supported |
| Wise     | Supported |

## Setup

### Step 1: Configure Bank Integration Settings


1. Go to **Bank Integration Settings**
2. Check **Enabled** to activate bank feeds
3. Set **Akahu User** - the NexWave user who will authorise the bank connection
4. Set **Akahu Connected App** - link to the Connected App configured for Akahu OAuth

### Step 2: Enable Sync on Bank Account


1. Navigate to the **Bank Account** you want to sync
2. Ensure **Is Company Account** is checked
3. Enable **Sync Transactions** checkbox
4. Set **Sync Transactions After** date to specify how far back to fetch transactions

### Step 3: Connect to Bank


1. On the Bank Account form, click the **Connect to Bank** button
2. You will be redirected to Akahu's secure portal
3. Select your bank from the list
4. Log in to your bank using your normal online banking credentials
5. Grant permission for NexWave to read transaction data
6. You will be redirected back to NexWave

 ![](https://docs.nexwaveapp.com/api/files.get?sig=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJrZXkiOiJ1cGxvYWRzL2YxMTg5ZTEzLTdlMTQtNDA1ZC04MDI1LWMxZmI0Y2Y2MTg0ZC9lNzNlZGZkZi1kNjI0LTQ5ZjctOTg5NC1jNzk1NmI5YWUxZGEvaW1hZ2UucG5nIiwidHlwZSI6ImF0dGFjaG1lbnQiLCJpYXQiOjE3OTI2MjA5MDAsImV4cCI6MTc5MjcwNzMwMH0.qR1uEaD8JUZpO1gLgdcEg8UopO7Ov9dN6UolC6wLQvE " =790x789")

### Step 4: Verify Connection

The Bank Account form displays the connection status:

| Status | Meaning |
|--------|---------|
| Connected (green) | Bank feed is active and syncing |
| Not Connected (grey) | Connection needs to be established |

## How Syncing Works

### Automatic Synchronisation

* Bank transactions are automatically synced via a scheduled background job
* The system fetches transactions from the last synced date to today
* Duplicate transactions are automatically detected and skipped
* New transactions are created as Bank Transaction records

### Transaction Data

Each synced transaction includes:

| Field | Description |
|-------|-------------|
| Transaction Date | Date the transaction occurred |
| Deposit/Withdrawal | Amount credited or debited |
| Description | Transaction description from the bank |
| Reference Number | Bank reference for the transaction |
| Particulars | NZ bank-specific particulars field |
| Code  | NZ bank-specific code field |
| Party Name | Merchant or payee name (when available) |
| Party Account | Other party's account number (when available) |

## After Syncing

Once transactions are imported, they appear in the **Bank Reconciliation** tool where you can:

* Match transactions to existing invoices and payments
* Create new journal entries for unmatched transactions
* Reconcile your bank account balance

 ![](https://docs.nexwaveapp.com/api/files.get?sig=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJrZXkiOiJ1cGxvYWRzL2YxMTg5ZTEzLTdlMTQtNDA1ZC04MDI1LWMxZmI0Y2Y2MTg0ZC9mZGM0MjViNS0zYjQ5LTRmZDEtOTMyNS1lNTg4NDE2YzRkMmIvaW1hZ2UucG5nIiwidHlwZSI6ImF0dGFjaG1lbnQiLCJpYXQiOjE3OTI2MjA5MDAsImV4cCI6MTc5MjcwNzMwMH0.HCdesE0pyRXtFL-1r0nV1mJoVmXFGx66Gqh3nMfoBoM " =1437x1126")

## Troubleshooting

| Issue | Solution |
|-------|----------|
| Connection status shows Not Connected | Click "Connect to Bank" and re-authorise through Akahu |
| Transactions not syncing | Check that Bank Integration Settings is enabled and the bank account has Sync Transactions checked |
| Missing recent transactions | Wait for the next scheduled sync, or check if there's an error in the Error Log |
| Missing older transactions | Verify the "Sync Transactions After" date is set to the correct date |
| ASB showing limited history | ASB limits first sync to 12 months - this is a bank limitation |
| Kiwibank credit card history limited | Kiwibank credit cards are limited to 180 days on first sync |

## Security

NexWave Bank Feeds is designed with security as a priority:

* **Read-Only Access** - NexWave only requests read access to transaction data. It cannot make payments or modify your accounts.
* **No Credentials Stored** - Your bank login credentials are never stored in NexWave. Authentication is handled securely by Akahu.
* **Encrypted Communication** - All communication with Akahu uses secure HTTPS connections.
* **Accredited Provider** - Akahu is an accredited requestor under New Zealand's Consumer Data Right (CDR) legislation.

## Related Documentation

* [Import Bank Statement](/doc/950b3e14-e00e-4530-a248-e6ef61dbb420) - For manually importing bank statements when bank feeds aren't available