支払い鍵を補充する

概要

決済キーは、非接触決済のためのEMV暗号を計算するために必要です。

ホストカードエミュレーション（HCE）モデルでは、決済キーは一時的なものです。支払いの中断を避けるために、切れる前に補充してください。

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

NFCウォレットSDKは、さまざまな決済キーの種類をサポートします：

• SUK（シングルユースキー）：個々の取引ごとに使用される一回限りの決済キー。MastercardおよびThales EMVホワイトラベル（PURE）に適用されます。

• LUK（リミテッドユースキー）：有効期限が切れる前に複数の取引で使用できる決済キー。Visaに適用されます。

前提条件

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

オンボーディング時に次と一緒に補充しきい値を構成します Thales配信チーム.

しきい値を定義する際には次を考慮してください：

• SUK：補充をトリガーする残りのSUK数。

• LUK：残りの取引回数とLUKの有効期限時間。

SDK統合

補充が必要かどうかを検出する

次のシグナルのうち1つ（または両方）を使用します：

• プロアクティブチェック：読み取り DigitalCard.PaymentKeyInfo.needsReplenishment.

• リアクティブプッシュ（TSPトリガー）：処理 MG:ReplenishmentNeededNotification プッシュ通知を送信する TSP.

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

プロアクティブチェック

各デジタルカードについて定期的に確認します。例えば、各支払い後やアプリ起動時など。

func checkReplenishment(digitalCard: DigitalCard) async throws -> Bool {
    return try await digitalCard.paymentKeyInfo.needsReplenishment
}

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

• 後に NFCウォレットSDK 初期化。

• 支払い後。

• カードがデフォルトに設定されたとき。

• 接続が戻った後（オフライン → オンライン）。

SDKが補充が必要であると示したらただちに補充をトリガーしてください。補充が進行中の間にアプリを終了しないでください。

補充をトリガーする

呼び出す ReplenishmentService.replenish(digitalCardID:) 補充を行うと決めたときに。

func replenishment(digitalCard: DigitalCard) async {
    do {
        if try await digitalCard.paymentKeyInfo.needsReplenishment {
            let replenishmentService = ReplenishmentService()
            try await replenishmentService.replenish(digitalCardID: digitalCard.digitalCardID)
         
            // NFC Walletバックエンドは操作を確認するプッシュ通知を送信します。
            // あなたのアプリはそれを処理する必要があります。「プッシュ通知の処理」を参照してください。
        }
    } catch let error {
        switch (error as? ReplenishmentService.Error) {
            case .networkError:
                break
            case .missingWalletSecureEnrollment:
                break
            case .deviceEnvironmentUnsafe(let error):
                break
            case .clientError(let message):
                break
            case .serverError(let message):
                break
            case .unknown(let underlying):
                break
            @unknown default:
                break
        }
    }
}

補充リクエストを送信すると、 NFCウォレットバックエンド がプッシュ通知を送信します。アプリケーションがそれを処理し、SDKが新しい決済キーを取得します。

TSPトリガー 受信したとき MG:ReplenishmentNeededNotification呼び出す ReplenishmentService.replenish(digitalCardID:isForced:) 次のパラメータで isForced: true.

参照してください MG通知の処理（補充）.