取引履歴を取得する

概要

取引履歴を利用すると、あなたの デジタルウォレットアプリケーション サポート:

• 取引通知
• 取引履歴の更新

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

SDK 連携

取引通知

取引通知をサポートするには、処理する TNS通知（取引） で説明されているとおり プッシュ通知の処理.

取引履歴を取得する

MGTransactionHistoryService.refreshHistory(...) NFC Wallet バックエンドから取引記録を取得します。

コーブランデッドカードをサポートする場合は、受け取るオーバーロードを使用します transactionRecordType プライマリまたは補助の記録を取得するために。

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

• 取引ID
• 取引日
• 取引タイプ
• 取引ステータス
• 通貨コード
• 金額と表示金額
• 加盟店名
• 加盟店種別
• 加盟店郵便番号
• 端末ID
• 加盟店ID
• プライマリカードまたは補助カードの識別子（コーブランデッドカード用）

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

• 時間枠（たとえば、過去30日間の取引）。
• 最大件数（たとえば、最新の10件の取引）。

実装

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

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

   参照 デジタルカードを表示する.
2. アクセストークンを取得します。

   参照 アクセストークンを取得する.
3. （任意）次を指定します transactionRecordType :

   プライマリ または 補助 コーブランデッドで使用し、提供されます プッシュ通知の処理.
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) {
                // エラーを処理します。
            }
        }
);