取引履歴を取得する

概要

取引履歴を使うことで、デジタルウォレットアプリは次のことをサポートできます：

• 取引通知

• 取引履歴の更新

オンボーディング中に、プログラムで取引履歴が有効になっていることを確認してください。

SDK 統合

取引通知

取引通知をサポートするには、次を処理します TNS通知（取引） に記載されているように プッシュ通知の処理.

取引を取得

TransactionHistoryService は、NFCウォレットバックエンドから取引履歴と取引通知の詳細の両方を取得します。

取引レコードには次の情報が含まれます：

• 取引ID

• 取引日

• 取引タイプ

• 取引ステータス

• 通貨コード

• 金額と表示金額

• 加盟店名

• 加盟店タイプ

• 加盟店郵便番号

• 端末ID

• 加盟店ID

• 主要カードまたは補助カードの指標（共同ブランドカードの場合）

取引履歴の制限は決済ネットワークによって異なります：

• 時間範囲（例：過去30日間の取引）。

• 最大件数（例：直近10件の取引）。

次のコードスニペットは取引レコードを取得する方法を示しています：

func transactionHistory() async {
    do {
        let historyService = TransactionHistoryService()
        let records = try await historyService.records(forDigitalCardID: "DIGITAL_CARD_ID")

        for record in records {
            // UIにレコードフィールドを表示します。
            _ = record.id
            _ = record.date
            _ = record.status
            _ = record.type
            _ = record.currencyCode
            _ = record.amount
            _ = record.displayAmount
            _ = record.merchantName
            _ = record.merchantType
            _ = record.merchantPostalCode
            _ = record.terminalID
            _ = record.merchantID
            _ = record.isAuxiliaryTransaction
        }
    } catch {
        if let error = error as? TransactionHistoryService.Error {
            // エラーを処理します。
        }
    }
}

共同ブランドカードの場合、 isAuxiliaryTransaction はレコードが補助カードに属するかどうかを示します。