financekit

Configure FinanceKit entitlements and query Apple Card, Apple Cash, and Wallet transactions.

Updated May 6, 2026
One-click install
npx skills add https://github.com/Roy-wonji/claude-config --skill financekit-roy-wonji
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: financekit
Source: https://github.com/Roy-wonji/claude-config/tree/main/skills/swift-ios-skills/skills/financekit
Command: npx skills add https://github.com/Roy-wonji/claude-config --skill financekit-roy-wonji

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

FinanceKit helps developers access Apple Card, Apple Cash, and Wallet financial data in a safe, user-authorized way so apps can build spending and account features without relying on user exports or brittle scraping.

Core Features & Use Cases

  • Managed entitlement setup & user-facing authorization: Request the com.apple.developer.financekit entitlement and use NSFinancialDataUsageDescription to support the system authorization prompt.
  • Account, balance, and transaction querying: Retrieve accounts, read point-in-time balances, and query transaction history using TransactionQuery and Swift #Predicate filters.
  • Resumable, incremental history sync: Monitor long-running history with AsyncSequence updates and persist HistoryToken for efficient incremental updates.
  • Wallet order integration: Save and query Wallet orders (receipts, shipping tracking style workflows) via FinanceKit/FinanceKitUI.
  • Background delivery for updates (iOS 26+): Enable background delivery using a Background Delivery Extension and App Groups to refresh caches when data changes.

Quick Start

Ask the AI to draft the Swift code for checking FinanceKit availability, requesting authorization, and fetching the first page of the latest transactions for a selected account using a predicate and sort descriptor.

Frequently Asked Questions about financekit

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I authorize my app to access Apple Card and Apple Cash transactions?

To access Apple Card and Apple Cash transactions, configure the com.apple.developer.financekit entitlement and add NSFinancialDataUsageDescription to present the system authorization prompt for secure user-approved financial data access.

How do I query Apple Wallet transaction history with filters and pagination?

You can query Apple Wallet transaction history by using TransactionQuery with Swift #Predicate filters, sort descriptors, and pagination to retrieve structured financial data from authorized accounts.

What is the best way to sync incremental Apple Wallet transaction history?

The best way to sync incremental Apple Wallet transaction history is by persisting a HistoryToken to enable resumable data fetching, monitoring long-running syncs via AsyncSequence updates for efficient incremental synchronization.

Why am I getting FinanceError data restriction or invalid history token errors?

FinanceError data restriction or invalid history token errors occur when availability checks fail or when resumable sync tokens are mishandled, requiring correct FinanceError case handling and valid history token persistence.

Can I use a background delivery extension to refresh Apple financial data on iOS?

Yes, you can enable background delivery for Apple financial data updates on iOS 26+ by implementing a Background Delivery Extension and configuring App Groups to refresh caches when transaction data changes.

Does Apple FinanceKit support saving and querying Wallet orders and receipts?

Yes, Apple FinanceKit supports Wallet order integration by allowing your app to save and query Wallet orders, including receipts and shipping tracking workflows, via the FinanceKit and FinanceKitUI frameworks.