ODA証明書を更新する

概要

オフラインデータ認証（ODA）は、Visaの非接触決済中にODA証明書を使用する場合があります。

支払いの中断を避けるために、証明書の有効期限が切れる前にODA証明書を更新してください。

NFCウォレットSDKは、VisaのODA証明書更新のみをサポートします。

SDK 統合

更新が必要かどうかを確認する

使用する DigitalCard デジタルカードがODAをサポートしているか、またその証明書が有効期限切れかどうかを確認するには：

• DigitalCard.isODASupported: Bool

• DigitalCard.needsODARenewal: Bool

guard let digitalCard = await digitalCardManager.digitalCard(forID: digitalCardID) else { return }
let isODASupported = await digitalCard.isODASupported
let needsODARenewal = await digitalCard.needsODARenewal

guard isODASupported else { return }
guard needsODARenewal else { return }

// 証明書を更新します。

この確認を行ってください：

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

• 支払い後。

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

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

ODA証明書を更新する

使用する ODARenewalService VisaデジタルカードのODA証明書を更新するには：

• ODARenewalService.renewIfNeeded(digitalCardID: String, isForced: Bool)

try await odaRenewalService.renewIfNeeded(digitalCardID: digitalCard.digitalCardID)

エンドユーザーの体験を向上させるために、予測可能なタイミングで更新をトリガーしてください：

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

• 支払いが完了した後。

renewIfNeeded() は両方を確認します digitalCard.isODASupported および digitalCard.needsODARenewal.

事前の別の確認なしに直接呼び出すことができます。

renewIfNeeded() 次の場合は何もしません：

• この digitalCard Visaカードではない。

• digitalCard.isODASupported は false.

• digitalCard.needsODARenewal は false.

を設定する isForced に true がfalseのときでも更新するために digitalCard.needsODARenewal は false:

try await odaRenewalService.renewIfNeeded(
    digitalCardID: digitalCard.digitalCardID,
    isForced: true
)

のデフォルト値は isForced は false.