ReaderListener
The ReaderListener
interface is a listener that should exist for the entire duration of your connection to a reader. It will receive events related to the status of the reader, as well as opportunities to update the reader's software.
Functions
The Terminal reports batteryLevel, BatteryStatus and charging status every 10 minutes
This method is called when the reader has disconnected from the SDK, and includes the reason for the disconnect.
The terminal has finished installing a ReaderSoftwareUpdate.
NOTE: An implementation of this method is required for bluetooth and usb readers.
The Terminal reported that the reader's battery level is low
The Terminal reported an event from the reader (e.g. a card was inserted).
The terminal reported progress on a reader software update.
This method is called to request that a message be displayed in your app. For example, if the message is SWIPE_CARD
, your app should instruct the user to present the card again by swiping it.
This method is called when the reader begins waiting for input. Your app should prompt the customer to present a source using one of the given input options. If the reader emits a message, the .onRequestReaderDisplayMessage method will be called.
The SDK is reporting that the reader has started installation of a required update that must be completed before the reader can be used.