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

概要

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

リスト表示と詳細表示を提供します。カードの状態、カードアート、メタデータを使用して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)
}

カード詳細を取得

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

• DigitalCard.State: デジタルカードの状態
• DigitalCard.CardArt: カードアートデータ
• DigitalCard.CardMetadata: カードメタデータ。以下を含みます:

  • PANの下4桁
  • トークンの下4桁
  • PANの有効期限
• DigitalCard.PaymentKeyInfo: ペイメントキー情報。以下を含みます:

  • 残り支払い回数
  • 補充が必要かどうか
  • ペイメントキーの種類
  • ペイメントキーの有効期限日時
• DigitalCard.Details: カードスキームと機能。以下を含みます:

  • スキーム: 支払いスキーム（Visa、Mastercard、またはPURE）
  • paymentTypesSupported: 対応する支払いチャネル
• DigitalCard.paymentAccountReference: 主要な非接触カードの Payment Account Reference（PAR）

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

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

func retrieveCardDetails(digitalCard: DigitalCard) async {
  do {
    // カードの状態: .active、.suspended、.inactive など。
    // .active のカードは支払いに使用できます
    // .suspended のカードは支払いを行うために有効化が必要です
    // .inactive のカードは、初回の ID&V が完了していないことを意味します。
    // ID&V を再開するには pendingActivationSession を使用します。
    // その他の場合、カードは使用されていません
    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

    // 主要カードプロファイルの Payment Account Reference（PAR）
    let paymentAccountReference = digitalCard.paymentAccountReference
    
  } catch {
    // エラーを処理します。
  }
}

補助カード詳細を取得

カードがコバッジ対応の場合、 digitalCard.

• DigitalCard.hasAuxiliaryScheme: 返す値 true カードに補助スキームがある場合
• DigitalCard.auxiliaryPaymentAccountReference: 補助非接触カードの Payment Account Reference（PAR）

カードがコバッジ対応の場合、次も読み取れます:

• 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

  // 補助カードプロファイルの Payment Account Reference（PAR）
  let auxPaymentAccountReference = digitalCard.auxiliaryPaymentAccountReference
  
  // カードがコバッジ対応でない場合、これらの値は `nil` になります。
}