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



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