用途:使用 FinanceKit 与 FinanceKitUI 访问符合条件的 Wallet 财务数据,包括交易与余额查询、选择性交易导入、Wallet 订单的存储与查询,以及 iOS 26+ 后台投递。查询 API 自 iOS/iPadOS 17.4 起可用,TransactionPicker 自 18 起,后台投递自 26 起。Apple Pay 结账应交给 passkit,小组件渲染/时间线交给 widgetkit,商户邮件/Business Connect 优化不在本技能范围内。
主要能力:FinanceStore 授权与查询、FinanceKitUI 的 TransactionPicker、可续传的账户/余额/交易历史序列、订单保存与检查,以及后台投递。获取财务数据访问权限属于受管能力,需满足组织机构 Apple 开发者账号、账户持有人申请、符合金融类别并通过美区或英区 App Store 分发、Apple 对特定 bundle ID 的 com.apple.developer.financekit 批准、清晰的 NSFinancialDataUsageDescription,以及金融产品所需合规义务等条件。美区支持符合条件的 Apple Card、Apple Cash 和 Savings,家庭排除规则适用;英区自 iOS/iPadOS 18.4 起支持受支持的开放银行机构。
使用方式:任何财务数据或订单 API 前先做可用性判断,例如使用 FinanceStore.isDataAvailable(.financialData),再调用 FinanceStore.shared.requestAuthorization()。不可用时调用财务 API 可能导致应用终止;可用也不代表存在账户,临时限制会以 FinanceError.dataRestricted 呈现。
限制与注意:金额为正值,需结合 creditDebitIndicator 判断方向,不能从 Decimal 推断符号;贷方科目需结合账户上下文解释。持续同步应覆盖账户、余额和交易,而非仅交易。历史变更含插入、更新、删除 ID,需先提交本地删除/更新再持久化 newToken;每个流/账户保留独立 token,historyTokenInvalid 时只丢弃受影响 token 并重新抓取。访问被撤销后应删除本地保留的财务数据。后台频率是数据变化时的预期最小间隔,并非精确计划;应用与扩展均需权限与共享 App Group。