Mostrar tarjetas digitales

Resumen

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

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

Integración del SDK

Recuperar lista de tarjetas

Después de que la digitalización se complete, la aplicación de billetera digital puede recuperar y mostrar las tarjetas digitales.

Use 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 desde DigitalCardManager de varias maneras:

Obtener una tarjeta digital

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

  // Obtenga la lista completa una vez, 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 en la lista.
  let firstCard = cardList.first

  // Obtenga la última tarjeta en 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]

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

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

Obtener detalles de la tarjeta

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

• DigitalCard.State: Estado de la tarjeta digital

• DigitalCard.CardArt: Datos del arte de la tarjeta

• DigitalCard.CardMetadata: Metadatos de la tarjeta, incluyendo:

  • Últimos cuatro dígitos del PAN

  • Últimos cuatro dígitos del token

  • Fecha de caducidad del PAN

• DigitalCard.PaymentKeyInfo: Información de la clave de pago, incluyendo:

  • Número de pagos restantes

  • Si se requiere reabastecimiento

  • Tipo de clave de pago

  • Fecha/hora de caducidad de la clave de pago

• DigitalCard.Details: Esquema y capacidades de la tarjeta, incluyendo:

  • esquema: Esquema de pago (Visa, Mastercard o PURE)

  • paymentTypesSupported: Canales de pago compatibles

El siguiente ejemplo muestra cómo recuperar los detalles de la 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 pueden usarse para pago
    // las tarjetas .suspended requieren activación para poder realizar pagos
    // las tarjetas .inactive implican que la ID&V inicial no se ha completado.
    // Use pendingActivationSession para reanudar ID&V.
    // otros casos, la tarjeta no está en uso
    let cardState = try await digitalCard.state

    // recuperación del arte de la tarjeta
    let cardArt = try await digitalCard.cardArt
    let bitmap = try await cardArt.bitmap(forArtType: .cardBackgroundCombined)
    // Tipos de arte: .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

  } catch {
    // Manejar errores.
  }
}

Obtener detalles auxiliares de la tarjeta

Si la tarjeta tiene co-branding, puede recuperar propiedades adicionales de digitalCard.

• DigitalCard.hasAuxiliaryScheme: Devuelve true si la tarjeta tiene un esquema auxiliar

Si la tarjeta tiene co-branding, 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 caducidad del token auxiliar

• DigitalCard.paymentKeyInfo.auxiliaryNumberOfPaymentsLeft: Pagos restantes para el esquema auxiliar

Si la tarjeta no tiene co-branding, estas propiedades devuelven nil.

Obtener detalles del esquema auxiliar

// Detalles adicionales de tarjeta con co-branding
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

  // Estos valores son `nil` si la tarjeta no tiene co-branding.
}