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

概要

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

主なユースケース：

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

開始する前に、次に記載されている方法でアクセストークンを取得してください。 アクセストークンを取得する.

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

SDK の統合

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

実装する 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(...).