Handle Visa multiple AIDs

Overview

Use the NFC Wallet SDK to manage multiple Visa AIDs on a digital card.

You can:

• Detect whether a digital card exposes multiple AIDs.
• Read the AID list (sorted by priority).
• Update AID priority.
• Lock or unlock an AID.

SDK integration

Detect multiple AIDs

Use DigitalizedCard.isMultiAids().

Read AIDs

Use DigitalizedCard.getAllAids() to return a list of Aid objects.

The list is sorted by priority (highest priority first).

Each Aid includes:

• Aid.getAid(): Returns the AID as a String.
• Aid.getLabel(): Returns the label as a String.
• Aid.getLockStatus(): Returns true when the AID is locked.
• Aid.setLockStatus(boolean locked): Locks or unlocks the AID.

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

Update priority and lock status

To update priority (and optionally lock status), rebuild a list containing all AIDs in the desired priority order. Then call DigitalizedCard.updateAidList(...).

// Get a reference to a digital card using its tokenId.
DigitalizedCard digitalizedCard = DigitalizedCardManager.getDigitalizedCard(tokenId);

// Check whether this digital card exposes multiple AIDs.
if (digitalizedCard.isMultiAids()) {

    // Read all AIDs. The list is sorted by priority (highest first).
    List<Aid> aids = digitalizedCard.getAllAids();

    // Lock the highest-priority AID.
    aids.get(0).setLockStatus(true);

    // Rebuild the list in the desired priority order.
    // IMPORTANT: The updated list must contain all AIDs.
    List<Aid> updatedAids = new ArrayList<>();
    updatedAids.add(aids.get(1));
    updatedAids.add(aids.get(0));
    // Add remaining AIDs in the required order.

    // Apply both the new priority and lock status changes.
    digitalizedCard.updateAidList(updatedAids);
}