Akahu 设置

什么是 Akahu？

Akahu 是一家经 Payments NZ 认证的新西兰开放银行聚合商。它提供对你银行账户和交易历史的安全只读访问。FFFFinance 使用 Akahu 作为唯一的银行数据来源。

前提条件

• 一个 Akahu 账户（在 akahu.nz 注册）
• 在 my.akahu.nz/developers 创建的个人应用
• 通过 Akahu 门户连接的银行账户

设置步骤

1. 在 akahu.nz 注册 并验证身份。
2. 前往 my.akahu.nz/developers 并创建个人应用。
3. 在 Akahu 门户中连接你的银行账户（你直接与银行进行身份验证）。
4. 从开发者仪表盘复制你的 App Token 和 User Access Token。
5. 在 FFFFinance 中：设置 > 连接 > 粘贴两个令牌 > 同步。

同步工作原理

• 通过 GET /accounts 获取账户
• 通过 GET /transactions 获取交易（基于游标的分页，每页 100 条）
• 默认回溯期：2 年 的交易历史
• 交易按以下级联方式自动分类：

用户规则 > 关键词模式 > Akahu NZFCC 类别 > 未分类

支持的银行

ANZ、ASB、BNZ、Kiwibank 和 Westpac 均完全支持。通过 Akahu 连接的其他新西兰金融机构也可以使用。

账户类型

Akahu 账户类型映射为内部类型：

Akahu 类型	内部类型
CHECKING	CHECKING（活期存款）
SAVINGS	SAVINGS（储蓄）
CREDITCARD	CREDIT（信用卡）
LOAN	CREDIT（贷款）
INVESTMENT	INVESTMENT（投资）
KIWISAVER	INVESTMENT（KiwiSaver 退休储蓄）
FOREIGN_CURRENCY	CHECKING（外币）
REWARDS	REWARDS（积分奖励）

令牌存储与安全

• 令牌存储在你电脑上的本地 SQLite settings 表中。
• 令牌不会被传输到 Akahu API (https://api.akahu.io/v1) 以外的任何地方。
• API 请求使用两个请求头：

Authorization: Bearer {userToken}
X-Akahu-ID: {appToken}

• 除非你明确启用云同步（Cloudflare D1），否则数据不会离开你的设备。

自动分类

FFFFinance 对交易描述运行 12 组新西兰特有的关键词模式：

类别	示例关键词
工资	salary, wages, payroll, pay credit
杂货	Countdown, New World, Pak'nSave, Fresh Choice, Four Square
餐饮	McDonalds, KFC, Subway, Dominos, Hell Pizza, Burger King
燃油	Z Energy, Gull, BP, Mobil, Caltex
交通	AT HOP, Uber, taxi, parking, Waka Kotahi
订阅	Netflix, Spotify, Apple, Google, Microsoft, Amazon Prime, Neon
水电煤	Genesis, Contact Energy, Meridian, Mercury, Vector, Watercare
网络	Spark, Vodafone, One NZ, 2degrees, Orcon, Skinny
医疗	pharmacy, doctor, medical, dental, physio, Southern Cross
保险	AIA, State Insurance, AA Insurance, Tower Insurance
购物	Trade Me, Amazon, Warehouse, Kmart, Farmers, Briscoes, Bunnings
房租	rent, body corp, property management

如果没有关键词模式匹配，FFFFinance 会在可用时回退到 Akahu 的 NZFCC（新西兰金融类别代码）类别。用户的修正会被学习并应用到未来的交易中。

商户 Logo

商户 Logo 通过三级级联方式解析：

1. Akahu 商户 Logo (transaction.merchant.logo) —— 最高优先级
2. Akahu 元数据 Logo (transaction.meta.logo) —— 来自 Akahu 元数据的回退
3. 本地模式匹配 —— 内置查找表，将商户名称和描述映射到已知 Logo