Display digital cards
Overview
After Tokenization, your digital wallet application should show the end user their digital cards.
Provide a list view and a details view. Use card state, card art, and metadata to drive the UI.
SDK Integration
Retrieve card list
After Tokenization completes, the digital wallet application can retrieve and display digital cards.
Use DigitalCardManager.cardList to retrieve the list of all digitized cards.
func retrieveCardList() async {
let manager = DigitalCardManager()
do {
let cardList = try await manager.cardList
// Use cardList to populate your UI.
} catch {
// Handle errors.
}
}Retrieve a digital card
You can retrieve a DigitalCard from DigitalCardManager in several ways:
Get card details
A DigitalCard represents a digitized card. It exposes the data needed to build your UI and manage the card lifecycle:
DigitalCard.State: Digital card stateDigitalCard.CardArt: Card art dataDigitalCard.CardMetadata: Card metadata, including:Last four digits of the PAN
Last four digits of the token
PAN expiry date
DigitalCard.PaymentKeyInfo: Payment key information, including:Number of remaining payments
Whether replenishment is required
Payment key type
Payment key expiry date/time
DigitalCard.Details: Card scheme and capabilities, including:scheme: Payment scheme (Visa, Mastercard, or PURE)paymentTypesSupported: Supported payment channels
DigitalCard.paymentAccountReference: Payment Account Reference (PAR) for the primary contactless card
The following example shows how to retrieve digital card details:
Get auxiliary card details
If the card is co-badged, you can retrieve additional properties from digitalCard.
DigitalCard.hasAuxiliaryScheme: Returnstrueif the card has an auxiliary schemeDigitalCard.auxiliaryPaymentAccountReference: Payment Account Reference (PAR) for the auxiliary contactless card
If the card is co-badged, you can also read:
DigitalCard.Details.auxiliaryScheme: Auxiliary payment schemeDigitalCard.CardMetadata.auxiliaryTokenLastDigits: Last four digits of the auxiliary tokenDigitalCard.CardMetadata.auxiliaryTokenExpiry: Auxiliary token expiry dateDigitalCard.paymentKeyInfo.auxiliaryNumberOfPaymentsLeft: Remaining payments for the auxiliary scheme
If the card is not co-badged, these properties return nil.
Last updated
Was this helpful?