# Akahu Integration

# Akahu Integration

Akahu is a New Zealand open banking platform that provides secure access to bank transaction data. NexWave integrates with Akahu to automatically synchronise bank transactions for reconciliation.

## Data Flow

 ![](https://docs.nexwaveapp.com/api/files.get?sig=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJrZXkiOiJ1cGxvYWRzL2YxMTg5ZTEzLTdlMTQtNDA1ZC04MDI1LWMxZmI0Y2Y2MTg0ZC9kMWMyMWZlYS0wNjYzLTRhMDYtYWFhNi05NTdlOGQwODk1YzkvYWthaHUtZGF0YS1mbG93LnN2ZyIsInR5cGUiOiJhdHRhY2htZW50IiwiaWF0IjoxNzk0Mzk2NjAwLCJleHAiOjE3OTQ0ODMwMDB9.bKNe8Hs7D-gzd7g_5sbyxhRuvbJtbm9_CfV6-LolPKU " =700x374")


## Features

| Feature | Description |
|---------|-------------|
| **OAuth Authentication** | Secure bank connection via Akahu authorization flow |
| **Automatic Sync** | Scheduled background job fetches new transactions |
| **Per-Account Control** | Enable/disable sync for individual bank accounts |
| **Duplicate Detection** | Prevents duplicate transactions using transaction ID |
| **Rate Limit Handling** | Automatic retry with backoff on API rate limits |
| **Transaction Metadata** | Captures particulars, reference, code, and merchant info |

## Supported Banks

Akahu supports all major New Zealand banks including:

* ANZ
* ASB
* BNZ
* Westpac
* Kiwibank
* TSB
* The Co-operative Bank
* Rabobank
* Heartland Bank

## Configuration

### Bank Integration Settings

| Field | Description |
|-------|-------------|
| Enabled | Toggle to enable/disable the integration |
| Akahu User | NexWave user whose token is used for API calls |
| Akahu Connected App | OAuth app configuration for Akahu |

### Bank Account Settings

| Field | Description |
|-------|-------------|
| Sync Transactions | Enable automatic sync for this account |
| Sync Transactions After | Start date for fetching historical transactions |

## Transaction Data Mapping

| Akahu Field | NexWave Field |
|-------------|---------------|
| `_id`       | Transaction ID |
| `date`      | Date          |
| `amount` (positive) | Deposit       |
| `amount` (negative) | Withdrawal    |
| `description` | Description   |
| `meta.reference` | Reference Number |
| `meta.particulars` | Particulars   |
| `meta.code` | Code          |
| `merchant.name` | Bank Party Name |
| `meta.other_account` | Bank Party Account Number |

## Related Documentation

* [Bank Feeds Integration](/doc/af08c753-d3cb-489e-8202-9ea786645b85)  - Overview of bank feed functionality
* [Bank Reconciliation Tool](/doc/2869cb02-cb4f-42ad-938e-5f0abd973889)  - Reconciling imported transactions