### 例
{% tabs %}
{% tab title="Android" %}
```kotlin
fun getDigitalCardList(d1Task: D1Task, cardID: String) {
val callback: D1Task.Callback> = object : D1Task.Callback> {
override fun onSuccess(digitalCardList: List) {
// サーバーから受け取った digitalCardList オブジェクトを処理します。
// たとえば、上のサンプル画像のように UI に表示します。
for (digitalCard in digitalCardList) {
val digitalCardID = digitalCard.cardID
val digitalCardState = digitalCard.state // 現在のデジタルカードの状態。
val digitalCardExp = digitalCard.expiryDate // 現在のデジタルカードの有効期限。
val last4 = digitalCard.last4 // 現在のデジタルカードの下4桁。
val tokenRequestorID = digitalCard.tokenRequestorID // トークンリクエスタ ID。
val isOnCurrentDevice = digitalCard.isOnCurrentDevice // デジタルカードが現在のデバイス上にあるかを示します。
// デバイスバインディング一覧を取得します（Visa CTF では SDK 4.3.0 以降）。
val deviceBindingList = digitalCard.deviceBindingList
deviceBindingList?.forEach { binding ->
val bindingReference = binding.bindingReference // バインディング参照 ID。
val deviceName = binding.deviceName // デバイス名。
val bindingStatus = binding.bindingStatus // APPROVED、DECLINED、または CHALLENGED。
}
}
}
override fun onError(exception: D1Exception) {
// D1 SDK 統合 – エラー管理のセクションを参照してください。
}
}
d1Task.getDigitalCardList(cardID, callback)
}
```
{% endtab %}
{% tab title="iOS >= 4.5.0" %}
```swift
let cardID = "" // サーバーなどから取得
do {
let service = try d1Task.digitalCardService()
let digitalCards = try await service.digitalCardList(cardID)
// 以降のフローに進みます。たとえば UI を更新します
for digitalCard in digitalCards {
print("デジタルカードID: \(digitalCard.cardID)")
print("状態: \(digitalCard.state.rawValue)")
print("下4桁: \(digitalCard.last4 ?? "")")
print("有効期限: \(digitalCard.expiryDate ?? "")")
print("デバイスID: \(digitalCard.deviceID ?? "")")
print("デバイス名: \(digitalCard.deviceName ?? "")")
print("デバイスタイプ: \(digitalCard.deviceType ?? "")")
print("トークンリクエスタ ID: \(digitalCard.tokenRequestorID ?? "")")
print("トークンリクエスタ名: \(digitalCard.tokenRequestorName ?? "")")
print("isOnCurrentDevice: \(digitalCard.isOnCurrentDevice)")
// デバイスバインディング一覧にアクセスします（SDK 4.3.0 以降）
if let deviceBindingList = digitalCard.deviceBindingList {
for binding in deviceBindingList {
print("バインディング参照: \(binding.bindingReference ?? "")")
print("デバイス名: \(binding.deviceName ?? "")")
print("バインディング状態: \(binding.bindingStatus?.rawValue ?? "")")
}
}
}
} catch let d1Error as D1Error {
// D1 SDK 統合 – エラー管理のセクションを参照してください
} catch let error {
// その他のエラーを処理します
}
```
{% endtab %}
{% tab title="iOS < 4.5.0" %}
```swift
let cardID = "" // たとえばサーバーから取得します。
d1Task.digitalCardList(cardID) { digitalCards, error in
if let error = error {
// D1 SDK 統合 – エラー管理のセクションを参照してください。
} else if let digitalCards = digitalCards {
// その後のフローに進みます。たとえば UI を更新します。
for digitalCard in digitalCards {
print("デジタルカードID: \(digitalCard.cardID)")
print("状態: \(digitalCard.state.rawValue)")
print("下4桁: \(digitalCard.last4 ?? "")")
print("有効期限: \(digitalCard.expiryDate ?? "")")
print("デバイスID: \(digitalCard.deviceID ?? "")")
print("デバイス名: \(digitalCard.deviceName ?? "")")
print("デバイスタイプ: \(digitalCard.deviceType ?? "")")
print("TokenRequestorID: \(digitalCard.tokenRequestorID ?? "")")
print("isOnCurrentDevice: \(digitalCard.isOnCurrentDevice)")
// デバイスバインディング一覧を取得します（Visa CTF では SDK 4.3.0 以降）。
if let deviceBindingList = digitalCard.deviceBindingList {
for binding in deviceBindingList {
print("バインディング参照: \(binding.bindingReference ?? "")")
print("デバイス名: \(binding.deviceName ?? "")")
print("バインディング状態: \(binding.bindingStatus?.rawValue ?? "")")
}
}
}
}
}
```
{% endtab %}
{% endtabs %}
## デジタルカードを制御する
イシュアアプリケーションは、エンドユーザーが各デジタルカードの状態を管理できるようにできます。
サポートされる操作は次のとおりです。
* **一時停止** 現在の状態が有効である場合のデジタルカード： `d1Task.updateDigitalCard(cardID, digitalCard, CardAction.SUSPEND, callback)`
* **再開** 現在の状態が停止中である場合のデジタルカード： `d1Task.updateDigitalCard(cardID, digitalCard, CardAction.RESUME, callback)`
* **削除** デジタルカード： `d1Task.updateDigitalCard(cardID, digitalCard, CardAction.DELETE, callback)`
* **有効化** デジタルカード（例：ステップアップ認証後）： `d1PushWallet.activateDigitalCard(digitalCard.getCardID(), callback)`
### シーケンス図
**前提条件**
* 顧客アカウントとカードが D1 に登録済み
* SDK が適切に初期化されている
* イシュアアプリが D1 SDK のログイン API を呼び出した
デジタルカードの状態を制御するためのイシュアアプリケーション UI の例。
### 例
{% tabs %}
{% tab title="Android" %}
```kotlin
// digitalCard: getDigitalCardList API から取得
fun controlDigitalCard(d1Task: D1Task, cardID: String, digitalCard: DigitalCard) {
val callback: D1Task.Callback = object : D1Task.Callback {
override fun onSuccess(isSuccess: Boolean) {
if (isSuccess) {
// デジタルカードの状態は正常に更新されました。
// アプリケーションで UI を更新できます。
} else {
// デジタルカードの状態の更新に失敗しました。
}
}
override fun onError(exception: D1Exception) {
// D1 SDK 統合 – エラー管理のセクションを参照してください。
}
}
// デジタルカードの現在の状態が ACTIVE の場合
d1Task.updateDigitalCard(cardID, digitalCard, CardAction.SUSPEND, callback)
}
```
{% endtab %}
{% tab title="iOS >= 4.5.0" %}
```swift
let cardID = "" // サーバーなどから取得
// デジタルカードの現在の状態が ACTIVE の場合
// digitalCard は D1Task.digitalCardList API から取得されます
do {
let service = try d1Task.digitalCardService()
try await service.updateDigitalCard(cardID, digitalCard: digitalCard, action: .suspend)
} catch let d1Error as D1Error {
// D1 SDK 統合 – エラー管理のセクションを参照してください
} catch let error {
// その他のエラーを処理します
}
```
{% endtab %}
{% tab title="iOS < 4.5.0" %}
```swift
let cardID = "" // サーバーなどから取得
// デジタルカードの現在の状態が ACTIVE の場合
// digitalCard は D1Task.digitalCardList API から取得されます
d1Task.updateDigitalCard(cardID, digitalCard: digitalCard, action: .suspend) { isSuccess, error in
if let error = error {
// D1 SDK 統合 – エラー管理のセクションを参照してください
} else {
if isSuccess {
// 以降のフローに進みます。たとえば UI を更新します
} else {
// 失敗の原因は、無効な状態である可能性があります。たとえば、有効なカードを有効状態に更新する場合などです
}
}
}
```
{% endtab %}
{% endtabs %}
D1 SDK を完全に利用するには、 [API リファレンス](/push-provisioning/ja/integrate-the-d1-sdk/api-reference.md).
---
# 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/push-provisioning/ja/implement-push-provisioning/implement-view-and-control/view-and-control-digital-cards.md?ask=&goal=
```
`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.
