デジタルカードを表示する

概要

完了後 トークン化、あなたの デジタルウォレットアプリケーション は表示する必要があります エンドユーザーに 彼らのデジタルカードを。

リストビューと詳細ビューを提供します。カードの状態、カードデザイン、およびメタデータを使用してUIを構築してください。

SDK 統合

カード一覧の取得

デジタル化が完了したら、デジタルウォレットアプリケーションはデジタルカードを取得して表示できます。

使用する DigitalCardManager.cardList を使用して、デジタル化されたすべてのカードの一覧を取得します。

デジタルカードを一覧表示する

func retrieveCardList() async {
  let manager = DigitalCardManager()
  do {
    let cardList = try await manager.cardList
    // cardList を使って UI を埋めてください。
  } catch {
    // エラーを処理します。
  }
}

デジタルカードを取得する

あなたは取得できます DigitalCard から DigitalCardManager いくつかの方法で：

デジタルカードを取得する

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

  // フルリストを一度取得し、それからローカルで要素にアクセスします。
  let cardList = try await manager.cardList

  // デフォルトカードに指定されたカードを取得します。
  let defaultCard = try await manager.defaultCard

  // リストの最初のカードを取得します。
  let firstCard = cardList.first

  // リストの最後のカードを取得します。
  let lastCard = cardList.last

  // 特定のインデックスのカードを取得します。
  // 範囲外のインデックスにアクセスするとクラッシュするので、先に検証してください。
  let index = 0
  guard cardList.indices.contains(index) else { return }
  let cardAtIndex = cardList[index]

  // リストのカウントを使って最後のカードを取得します。
  let cardCount = cardList.count
  let lastCardByIndex = cardList[cardCount - 1]

  // 特定の digitalCardID を持つカードを取得します。
  let digitalCardID = ""
  let specificCard = await manager.digitalCard(forID: digitalCardID)
}

カードの詳細を取得する

A DigitalCard はデジタル化されたカードを表します。UI を構築しカードのライフサイクルを管理するために必要なデータを公開します：

• DigitalCard.State： デジタルカードの状態

• DigitalCard.CardArt： カードアートのデータ

• DigitalCard.CardMetadata： カードのメタデータ、含まれるもの：

  • PAN の下4桁

  • トークンの下4桁

  • PAN の有効期限

• DigitalCard.PaymentKeyInfo： 支払いキー情報、含まれるもの：

  • 残りの支払い回数

  • 補充が必要かどうか

  • 支払いキーの種類

  • 支払いキーの有効期限日時

• DigitalCard.Details： カードスキームと機能、含まれるもの：

  • scheme： 支払いスキーム（Visa、Mastercard、または PURE）

  • paymentTypesSupported： サポートされている支払いチャネル

次の例はデジタルカードの詳細を取得する方法を示します：

デジタルカードの詳細を取得する

func retrieveCardDetails(digitalCard: DigitalCard) async {
  do {
    // カードの状態：.active、.suspended、.inactive など。
    // .active のカードは支払いに使用できます
    // .suspended のカードは支払いを行うために有効化が必要です
    // .inactive のカードは初期の ID&V が完了していないことを意味します。
    // pendingActivationSession を使用して ID&V を再開します。
    // その他の場合、カードは使用中ではありません
    let cardState = try await digitalCard.state

    // カードアートの取得
    let cardArt = try await digitalCard.cardArt
    let bitmap = try await cardArt.bitmap(forArtType: .cardBackgroundCombined)
    // アートの種類：.bankLogo、.schemeLogo、.cardBackground、.cardBackgroundCombined、.coBrandLogo、.cardIcon。

    // カードメタデータの取得
    let cardMetadata = try await digitalCard.cardMetadata
    let panLastDigits = cardMetadata.panLastDigits
    let panExpiry = cardMetadata.panExpiry

    // カードの支払いキー情報
    let paymentKeyInfo = try await digitalCard.paymentKeyInfo
    let numberOfPaymentsLeft = paymentKeyInfo.numberOfPaymentsLeft
    let needsReplenishment = paymentKeyInfo.needsReplenishment

    // カードの詳細
    let cardDetail = try await digitalCard.details
    let scheme = cardDetail.scheme
    let supportedPaymentTypes = cardDetail.paymentTypesSupported

  } catch {
    // エラーを処理します。
  }
}

補助カードの詳細を取得する

カードが共通ブランド（コブランディング）されている場合、追加のプロパティを取得できます digitalCard.

• DigitalCard.hasAuxiliaryScheme： 次を返します true カードに補助スキームがある場合

カードが共通ブランドの場合、次も読み取ることができます：

• DigitalCard.Details.auxiliaryScheme： 補助の支払いスキーム

• DigitalCard.CardMetadata.auxiliaryTokenLastDigits： 補助トークンの下4桁

• DigitalCard.CardMetadata.auxiliaryTokenExpiry： 補助トークンの有効期限日

• DigitalCard.paymentKeyInfo.auxiliaryNumberOfPaymentsLeft： 補助スキームの残りの支払い回数

カードが共通ブランドでない場合、これらのプロパティは返します nil.

補助スキームの詳細を取得する

// コブランディングカードの追加の詳細
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

  // カードがコブランディングでない場合、これらの値は `nil` です。
}