ウォレット取引データを追加する

概要

ウォレットのトランザクションデータを非接触決済に添付できます。

イシュアのバックエンドは、このデータを承認処理中に使用できます。

ウォレットのトランザクションデータは、デジタルカードごとに定義されます。

デジタルウォレットアプリケーションは、これを次の2つのモードで提供できます:

• 永続: NFC Wallet SDK はデータをセキュアストレージに保存します。アプリケーションの再起動後も保持されます。

• 一時的: デジタルウォレットアプリケーションは、その1回のトランザクションに対する値のみを提供します。

デジタルウォレットアプリケーションは、各支払いにウォレットのトランザクションデータを含めるかどうかを決定します。

NFC Wallet SDK は、Mastercard および PURE の非接触プロファイルでのみウォレットのトランザクションデータをサポートします。

Mastercard 仕様（MCBP 2.3）

NFC Wallet SDK は Mastercard 仕様をサポートします MCBP 2.3.

非接触トランザクションの前にウォレットのトランザクションデータが利用可能な場合、NFC Wallet SDK は次を更新します IAD （EMVタグ 9F10、イシュアアプリケーションデータ）:

• 開始オフセット: 19バイト目

• IADの最大長: 32バイト

• ウォレットのトランザクションデータの最大長: 14バイト

MCBP 2.3 では、この機能は次のように呼ばれます ウォレット独自情報.

PURE 仕様

NFC Wallet SDK は、PURE の非接触プロファイルに対してもウォレットのトランザクションデータをサポートします。

非接触トランザクションの前にウォレットのトランザクションデータが利用可能な場合、NFC Wallet SDK は次を更新します IAD （EMVタグ 9F10、イシュアアプリケーションデータ）:

• 開始オフセット: 18バイト目

• IADの最大長: 32バイト

• ウォレットのトランザクションデータの最大長: 15バイト

SDK統合

Mastercard の永続ウォレットトランザクションデータを設定する

次を使用します DigitalCard.setWalletTransactionData を使用して永続ウォレットトランザクションデータを設定します:

• 14バイトの Data 値を渡して、このデジタルカードのウォレットトランザクションデータを保存します。

• を渡して nil このデジタルカードに保存されている値を消去します。

do {      
    // Mastercard 用のウォレットトランザクションデータを設定します。データ長 = 14バイト。
    let walletData = Data([0x57, 0x61, 0x6C, 0x6C, 0x65, 0x74, 0x44,
                            0x61, 0x74, 0x61, 0x00, 0x00, 0x00, 0x00])      
    try await digitalCard.setWalletTransactionData(walletData)
    // このカードのウォレットトランザクションデータを消去します
    try await digitalCard.setWalletTransactionData(nil)  
} catch {
    // エラーを処理します  
}

PURE の永続ウォレットトランザクションデータを設定する

次を使用します DigitalCard.setWalletTransactionData を使用して永続ウォレットトランザクションデータを設定します:

• 15バイトの Data 値を渡して、このデジタルカードのウォレットトランザクションデータを保存します。

• を渡して nil このデジタルカードに保存されている値を消去します。

do {      
    // この特定のカードのウォレットトランザクションデータを設定します
    let walletData = Data([0x57, 0x61, 0x6C, 0x6C, 0x65, 0x74, 0x44,
                            0x61, 0x74, 0x61, 0x00, 0x00, 0x00, 0x00, 0x00])      
    try await digitalCard.setWalletTransactionData(walletData)
    // このカードのウォレットトランザクションデータを消去します
    try await digitalCard.setWalletTransactionData(nil)  
} catch {
    // エラーを処理します  
}

エラーを処理します

ウォレットのトランザクションデータは、次の要件を満たす必要があります:

• Mastercard の長さ: 正確に14バイト

• PURE の長さ: 正確に15バイト

• スキームのサポート: サポートされているのは Mastercard と PURE の非接触プロファイルのみです。別のスキームにウォレットのトランザクションデータを設定すると、SDK は .schemeNotSupported.

do {
      try await digitalCard.setWalletTransactionData(data)
  } catch DigitalCard.Error.invalidWalletTransactionData {
      // スキームに基づく長さの検証。
      // Mastercard の場合、データ長が14バイトではありません。 
      // PURE カードの場合、データ長が15バイトではありません。 
  } catch DigitalCard.Error.schemeNotSupported {
      // カードのスキームはウォレットのトランザクションデータをサポートしていません（例: Visa）
  } catch {
      // その他のエラー
  }

支払い用のウォレットトランザクションデータを提供する

次を使用します startPayment() と ContactlessPaymentInputData を使用して、非接触決済中にウォレットのトランザクションデータを提供します。

ContactlessPaymentInputData は、2つのウォレットトランザクションデータモードをサポートします:

• .storage: セキュアストレージに保存された値を使用します（設定されている場合）。

• .ephemeral: このトランザクションに対する値のみを提供します。

ストレージモード

let paymentInputData = ContactlessPaymentInputData(
    digitalCardID: card.id,
    walletTransactionDataMode: .storage
)

一時モード

let paymentInputData = ContactlessPaymentInputData(
    digitalCardID: card.id,
    walletTransactionDataMode: .ephemeral(customData)
)

支払いを開始する

// 提供された contactlessPaymentInputData を使用して支払いを開始します
// ユースケース: 手動モード（ユーザー操作あり）
await session.startPayment(with contactlessPaymentInputData: contactlessPaymentInputData)