ODA 証明書を更新する

概要

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

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

NFC Wallet 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 Wallet 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 次の場合でも更新するには digitalCard.needsODARenewal が false:

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

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