トランザクション履歴を取得する

概要

取引履歴では、あなたの デジタルウォレットアプリケーション サポート：

• 取引通知

• 取引履歴の更新

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

SDK の統合

取引通知

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

取引履歴を取得する

MGTransactionHistoryService.refreshHistory(...) はNFCウォレットのバックエンドから取引記録を取得します。

共通ブランド（コ・バッジ）カードをサポートする場合は、を受け取るオーバーロードを使用してください transactionRecordType プライマリまたは補助の記録を取得するため。

取引記録には次の情報が含まれます：

• 取引ID

• 取引日

• 取引タイプ

• 取引状況

• 通貨コード

• 金額および表示金額

• 加盟店名

• 加盟店種別

• 加盟店郵便番号

• 端末ID

• 加盟店ID

• プライマリまたは補助カードインジケータ（コ・バッジカードの場合）

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

• 時間ウィンドウ（例：過去30日間の取引）。

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

実装

デジタルカードの取引履歴を取得するには：

1. 対応するを取得します デジタルカードID.

   参照してください デジタルカードの表示.

2. アクセストークンを取得してください。

   参照してください アクセストークンを取得する.

3. （オプション）を提供します transactionRecordType :

   PRIMARY または AUXILIARY コ・バッジカードで使用され、で提供されます プッシュ通知の処理.

4. 呼び出す MGTransactionHistoryService.refreshHistory(...) を呼び出し、次を実装します TransactionHistoryListener:

   1. onSuccess

      SDKが取引を正常に取得したときにトリガーされます。コールバックはを提供します List<MGTransactionRecord>.

      それぞれの MGTransactionRecord は取引記録を表します。

   2. onError

      SDKが取引履歴を取得できないときにトリガーされます。エラーの詳細についてはを使用してください。 MobileGatewayError エラーの詳細については。

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

GetTransactionHistory.java

// 以前に初期化された値。
String digitalCardId = "...";
String accessToken = "...";

// 取引履歴サービスを取得します。
MobileGatewayManager mgClient = MobileGatewayManager.INSTANCE;
MGTransactionHistoryService transactionHistoryService = mgClient.getTransactionHistoryService();

// 取引履歴を取得します。
transactionHistoryService.refreshHistory(
        accessToken,
        digitalCardId,
        null,
        new TransactionHistoryListener() {

            @Override
            public void onSuccess(
                    List<MGTransactionRecord> records,
                    String digitalCardId,
                    String timeStamp) {
                // 成功。
                // 各MGTransactionRecordは1件の取引の詳細を保持します。
                // フィールドレベルの詳細はAPIリファレンスを参照してください。
            }

            @Override
            public void onError(String digitalCardId, MobileGatewayError error) {
                // エラーを処理します。
            }
        }
);