> For the complete documentation index, see [llms.txt](https://docs.payments.thalescloud.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.payments.thalescloud.io/nfc-wallet-sdk-ios/ja/implement-nfc-wallet/manage-digital-cards/display-digital-cards.md).

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

## 概要

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

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

## SDK 統合

### カード一覧の取得

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

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

<pre class="language-swift" data-title="デジタルカードを一覧表示する"><code class="lang-swift">func retrieveCardList() async {
  let manager = DigitalCardManager()
  do {
    let cardList = try await manager.cardList
    // cardList を使って UI を埋めてください。
  } catch {
<strong>    // エラーを処理します。
</strong>  }
}
</code></pre>

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

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

{% code title="デジタルカードを取得する" %}

```swift
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)
}
```

{% endcode %}

### カードの詳細を取得する

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

* `DigitalCard.State`： デジタルカードの状態
* `DigitalCard.CardArt`： カードアートのデータ
* `DigitalCard.CardMetadata`： カードのメタデータ、含まれるもの：
  * PAN の下4桁
  * トークンの下4桁
  * PAN の有効期限
* `DigitalCard.PaymentKeyInfo`： 支払いキー情報、含まれるもの：
  * 残りの支払い回数
  * 補充が必要かどうか
  * 支払いキーの種類
  * 支払いキーの有効期限日時
* `DigitalCard.Details`： カードスキームと機能、含まれるもの：
  * `scheme`： 支払いスキーム（Visa、Mastercard、または PURE）
  * `paymentTypesSupported`： サポートされている支払いチャネル

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

{% code title="デジタルカードの詳細を取得する" %}

```swift
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 {
    // エラーを処理します。
  }
}
```

{% endcode %}

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

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

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

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

* `DigitalCard.Details.auxiliaryScheme`： 補助の支払いスキーム
* `DigitalCard.CardMetadata.auxiliaryTokenLastDigits`： 補助トークンの下4桁
* `DigitalCard.CardMetadata.auxiliaryTokenExpiry`： 補助トークンの有効期限日
* `DigitalCard.paymentKeyInfo.auxiliaryNumberOfPaymentsLeft`： 補助スキームの残りの支払い回数

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

{% code title="補助スキームの詳細を取得する" %}

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

{% endcode %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.payments.thalescloud.io/nfc-wallet-sdk-ios/ja/implement-nfc-wallet/manage-digital-cards/display-digital-cards.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.