com.stripe.stripeterminal.callable

Interface TerminalListener

public TerminalListener

The TerminalListener interface should be implemented in order to receive updates from a class Terminal instance.

Use of this SDK is subject to the Stripe Terminal Terms: https://stripe.com/terminal/legal

See Also:

class Terminal

Nested Class Summary

Nested Classes

Modifier and Type	Interface and Description
static class	TerminalListener.DefaultImpls The TerminalListener interface should be implemented in order to receive updates from a class Terminal instance.

Method Summary

Modifier and Type	Method and Description
void	onConnectionStatusChange(ConnectionStatus status) The class Terminal's connection status changed.
void	onPaymentStatusChange(PaymentStatus status) The class Terminal's payment status changed.
void	onReportLowBatteryWarning() The class Terminal reported that the reader's battery level is low
void	onReportReaderEvent(ReaderEvent event) The class Terminal reported an event from the reader (e.g. a card was inserted).
void	onUnexpectedReaderDisconnect(Reader reader) The class Terminal disconnected unexpectedly from the reader.

Method Detail

onReportReaderEvent

void onReportReaderEvent(@NotNull
                         ReaderEvent event)

The class Terminal reported an event from the reader (e.g. a card was inserted).

Parameters:

event - The event reported by the reader

See Also:

class Terminal

onReportLowBatteryWarning

void onReportLowBatteryWarning()

The class Terminal reported that the reader's battery level is low

See Also:

class Terminal

onUnexpectedReaderDisconnect

void onUnexpectedReaderDisconnect(@NotNull
                                  Reader reader)

The class Terminal disconnected unexpectedly from the reader.

In your implementation of this method, you may want to notify your user that the reader disconnected. You may also call Terminal.discoverReaders to begin scanning for readers, and attempt to automatically reconnect to the disconnected reader. Be sure to either set a timeout or make it possible to cancel calls to Terminal.discoverReaders

Parameters:

reader - The previously connected reader.

See Also:

class Terminal, Terminal.discoverReaders, Terminal.discoverReaders

onConnectionStatusChange

void onConnectionStatusChange(@NotNull
                              ConnectionStatus status)

The class Terminal's connection status changed.

Note: You should not use this method to detect when a reader unexpectedly disconnects from your app, as it cannot be used to accurately distinguish between expected and unexpected disconnect events.

To detect unexpect disconnects (e.g. to automatically notify your user), you should instead use the .onUnexpectedReaderDisconnect method.

Parameters:

status - The terminal's new connection status.

See Also:

class Terminal, .onUnexpectedReaderDisconnect

onPaymentStatusChange

void onPaymentStatusChange(@NotNull
                           PaymentStatus status)

The class Terminal's payment status changed.

Parameters:

status - The new payment status

See Also:

class Terminal