Mostrar tarjetas digitales

Descripción general

Después de Tokenización, su aplicación de billetera digital debería mostrar al usuario final sus tarjetas digitales.

Proporcione una vista de lista y una vista de detalles. Use el estado de la tarjeta, la imagen de la tarjeta y los metadatos para controlar la interfaz de usuario.

Integración del SDK

Recuperar la lista de tarjetas

Después de Tokenización se completa, el aplicación de billetera digital puede recuperar y mostrar tarjetas digitales.

Usar DigitalCardManager.cardList para recuperar la lista de todas las tarjetas digitalizadas.

Listar tarjetas digitales

func retrieveCardList() async {
  let manager = DigitalCardManager()
  do {
    let cardList = try await manager.cardList
    // Use cardList para poblar su interfaz de usuario.
  } catch {
    // Manejar errores.
  }
}

Recuperar una tarjeta digital

Puede recuperar una DigitalCard de DigitalCardManager de varias maneras:

Obtener una tarjeta digital

func getDigitalCards() async throws {
  let manager = DigitalCardManager()

  // Obtenga la lista completa una vez y luego acceda a los elementos localmente.
  let cardList = try await manager.cardList

  // Obtenga la tarjeta designada como tarjeta predeterminada.
  let defaultCard = try await manager.defaultCard

  // Obtenga la primera tarjeta de la lista.
  let firstCard = cardList.first

  // Obtenga la última tarjeta de la lista.
  let lastCard = cardList.last

  // Recuperar la tarjeta en un índice específico.
  // Acceder a un índice fuera de rango provocará un fallo, así que valide primero.
  let index = 0
  guard cardList.indices.contains(index) else { return }
  let cardAtIndex = cardList[index]

  // Recupere la última tarjeta usando el recuento de la lista.
  let cardCount = cardList.count
  let lastCardByIndex = cardList[cardCount - 1]

  // Recupere la tarjeta con un digitalCardID específico.
  let digitalCardID = ""
  let specificCard = await manager.digitalCard(forID: digitalCardID)
}

Obtener detalles de la tarjeta

Una DigitalCard representa una tarjeta digitalizada. Expone los datos necesarios para construir su interfaz de usuario y administrar el ciclo de vida de la tarjeta:

• DigitalCard.State: Estado de la tarjeta digital
• DigitalCard.CardArt: Datos de la imagen de la tarjeta
• DigitalCard.CardMetadata: Metadatos de la tarjeta, incluidos:

  • Últimos cuatro dígitos del PAN
  • Últimos cuatro dígitos del token
  • Fecha de vencimiento del PAN
• DigitalCard.PaymentKeyInfo: Información de la clave de pago, incluida:

  • Número de pagos restantes
  • Si se requiere recarga
  • Tipo de clave de pago
  • Fecha/hora de vencimiento de la clave de pago
• DigitalCard.Details: Esquema y capacidades de la tarjeta, incluidos:

  • scheme: Esquema de pago (Visa, Mastercard o PURE)
  • paymentTypesSupported: Canales de pago compatibles
• DigitalCard.paymentAccountReference: Referencia de cuenta de pago (PAR) para la tarjeta principal sin contacto

El siguiente ejemplo muestra cómo recuperar los detalles de una tarjeta digital:

Obtener detalles de la tarjeta digital

func retrieveCardDetails(digitalCard: DigitalCard) async {
  do {
    // estados de la tarjeta: .active, .suspended, .inactive, etc.
    // las tarjetas .active se pueden usar para pagar
    // las tarjetas .suspended requieren activación para poder realizar pagos
    // las tarjetas .inactive implican que el ID&V inicial no se ha completado.
    // Use pendingActivationSession para reanudar el ID&V.
    // otros casos, la tarjeta no está en uso
    let cardState = try await digitalCard.state

    // recuperación de la imagen de la tarjeta
    let cardArt = try await digitalCard.cardArt
    let bitmap = try await cardArt.bitmap(forArtType: .cardBackgroundCombined)
    // Tipos de imagen: .bankLogo, .schemeLogo, .cardBackground, .cardBackgroundCombined, .coBrandLogo, .cardIcon.

    // recuperación de metadatos de la tarjeta
    let cardMetadata = try await digitalCard.cardMetadata
    let panLastDigits = cardMetadata.panLastDigits
    let panExpiry = cardMetadata.panExpiry

    // información de la clave de pago de la tarjeta
    let paymentKeyInfo = try await digitalCard.paymentKeyInfo
    let numberOfPaymentsLeft = paymentKeyInfo.numberOfPaymentsLeft
    let needsReplenishment = paymentKeyInfo.needsReplenishment

    // detalles de la tarjeta
    let cardDetail = try await digitalCard.details
    let scheme = cardDetail.scheme
    let supportedPaymentTypes = cardDetail.paymentTypesSupported

    // Referencia de cuenta de pago (PAR) para el perfil principal de la tarjeta
    let paymentAccountReference = digitalCard.paymentAccountReference
    
  } catch {
    // Manejar errores.
  }
}

Obtener detalles adicionales de la tarjeta

Si la tarjeta es de doble marca, puede recuperar propiedades adicionales de digitalCard.

• DigitalCard.hasAuxiliaryScheme: Devuelve true si la tarjeta tiene un esquema auxiliar
• DigitalCard.auxiliaryPaymentAccountReference: Referencia de cuenta de pago (PAR) para la tarjeta auxiliar sin contacto

Si la tarjeta es de doble marca, también puede leer:

• DigitalCard.Details.auxiliaryScheme: Esquema de pago auxiliar
• DigitalCard.CardMetadata.auxiliaryTokenLastDigits: Últimos cuatro dígitos del token auxiliar
• DigitalCard.CardMetadata.auxiliaryTokenExpiry: Fecha de vencimiento del token auxiliar
• DigitalCard.paymentKeyInfo.auxiliaryNumberOfPaymentsLeft: Pagos restantes para el esquema auxiliar

Si la tarjeta no es de doble marca, estas propiedades devuelven nil.

Obtener detalles del esquema auxiliar

// Detalles adicionales de la tarjeta de doble marca
let details = try await digitalCard.details
let cardMetadata = try await digitalCard.cardMetadata
let paymentKeyInfo = try await digitalCard.paymentKeyInfo

if digitalCard.hasAuxiliaryScheme {
  let auxScheme = details.auxiliaryScheme

  let auxTokenLastDigits = cardMetadata.auxiliaryTokenLastDigits
  let auxTokenExpiry = cardMetadata.auxiliaryTokenExpiry

  let auxNumPaymentsLeft = paymentKeyInfo.auxiliaryNumberOfPaymentsLeft

  // Referencia de cuenta de pago (PAR) para el perfil de la tarjeta auxiliar
  let auxPaymentAccountReference = digitalCard.auxiliaryPaymentAccountReference
  
  // Estos valores son `nil` si la tarjeta no es de doble marca.
}