2. 非接触決済のコールバックを実装する

概要

APDU 処理中、NFC Wallet SDK は支払いライフサイクルのイベントであなたのアプリケーションを呼び出します。

実装する ContactlessPaymentServiceListener をデジタルウォレットアプリケーションで実装して、次を行います:

• 非接触取引の開始と完了を検出します。

• CDCVM が必要な場合にステップアップ認証をトリガーします。

• エラーを処理し、次の取引に備えて回復します。

SDK 連携

実装する ContactlessPaymentServiceListener

リスナーインスタンスを作成し、必要なコールバックを実装します。

// HCE サービス用のリスナーをインスタンス化します。
PaymentServiceListener myPaymentListener = new ContactlessPaymentServiceListener() {

    @Override
    public void onTransactionStarted() {
        /*
         * POS 端末との最初の APDU が交換されたときにトリガーされます。
         */
    }

    @Override
    public void onAuthenticationRequired(
            PaymentService activatedPaymentService,
            CHVerificationMethod chVerificationMethod,
            long cvmResetTimeout) {
        /*
         * エンドユーザーによる認証（CDCVM）が必要なときにトリガーされます。
         *
         * 必要な方法を判断するには chVerificationMethod を使用します。
         * cvmResetTimeout は一部の方法（たとえばウォレット PIN）にのみ適用されます。
         * これを使用して、検証がどのくらいの時間有効かをエンドユーザーに伝えます。
         */
    }

    @Override
    public void onReadyToTap(PaymentService paymentService) {
        /*
         * 認証成功後にトリガーされます。
         * cvmResetTimeout が期限切れになる前に、エンドユーザーにもう一度タップするよう促します。
         */
    }

    @Override
    public void onTransactionCompleted(TransactionContext transactionContext) {
        /*
         * 取引が正常に完了したときにトリガーされます。
         * TransactionContext を使用して詳細（金額、日付など）を表示します。
         */
    }

    @Override
    public void onTransactionInterrupted() {
        /*
         * POS 端末への NFC リンクが中断されたときにトリガーされます。
         * エンドユーザーにもう一度タップするよう促します。
         * オプションのコールバック
         */
    }

    @Override
    public void onError(
            TransactionContext transactionContext,
            PaymentServiceErrorCode paymentServiceErrorCode,
            String message) {
        /*
         * 取引を正常に完了できないときにトリガーされます。
         */
    }

    @Override
    public void onFirstTapCompleted() {
        /*
         * 1 回目のタップの APDU 処理が完了したことを示します。
         * PFP ベースの取引でのみサポートされます。
         */
    }

    @Override
    public void onNextTransactionReady(
            DeactivationStatus deactivationStatus,
            DigitalizedCardStatus digitalizedCardStatus,
            DigitalizedCard digitalizedCard) {
        /*
         * 取引完了後にトリガーされます。
         * カードの状態を確認し、次の支払いに備えるために使用します。
         */
    }
};

HCE サービスからリスナーを返します

拡張しているクラスで AsyncHCEService、からリスナーを返します setupListener().

public class MyHCEService extends AsyncHCEService {

    @Override
    public PaymentServiceListener setupListener() {
        return myPaymentListener;
    }
}

コールバックフロー（通常）

コールバックは通常この順序でトリガーされます。

onTransactionInterrupted() は、 onTransactionStarted().

1. onTransactionStarted() の後、POS 端末との最初の APDU 交換後にいつでも発生する可能性があります。

2. onAuthenticationRequired() エンドユーザーが CDCVM を完了する必要があるとき。

3. onReadyToTap() 認証成功後、2 回目のタップを要求するため。

4. onTransactionCompleted() 取引が正常に完了したとき。

5. onTransactionInterrupted() （オプション）POS 端末への NFC リンクが切断されたとき。を参照してください POS 端末の切断を処理する.

6. onNextTransactionReady() SDK が次の取引の準備ができたとき。

エラーが発生した場合、SDK は onError() をトリガーし、フローを完了しません。

POS 端末の切断を処理する（オプション）

SDK は、POS 端末への NFC リンクが中断されたときに通知できます。

使用する onTransactionInterrupted() エンドユーザーにもう一度タップするよう促します。

非接触支払いを開始する前に、再試行動作を設定します:

• PaymentSetting.setRetryLimit(int)

  取引が失敗する前に許容される POS 端末の切断回数を設定します。

  デフォルトは 0.

  で、 0のとき、SDK は onError() 最初の切断でトリガーします。

• PaymentSetting.setTransactionRetryTimeout(long)

  切断後に POS 端末が再試行できる時間を設定します。

  この間隔中に APDU が受信されない場合、SDK は onError().

  範囲は 500 から 10000 ミリ秒です。

  デフォルトは 2000 ミリ秒です。