デジタルカードのLCMを管理する

概要

デジタルカードのライフサイクル（LCM）を管理するために、デジタルウォレットアプリケーションで NFC Wallet SDK を使用します。

主なユースケース:

• デジタルウォレットアプリケーションからデジタルカードを削除する

開始する前に、以下で説明されているようにアクセストークンを取得する必要があります アクセストークンを取得する.

このセクションでは、デジタルウォレットアプリケーションから開始される LCM アクションについて説明します。イシュアバックエンドは、TSP と直接デジタルカード LCM を開始することもできます。

SDK 連携

使用する MGCardLifeCycleManager およびデジタルカード ID を使用して LCM アクションをトリガーします。

実装する MGCardLifecycleEventListener を処理するための onSuccess と onError コールバック。

サポートされているアクション:

• deleteCard
• suspendCard
• resumeCard

onSuccess は、NFC Wallet SDK がリクエストを受け入れたことを確認します。デジタルウォレットアプリケーションは、プッシュ通知を受信した後に更新されます。

からの変更は NFC Wallet バックエンド デジタルウォレットアプリケーションにはすぐには表示されません。

NFC Wallet バックエンド は、デジタルカードの状態を同期するためにプッシュ通知を送信します。

参照 プッシュ通知の処理.

デジタルカードを削除する

を使用してデジタルカードを削除する MGCardLifeCycleManager.deleteCard(...).

カードを削除すると、デジタルウォレットアプリケーションからそのカードが完全に削除されます。

DeleteCard.java

// アクセストークンを取得します
String accessToken = "....";

// カードライフサイクルマネージャーを取得します。
MGCardLifeCycleManager cardLifeCycleManager = MGClient.getCardLifeCycleManager();

// デジタルカード ID を使用してカードを削除します。
cardLifeCycleManager.deleteCard(
    digitalCardId,
    new MGCardLifecycleEventListener() {
        @Override
        public void onSuccess(String digitalCardId) {
            /*
             * リクエストは NFC Wallet SDK に受け入れられました。
             * NFC Wallet バックエンドが、操作を完了するためのプッシュ通知を送信します。
             *
             * カードがサーバー側ですでに削除されている場合、SDK はローカルのカードデータを削除します。
             */
        }

        @Override
        public void onError(String digitalCardId, MobileGatewayError error) {
            /*
             * リクエストに失敗しました。
             * 原因を特定するには MobileGatewayError を確認してください。
             */
        }
    },
    null,
    null,
    accessToken );

後、 イシュアのバックエンドが または デジタルウォレットアプリケーション が削除リクエストを開始すると、デジタルカードは一時的に次のように表示されることがあります RETIRED状態。

この間、 DigitalizedCardManager#getAllCards() は引き続きカードを返すことがあります。

SDK がローカルストレージからカードを削除すると、そのカードはリストから消えます。

デジタルカードを一時停止する

を使用してデジタルカードを一時停止する MGCardLifeCycleManager.suspendCard(...).

デジタルカードを再開する

を使用してデジタルカードを再開する MGCardLifeCycleManager.resumeCard(...).