SuperAPI AI 工具集

financekit

数据与分析

查看项目

更新于 10-15 21:12

技能介绍

FinanceKit 用于在设备端访问 Apple Wallet 中符合条件的财务数据,覆盖美国 Apple Card、Apple Cash、Savings 以及英国连接账户数据,提供账户、余额与交易查询,并需用户授权。查询 API 从 iOS/iPadOS 17.4 起可用,TransactionPicker 从 iOS/iPadOS 18 起可用,后台投递从 iOS/iPadOS 26 起可用。

主要能力包括:检查数据可用性、请求授权、查询账户与余额、查询交易、使用可恢复的历史查询、通过 FinanceKitUI 的 TransactionPicker 进行选择性临时访问、保存与查询 Wallet 订单,以及 iOS 26 的后台投递扩展。

使用前需先通过 Apple 申请 com.apple.developer.financekit 托管权限,要求组织级开发者账号、Account Holder 角色、符合财务类别的 App Store 应用,并按 bundle ID 审批。项目需在 Info.plist 添加 NSFinancialDataUsageDescription。调用任何 API 前应先用 FinanceStore.isDataAvailable(.financialData) 检查可用性,否则框架会终止应用。

限制方面:数据可用性返回 true 不代表设备上存在数据,访问也可能因 Wallet 不可用或 MDM 限制而临时受限,此时抛出 FinanceError.dataRestricted。金额始终为正数,需结合 creditDebitIndicator 判断方向。历史令牌失效时抛出 FinanceError.historyTokenInvalid,需丢弃令牌并重新同步受影响的数据流。后台投递注册方法为同步且不抛出异常,频率支持 .hourly、.daily、.weekly。Apple Pay 结账应使用 PassKit,小组件 UI 应使用 WidgetKit。