# Transaction History

# Transaction History

Display a card's transaction history in a compact summary or full-screen list. Tapping a row navigates to [Transaction Details](transaction-details-ios.md) (iOS) or the built-in `TransactionDetailsActivity` (Android).

## Implementations

| Approach                                              | Platform                  | Description                                                                             |
| ----------------------------------------------------- | ------------------------- | --------------------------------------------------------------------------------------- |
| [iOS MFE](mfe-ios.md)                                 | iOS (SwiftUI)             | `TransactionHistoryView` microfrontend — compact or fullscreen list with filter support |
| [iOS Transaction Details](transaction-details-ios.md) | iOS (SwiftUI)             | `TransactionDetailsView` microfrontend — single-transaction detail card                 |
| [Android SDK](sdk-android.md)                         | Android (Jetpack Compose) | `UILibrary.TransactionsCardView` / `TransactionList` Compose components                 |
| [Headless / API](api.md)                              | Any                       | Fetch transaction and event history directly with `sdk.getTransactionHistory()`         |

## What Transaction History provides

* Fetches transaction history for a given `CardEntity` and updates the card balance.
* Compact mode: limits displayed rows, shows a "See more" button.
* Fullscreen mode (iOS) / `TransactionListActivity` (Android): shows the complete list.
* Grouping by month, timestamp formatting, and filter presets (iOS).
* Built-in loading, error, and retry states.

## Prerequisites

1. Complete [Setup](../setup/android-setup.md) + [Initialize](../setup/android-initialize.md) for Android, or [Setup](../setup/ios-setup.md) + [Initialize](../setup/ios-initialize.md) for iOS.
2. A `CardEntity` obtained from [Card List](../card-list/index.md).