Welcome to our new developer portal! Use the "Ask" button to chat with our AI Agent.
For the complete documentation index, see llms.txt. This page is also available as Markdown.

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).

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(_:).

Example

This example reorders AIDs and locks one AID.

digitalCard.aidInfoList returns a copy of AIDInfo.

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

Last updated

Was this helpful?