public class

DeviceUpdate

extends PayPalRetailObject
java.lang.Object
   ↳ PayPalRetailObject
     ↳ com.paypal.paypalretailsdk.DeviceUpdate

Class Overview

A device update object is passed to your application via the PaymentDevice#updateRequired event and is capable of applying an update to a device.

Summary

Nested Classes
interface DeviceUpdate.CompletedCallback Called when either the software update completed, failed, or was canceled. 
interface DeviceUpdate.ReconnectReaderObserver Payment device connected via USB needs to be unplugged and plugged back to the USB port for the software update to complete  
Public Methods
void addReconnectReaderObserver(DeviceUpdate.ReconnectReaderObserver observer)
Add an observer for the reconnectReader event
void begin(DeviceUpdate.CompletedCallback callback)
Begin the software update.
Boolean getIsRequired()
Whether the update is required before taking further transactions using the device
Boolean getUpdateInProgress()
True if software update is in progress @readonly
Boolean getWasInstalled()
Indicates if the update was installed
void offer(DeviceUpdate.CompletedCallback callback)
Display a prompt to the merchant offering the opportunity to upgrade the payment device, and optionally update the device.
void removeReconnectReaderObserver(DeviceUpdate.ReconnectReaderObserver observer)
Remove an observer for the reconnectReader event
void setIsRequired(Boolean value)
Whether the update is required before taking further transactions using the device
void setWasInstalled(Boolean value)
Indicates if the update was installed
String toString()
Returns a string representing the serialized state of the DeviceUpdate object
void validateUpdateEligibility()
Check device-specific conditions for update such as battery level.
[Expand]
Inherited Methods
From class java.lang.Object

Public Methods

public void addReconnectReaderObserver (DeviceUpdate.ReconnectReaderObserver observer)

Add an observer for the reconnectReader event

public void begin (DeviceUpdate.CompletedCallback callback)

Begin the software update.

public Boolean getIsRequired ()

Whether the update is required before taking further transactions using the device

public Boolean getUpdateInProgress ()

True if software update is in progress @readonly

public Boolean getWasInstalled ()

Indicates if the update was installed

public void offer (DeviceUpdate.CompletedCallback callback)

Display a prompt to the merchant offering the opportunity to upgrade the payment device, and optionally update the device. Call the callback with completion status when the upgrade is complete or cancelled.

public void removeReconnectReaderObserver (DeviceUpdate.ReconnectReaderObserver observer)

Remove an observer for the reconnectReader event

public void setIsRequired (Boolean value)

Whether the update is required before taking further transactions using the device

public void setWasInstalled (Boolean value)

Indicates if the update was installed

public String toString ()

Returns a string representing the serialized state of the DeviceUpdate object

public void validateUpdateEligibility ()

Check device-specific conditions for update such as battery level.