6. 取引コンテキストを表示する

概要

各トランザクションの後、あなたの デジタルウォレットアプリケーション はトランザクションの詳細を表示できます。

NFC Wallet SDK は、 TransactionContext これらのコールバックで:

• ContactlessPaymentServiceListener.onTransactionCompleted()
• ContactlessPaymentServiceListener.onError()

次のように扱います TransactionContext 機密データとして。

呼び出します TransactionContext.wipe() 使用し終えたら。

SDK 連携

トランザクションの詳細を読み取り、整形する

コンテキストから必要な値を読み取り、表示用に整形します。

MyPaymentListener.java

@Override
public void onTransactionCompleted(TransactionContext ctx) {
    try {
        TransactionData data = TransactionData.from(ctx);
        // UI にデータを表示します。
    } finally {
        ctx.wipe();
    }
}

@Override
public void onError(
        TransactionContext ctx,
        PaymentServiceErrorCode errorCode,
        String message) {

    if (ctx == null) {
        // トランザクション コンテキストが利用できない場合のエラーを処理します。
        return;
    }

    try {
        TransactionData data = TransactionData.from(ctx);
        // UI にデータとエラーの詳細を表示します。
    } finally {
        ctx.wipe();
    }
}

/**
 * トランザクション表示用の便利なデータクラス。
 */
public class TransactionData {

    private final String currencyCode;
    private final double amount;
    private final String transactionDate;
    private final String transactionType;
    private final String transactionId;

    private TransactionData(
            String currencyCode,
            double amount,
            String transactionDate,
            String transactionType,
            String transactionId) {
        this.currencyCode = currencyCode;
        this.amount = amount;
        this.transactionDate = transactionDate;
        this.transactionType = transactionType;
        this.transactionId = transactionId;
    }

    public static TransactionData from(TransactionContext ctx) {
        String currencyCode = TransactionDisplayUtils.bcdToString(ctx.getCurrencyCode());
        String transactionDate = TransactionDisplayUtils.bcdToString(ctx.getTrxDate());
        String transactionType = TransactionDisplayUtils.getTransactionType(ctx.getTrxType());

        return new TransactionData(
                currencyCode,
                ctx.getAmount(),
                transactionDate,
                transactionType,
                ctx.getTrxId());
    }

    public String getCurrencyCode() {
        return currencyCode;
    }

    public double getAmount() {
        return amount;
    }

    public String getTransactionDate() {
        return transactionDate;
    }

    public String getTransactionType() {
        return transactionType;
    }

    public String getTransactionId() {
        return transactionId;
    }
}

表示用に BCD 値を変換する（ユーティリティ）

次のユーティリティは、BCD でエンコードされた値を文字列に変換します。

フォーマットは、UI と決済ネットワークの要件に合わせて調整してください。

TransactionDisplayUtils.java

public final class TransactionDisplayUtils {

    private TransactionDisplayUtils() {
        // ユーティリティクラス。
    }

    public static String bcdToString(byte[] bcd) {
        if (bcd == null) {
            return "";
        }

        StringBuilder sb = new StringBuilder();
        for (byte b : bcd) {
            sb.append(bcdToString(b));
        }
        return sb.toString();
    }

    public static String bcdToString(byte bcd) {
        int high = (bcd & 0xF0) >>> 4;
        int low = (bcd & 0x0F);
        return String.valueOf(high) + low;
    }

    public static String getTransactionType(byte trxType) {
        switch (trxType) {
            case 0:
                return "PAY";
            case 32:
                return "REFUND";
            default:
                return "TRANSACTION";
        }
    }
}