支払いキーを再補充する

概要

コンタクトレス決済のEMV暗号を算出するには、支払いキー（SUKまたはLUK）が必要です。

ホストカードエミュレーション（HCE）モデルでは、支払いキーは一時的です。枯渇する前に補充してください。これにより決済の中断を防げます。

このガイドは、いつ補充するかとそのトリガー方法を説明します。

NFCウォレットSDKは次の支払いキータイプをサポートします：

SUK（シングルユースキー）：取引ごとに1つのキーを使用します。MastercardおよびPURE（ホワイトラベルEMV）で使用されます。
LUK（リミテッドユースキー）：複数の取引で1つのキーを使用します。Visaで使用されます。

前提条件

補充しきい値の設定（オンボーディング）

オンボーディング時に補充しきい値を設定します（ Thales配信チーム.

しきい値を定義する際に考慮する点：

SUK：補充をトリガーする残りのSUK数。
LUK：残りの取引回数とLUKの有効期限。

SDK統合

補充が必要かを検出する

次の信号のいずれか（一方または両方）を使用します：

プロアクティブチェック：デジタルカードのステータスを読み取ります。
リアクティブプッシュ（TSPトリガー）：処理 MG:ReplenishmentNeededNotification からの TSP.

プッシュ配信とルーティングについては、こちらを参照してください：プッシュ通知の処理.

プロアクティブチェック

このチェックは各デジタルカードごとに実行します。アプリ起動時または支払い後に実行してください。

取得するもの DigitalizedCardStatus から DigitalizedCard.
呼び出す DigitalizedCardStatus.needsReplenishment().

参照：デジタルカードの表示.

デジタルカードが補充を必要とするかどうかを確認する

public static boolean needsReplenishment(final DigitalizedCard card) {
    AsyncResult<DigitalizedCardStatus> result =
            card.getCardState(null).waitToComplete();

    if (!result.isSuccessful()) {
        // TODO: エラーを処理する
        return false;
    }

    DigitalizedCardStatus status = result.getResult();
    return status != null && status.needsReplenishment();
}

このプロアクティブチェックを実行する：

定期的なアプリケーション起動時に
- アプリケーションが支払いのために起動されている場合はチェックを実行しないでください - 下の警告を参照
支払い後に
- イベント時に onNextTransactionReady - 参照：コンタクトレス支払いコールバックを実装する.
カードがデフォルトに設定されたとき。
接続が復帰した後（オフライン → オンライン）。

このチェックは、次の後にアプリ起動時に実行してください： NFCウォレットSDK 初期化。

エンドユーザーがコンタクトレス支払いを行うためにアプリを起動した場合にはこのチェックを実行しないでください。支払いの実行が遅延する可能性があります。

補充をトリガーする

呼び出す ProvisioningBusinessService.sendRequestForReplenishment(...) を使用して新しい支払いキーをリクエストします。

カード識別子を取得します。
使用する： トークン化されたカードID - 参照：デジタルカードを表示.

補充リクエストを送信します。

呼び出す sendRequestForReplenishment(...) を呼び出し、次を実装します： PushServiceListener:

onComplete：リクエストが受理されました。
onError： SDKがリクエストを送信できません。次を確認してください： ProvisioningServiceError.

補充リクエストを送信する

public void replenish(final String tokenizedCardId, final boolean forced) {
    ProvisioningBusinessService service =
            ProvisioningServiceManager.getProvisioningBusinessService();

    service.sendRequestForReplenishment(
            tokenizedCardId,
            new ReplenishmentListener(),
            forced
    );
}

private static class ReplenishmentListener implements PushServiceListener {
    @Override
    public void onComplete() {
        // TODO: 成功をログに記録する
    }

    @Override
    public void onError(final ProvisioningServiceError error) {
        // TODO: エラーをログに記録する
    }

    @Override
    public void onUnsupportedPushContent(final Bundle bundle) {
        // この呼び出しでは使用されません。
    }

    @Override
    public void onServerMessage(final String tokenizedCardId,
                                final ProvisioningServiceMessage message) {
        // この呼び出しでは使用されません。
    }
}

補充プッシュを処理する。
リクエストを送信すると、NFCウォレットのバックエンドがプッシュ通知を送信します。あなたの デジタルウォレットアプリケーション はそれを処理する必要があります。SDKはその後新しい支払いキーを取得します。

補充が進行中の間は、を終了しないでください。 デジタルウォレットアプリケーション （進行中に終了してはいけません）

TSPトリガーによる補充

を受信したとき、 MG:ReplenishmentNeededNotificationforced = true で補充をトリガーします。.

参照： MG通知（補充）を処理する.

前へ取引履歴を取得する次へODA証明書を更新する

最終更新 3 か月前

役に立ちましたか？