<!--
{
  "availability" : [
    "iOS: 17.0 -",
    "iPadOS: 17.0 -",
    "macCatalyst: 17.0 -"
  ],
  "documentType" : "symbol",
  "framework" : "FinanceKit",
  "identifier" : "/documentation/FinanceKit",
  "metadataVersion" : "0.1.0",
  "role" : "Framework",
  "symbol" : {
    "kind" : "Framework",
    "modules" : [
      "FinanceKit"
    ],
    "preciseIdentifier" : "FinanceKit"
  },
  "title" : "FinanceKit"
}
-->

# FinanceKit

Access financial data and interact with Apple Card, Apple Cash, and orders in Wallet.

## Overview

Use FinanceKit to access on-device financial data, Apple Cash, and interact with orders in Apple Wallet.

You interact with FinanceKit through [`FinanceStore`](/documentation/FinanceKit/FinanceStore) and
<doc://com.apple.documentation/documentation/FinanceKitUI>,
which presents a standardized UI that people access.

![Image of FinanceKit hero logo.](images/com.apple.financekit/financekit-hero-img.png)

Using the FinanceKit framework, you can:

- Access on-device financial data.
- Add, update, store, and interact with orders in Wallet.
- Interact with Apple Card and Apple Cash.

> Important: To access someone’s financial data, you must meet the criteria outlined in [Get started with FinanceKit](https://developer.apple.com/financekit/), request the [FinanceKit managed entitlement](https://developer.apple.com/contact/request/financekit/),
> hold an organization-level Apple Developer account, be logged in as Account Holder,
> and include the `NSFinancialDataUsageDescription` string in your `Info.plist`.
> Apple reviews each application using [defined criteria](https://developer.apple.com/financekit/). If your request meets the criteria,
> Apple adds the entitlement to your developer account by using managed capabilities.
> To request access, see the [FinanceKit managed entitlement request form](https://developer.apple.com/contact/request/financekit/).
> For more information about managed entitlements, see [Provisioning with capabilities](https://developer.apple.com/help/account/reference/provisioning-with-managed-capabilities).

## Topics

### Essentials

[Implementing a background delivery extension](/documentation/FinanceKit/implementing-a-background-delivery-extension)

Receive up-to-date financial data in your app and its extensions by adding a background delivery extension.

  <doc://com.apple.documentation/documentation/Updates/FinanceKit>

### Data storage

[`FinanceStore`](/documentation/FinanceKit/FinanceStore)

Secure storage for Apple Wallet orders.

### Authorization

[`authorizationStatus()`](/documentation/FinanceKit/FinanceStore/authorizationStatus())

Checks the authorization status for the calling application.

[`requestAuthorization()`](/documentation/FinanceKit/FinanceStore/requestAuthorization())

Prompts a person to give FinanceKit authorization to access financial data.

[`AuthorizationStatus`](/documentation/FinanceKit/AuthorizationStatus)

### Accounts

[`accounts(query:)`](/documentation/FinanceKit/FinanceStore/accounts(query:))

Returns a list of accounts a person added to their Wallet that meet the criteria in the provided account query.

[`accountHistory(since:isMonitoring:)`](/documentation/FinanceKit/FinanceStore/accountHistory(since:isMonitoring:))

Returns a list of accounts a person added since a time specified by the provided financial history token.

[`AssetAccount`](/documentation/FinanceKit/AssetAccount)

A structure that describes the characteristics of an asset account.

[`LiabilityAccount`](/documentation/FinanceKit/LiabilityAccount)

A structure that describes the characteristics of a liability account.

[`Account`](/documentation/FinanceKit/Account)

A structure that describes a financial account.

### Balances

[`accountBalances(query:)`](/documentation/FinanceKit/FinanceStore/accountBalances(query:))

Returns a list of balances that meet the criteria in the provided account query.

[`accountBalanceHistory(forAccountID:since:isMonitoring:)`](/documentation/FinanceKit/FinanceStore/accountBalanceHistory(forAccountID:since:isMonitoring:))

Returns the account balance history since a time specified by the provided financial history token.

[`AccountBalance`](/documentation/FinanceKit/AccountBalance)

A structure that describes the financial balance of an account at a specific point in time. The financial balance of an account at a specific point in time.

[`AccountBalanceQuery`](/documentation/FinanceKit/AccountBalanceQuery)

A structure that defines an account balance query.

[`Balance`](/documentation/FinanceKit/Balance)

A structure that describes an account balance.

[`CreditDebitIndicator`](/documentation/FinanceKit/CreditDebitIndicator)

Values that the framework uses to describe transactions as credits or debits.

[`CurrentBalance`](/documentation/FinanceKit/CurrentBalance)

Values that describe the state of an account’s credit balance.

### Orders

[`FullyQualifiedOrderIdentifier`](/documentation/FinanceKit/FullyQualifiedOrderIdentifier)

A structure that specifies the characteristics of an order.

[`saveOrder(signedArchive:)`](/documentation/FinanceKit/FinanceStore/saveOrder(signedArchive:))

Adds an order to the store or updates an existing order.

### Transactions

[`transactionHistory(forAccountID:since:isMonitoring:)`](/documentation/FinanceKit/FinanceStore/transactionHistory(forAccountID:since:isMonitoring:))

Returns the transactions for the specified account ID, optional starting time, and monitoring indicator for long running transaction queries.

[`transactions(query:)`](/documentation/FinanceKit/FinanceStore/transactions(query:))

Returns transactions that match the provided transaction query.

[`AccountQuery`](/documentation/FinanceKit/AccountQuery)

A structure that defines an account query.

[`AccountCreditInformation`](/documentation/FinanceKit/AccountCreditInformation)

A structure that describes the credit information associated with an account.

[`CurrencyAmount`](/documentation/FinanceKit/CurrencyAmount)

A structure that describes a monetary amount and its currency.

[`Transaction`](/documentation/FinanceKit/Transaction)

A structure that represents a transaction relating to a specific financial account.

[`TransactionQuery`](/documentation/FinanceKit/TransactionQuery)

A structure that describes the parameters to use for a transaction query.

[`TransactionType`](/documentation/FinanceKit/TransactionType)

Values that describe kinds of transactions.

[`TransactionStatus`](/documentation/FinanceKit/TransactionStatus)

Values that describe the status of a transaction.

### Queries

[`FinanceStore.HistoryToken`](/documentation/FinanceKit/FinanceStore/HistoryToken)

A structure that describes the starting point to use for financial data queries.

### Merchant categories

[`MerchantCategoryCode`](/documentation/FinanceKit/MerchantCategoryCode)

### Errors

[`FinanceError`](/documentation/FinanceKit/FinanceError)

Values that describe errors that may occur when accessing financial data.



---

Copyright &copy; 2026 Apple Inc. All rights reserved. | [Terms of Use](https://www.apple.com/legal/internet-services/terms/site.html) | [Privacy Policy](https://www.apple.com/privacy/privacy-policy)