Handle Visa Multiple AIDs

Overview

Use the NFC Wallet SDK to handle Visa Multiple AIDs.

You can read the available AIDs. You can also update AID priority and lock status.

SDK Integration

Application identifiers (AIDs) are exposed through DigitalCard.aidInfoList: [AIDInfo].

To detect multiple AIDs, check DigitalCard.isMultiAID: Bool.

Retrieve AID information

DigitalCard.aidInfoList: [AIDInfo] returns an array of AIDInfo objects.

Each AIDInfo includes the AID and metadata:

• AIDInfo.aid: The AID as a String.
• AIDInfo.label: The label as a String.
• AIDInfo.lockStatus: The AID status: .locked or .unlocked (default).

Only Visa cards are supported.

When called on a non-Visa card:

• DigitalCard.isMultiAID always returns false.
• DigitalCard.aidInfoList and DigitalCard.setAIDInfoList(_:) throw clientError.

A terminal returns status word 6A81 when it sends SELECT to a locked AID.

Update AID priority and lock status

Use the AIDInfo objects from aidInfoList when you build an updated list.

AIDInfo.lockStatus is mutable. You can also reorder the list to change AID priority.

The first element in the list has the highest priority.

To update AID configuration:

1. Use the DigitalCard.aidInfoList: [AIDInfo] API to retrieve the AIDInfo from the digital card.
2. Create a new array and update order and/or lockStatus.
3. Apply the update using DigitalCard.setAIDInfoList(_:).

When setting a new list, keep the same AIDInfo elements.

Do not add, remove, or change AIDs or labels. Otherwise, DigitalCard.Error.aidInfoListMismatch is thrown.

Example

This example reorders AIDs and locks one AID.

var aidInfoList = try await digitalCard.aidInfoList
let isMultiAID = try await digitalCard.isMultiAID
  
var newAIDInfoList: [AIDInfo] = []

// Reorder the items as necessary:
newAIDInfoList.append(aidInfoList[3])
newAIDInfoList.append(aidInfoList[0])
newAIDInfoList.append(aidInfoList[1])
newAIDInfoList.append(aidInfoList[2])

// If the items do not need to be reordered,
// we can simply create a new copy from the original:
newAIDInfoList = aidInfoList

// Change the lockStatus of the AIDs as necessary:
newAIDInfoList[0].lockStatus = .locked
newAIDInfoList[1].lockStatus = .unlocked

// Set the new array of `AIDInfo` objects into the digitalCard:
try await digitalCard.setAIDInfoList(newAIDInfoList)

digitalCard.aidInfoList returns a copy of AIDInfo.

Mutating the array does not update the digital card. Call setAIDInfoList(_:) for changes to take effect.