Gestionar múltiples AID de Visa

Resumen

Use el SDK de Billetera NFC para gestionar AIDs múltiples de Visa.

Puede leer los AIDs disponibles. También puede actualizar la prioridad y el estado de bloqueo del AID.

Integración del SDK

Los identificadores de aplicación (AIDs) se exponen a través de DigitalCard.aidInfoList: [AIDInfo].

Para detectar AIDs múltiples, compruebe DigitalCard.isMultiAID: Bool.

Recuperar información del AID

DigitalCard.aidInfoList: [AIDInfo] devuelve un arreglo de AIDInfo objetos.

Cada AIDInfo incluye el AID y metadatos:

• AIDInfo.aid: El AID como un Cadena.

• AIDInfo.label: La etiqueta como un Cadena.

• AIDInfo.lockStatus: El estado del AID: .locked o .unlocked (predeterminado).

Solo se admiten tarjetas Visa.

Cuando se llama en una tarjeta que no es Visa:

• DigitalCard.isMultiAID siempre devuelve false.

• DigitalCard.aidInfoList y DigitalCard.setAIDInfoList(_:) lanza clientError.

Un terminal devuelve la palabra de estado 6A81 cuando envía SELECT a un AID bloqueado.

Actualizar la prioridad y el estado de bloqueo del AID

Use el AIDInfo objetos de aidInfoList cuando construya una lista actualizada.

AIDInfo.lockStatus es mutable. También puede volver a ordenar la lista para cambiar la prioridad del AID.

El primer elemento de la lista tiene la máxima prioridad.

Para actualizar la configuración del AID:

1. Use el DigitalCard.aidInfoList: [AIDInfo] API para recuperar el AIDInfo de la tarjeta digital.

2. Cree un nuevo arreglo y actualice el orden y/o lockStatus.

3. Aplique la actualización usando DigitalCard.setAIDInfoList(_:).

Al establecer una nueva lista, conserve los mismos AIDInfo elementos.

No agregue, elimine ni cambie AIDs o etiquetas. De lo contrario, DigitalCard.Error.aidInfoListMismatch es lanzado.

Ejemplo

Este ejemplo reordena AIDs y bloquea un AID.

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

// Reordene los elementos según sea necesario:
newAIDInfoList.append(aidInfoList[3])
newAIDInfoList.append(aidInfoList[0])
newAIDInfoList.append(aidInfoList[1])
newAIDInfoList.append(aidInfoList[2])

// Si los elementos no necesitan reordenarse,
// podemos simplemente crear una nueva copia del original:
newAIDInfoList = aidInfoList

// Cambie el lockStatus de los AIDs según sea necesario:
newAIDInfoList[0].lockStatus = .locked
newAIDInfoList[1].lockStatus = .unlocked

// Establezca el nuevo arreglo de objetos `AIDInfo` en el digitalCard:
try await digitalCard.setAIDInfoList(newAIDInfoList)

digitalCard.aidInfoList devuelve una copia de AIDInfo.

Mutar el arreglo no actualiza la tarjeta digital. Llame a setAIDInfoList(_:) para que los cambios surtan efecto.