Manual mode

Overview

This section describes the Manual mode contactless payment flow. In this flow, the issuer application initiates the payment.

User experience

The end user can initiate a contactless payment from the issuer application by using NFC Payment.

• Manual mode: The end user opens the issuer application, authenticates, and then taps the POS terminal.

Flow

The issuer application calls D1PayConfigParams.getInstance().setManualModeContactlessTransactionListener() to set the ContactlessTransactionListener callback. Then, the issuer application calls D1PayWallet.startManualModePayment() to start the manual mode payment.

For implementation details, see CDCVM Always and extend the abstract ContactlessTransactionListener.

When a manual mode payment starts, the following callback is called first:

• ContactlessTransactionListener::onAuthenticationRequired()

When the end user taps the POS terminal, the following callbacks are called in sequence:

• ContactlessTransactionListener::onReadyToTap()

• ContactlessTransactionListener::onTransactionCompleted()

  • TransactionData is only available on this callback for manual mode.

As shown in the sequence diagram below:

SDK

Android Java

// extend ContactlessTransactionListener
ContactlessTransactionListener paymentCallback;
// register manual mode contactless transaction callback
D1PayConfigParams configParams = D1PayConfigParams.getInstance();
configParams.setManualModeContactlessTransactionListener(paymentCallback);

// start manual mode payment
String cardId = ""; // selected card ID
D1PayWallet d1PayWallet = d1Task.getD1PayWallet();
d1PayWallet.startManualModePayment(cardId);