Gestionar múltiples AID de Visa

Resumen

Usa el SDK de NFC Wallet para gestionar varios AID de Visa en una tarjeta digital.

Puedes:

• Detectar si una tarjeta digital expone varios AID.
• Leer la lista de AID (ordenada por prioridad).
• Actualizar la prioridad del AID.
• Bloquear o desbloquear un AID.

Integración del SDK

Detectar varios AID

Use DigitalizedCard.isMultiAids().

Leer AID

Use DigitalizedCard.getAllAids() para devolver una lista de Aid objetos.

La lista está ordenada por prioridad (la prioridad más alta primero).

Cada Aid incluye:

• Aid.getAid(): Devuelve el AID como un String.
• Aid.getLabel(): Devuelve la etiqueta como un String.
• Aid.getLockStatus(): Devuelve true cuando el AID está bloqueado.
• Aid.setLockStatus(boolean locked): Bloquea o desbloquea el AID.

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

Actualizar la prioridad y el estado de bloqueo

Para actualizar la prioridad (y opcionalmente el estado de bloqueo), reconstruye una lista que contenga todos los AID en el orden de prioridad deseado. Luego llama a DigitalizedCard.updateAidList(...).

// Obtén una referencia a una tarjeta digital usando su tokenId.
DigitalizedCard digitalizedCard = DigitalizedCardManager.getDigitalizedCard(tokenId);

// Comprueba si esta tarjeta digital expone varios AID.
if (digitalizedCard.isMultiAids()) {

    // Lee todos los AID. La lista está ordenada por prioridad (la más alta primero).
    List<Aid> aids = digitalizedCard.getAllAids();

    // Bloquea el AID con la prioridad más alta.
    aids.get(0).setLockStatus(true);

    // Reconstruye la lista en el orden de prioridad deseado.
    // IMPORTANTE: La lista actualizada debe contener todos los AID.
    List<Aid> updatedAids = new ArrayList<>();
    updatedAids.add(aids.get(1));
    updatedAids.add(aids.get(0));
    // Añade los AID restantes en el orden requerido.

    // Aplica tanto la nueva prioridad como los cambios de estado de bloqueo.
    digitalizedCard.updateAidList(updatedAids);
}