Card List

Card List

Display a user's cards in a scrollable list with balance, masked PAN, and card art. The Card List is typically the entry point of your card experience.

Implementations

Choose the approach that fits your integration:

Approach	Platform	Description
iOS MFE	iOS (SwiftUI)	`CardListView` microfrontend — drop-in SwiftUI component with callbacks
Android SDK	Android (Jetpack Compose)	`UILibrary.CardListView` Compose component with built-in state management
Headless / API	Any	Fetch card data directly with `sdk.getCards()` and build your own UI

What the Card List provides

Fetches cards from the backend (gift cards + card art) and renders them as rows.
Exposes onSelect / onCardSelected callbacks so you can navigate to Card Details.
Optional Add Card button via onAddCard callback.
Built-in loading, error (with retry), and empty states.
Customizable layout (compact vs. large), paddings, and corner radius.

Prerequisites

Complete Setup and Initialize for Android, or Setup and Initialize for iOS.
Ensure your backend provides a valid short-lived auth token.

Updated 3 months ago