Modes of Operation

Payment Device SDK offers flexible transaction processing options. It can be configured to handle Tap to Mobile transactions independently, process transactions through an external payment device, or operate in a combined mode. In the combined mode, transactions can be initiated simultaneously on both Tap to Mobile and an external payment device, allowing for versatile and seamless payment processing.

Configuration

During calls to connectAndConfigure you can request which mode the Payment Device
SDK will operate in using the following parameters.

TAP TO MOBILE-ONLY ENVIRONMENT

  • Include ParameterKeys.TapToMobilePOI with a value of
    ParameterValues.TRUE

  • Include ParameterKeys.PaymentDevicePOI with a value of
    ParameterValues.FALSE

This configuration stops the Payment Device SDK from attempting to set up an external
payment device.

TAP TO MOBILE AND PAYMENT DEVICE ENVIRONMENT

  • Include ParameterKeys.TapToMobilePOI with a value of
    ParameterValues.TRUE

  • Include ParameterKeys.PaymentDevicePOI with a value of
    ParameterValues.TRUE

This configuration enables the use of both Tap To Mobile and external
payment devices.

DEFAULT PAYMENT DEVICE BEHAVIOR

If no POI Parmamer key is provided, the SDK will default to enabling the external payment
device and Tap To Mobile transactions will not be offered.

Transaction processing

Once configured you can make use of the ParameterKeys.TransactionPOI parameter
key to select which POI the transaction is started on.

ACCEPTED PARAMETER VALUES

  • ParameterValues.PaymentDevice: Specifies the use of a physical payment
    device for the transaction.

  • ParameterValues.TapToMobile: Specifies the use of the Tap To Mobile functionality for the transaction.

Note: when a single POI is configured, that POI will be used by default. When both have
been configured the PaymentDevice will be preferred.


What’s Next