Modes of Operation

Payment Device SDK offers flexible transaction processing options. It can be configured to handle Tap to Pay 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 Pay 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 Pay-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 Pay 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 Pay and external payment devices.

Default Payment Device Behavior

If no POI parameter key is provided, the SDK will default to enabling the external payment device and Tap to Pay 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 Pay 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.