CloverConnector

java.lang.Object
- com.clover.remote.client.CloverConnector

All Implemented Interfaces:

ICloverConnector, java.io.Serializable
```
public class CloverConnector
extends java.lang.Object
implements ICloverConnector
```
Provides the default implementation of the ICloverConnector interface, connecting to the device specified in the constructor. This implementation supports the registration of one or more ICloverConnectorListener interfaces that are notified asynchronously of events and responses from the underlying connected Clover device.

See Also:

Serialized Form

Field Summary

Fields
Modifier and Type	Field and Description
`static com.clover.remote.InputOption`	`CANCEL_INPUT_OPTION`
`static int`	`CARD_ENTRY_METHOD_ICC_CONTACT`
`static int`	`CARD_ENTRY_METHOD_MAG_STRIPE`
`static int`	`CARD_ENTRY_METHOD_MANUAL`
`static int`	`CARD_ENTRY_METHOD_NFC_CONTACTLESS`
`static int`	`MAX_PAYLOAD_SIZE`

Constructor Summary

Constructors
Constructor and Description

CloverConnector(CloverDeviceConfiguration config)
CloverConnector constructor

Constructors
Constructor and Description
`CloverConnector(CloverDeviceConfiguration config)` CloverConnector constructor

Method Summary

All Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`void`	`acceptPayment(com.clover.sdk.v3.payments.Payment payment)` If payment confirmation is required during a Sale, this method accepts the payment
`void`	`acceptSignature(VerifySignatureRequest request)` If signature is captured during a Sale, this method accepts the signature as entered
`void`	`addCloverConnectorListener(ICloverConnectorListener connectorListener)` Registers the provided listener to receive callbacks and events from the underlying device connection.
`void`	`auth(AuthRequest request)` Auth method to obtain an Auth payment that can be used as the payment to call tipAdjust
`void`	`cancel()` Cancels the current user action on the device.
`void`	`capturePreAuth(CapturePreAuthRequest request)` Capture a previous Auth.
`void`	`closeout(CloseoutRequest request)` Request a closeout of all orders.
`void`	`displayPaymentReceiptOptions(java.lang.String orderId, java.lang.String paymentId)` Display the payment receipt screen for the orderId/paymentId combination.
`void`	`dispose()` Will dispose of the underlying connection to the device
`void`	`initializeConnection()` Initialize the CloverConnector's connection and start communication with the device.
`void`	`invokeInputOption(com.clover.remote.InputOption io)` Used to invoke user options on the mini such as "OK", "CANCEL", "DONE", etc.
`void`	`manualRefund(ManualRefundRequest request)` Manual refund method, aka "naked credit"
`void`	`openCashDrawer(OpenCashDrawerRequest request)` Request that the cash drawer connected to the device be opened.
`void`	`openCashDrawer(java.lang.String reason)` Will trigger cash drawer to open that is connected to Clover Mini
`void`	`preAuth(PreAuthRequest request)` PreAuth method to obtain a Pre-Auth for a card
`void`	`print(PrintRequest request)` Request to print.
`void`	`printImage(Bitmap bitmap)` Print an image on the Clover Mini printer
`void`	`printImageFromURL(java.lang.String url)` Print an image on the Clover Mini printer
`void`	`printText(java.util.List<java.lang.String> messages)` Print simple lines of text to the Clover Mini printer
`void`	`readCardData(ReadCardDataRequest request)` Used to request card information.
`void`	`refundPayment(RefundPaymentRequest request)` Refund a specific payment
`void`	`rejectPayment(com.clover.sdk.v3.payments.Payment payment, com.clover.remote.Challenge challenge)` If payment confirmation is required during a Sale, this method rejects the payment
`void`	`rejectSignature(VerifySignatureRequest request)` If signature is captured during a Sale, this method rejects the signature as entered
`void`	`removeCloverConnectorListener(ICloverConnectorListener connectorListener)` Remove a previously added listener.
`void`	`removeDisplayOrder(com.clover.remote.order.DisplayOrder order)` Remove the DisplayOrder from the device.
`void`	`resetDevice()` Used to reset the device if it gets in an invalid state from POS perspective.
`void`	`retrieveDeviceStatus(RetrieveDeviceStatusRequest request)` Send a message requesting the current status of the device.
`void`	`retrievePayment(RetrievePaymentRequest request)` Sends a request to get a payment.
`void`	`retrievePendingPayments()` Used to request a list of pending payments that have been taken offline, but haven't processed yet.
`void`	`retrievePrinters(RetrievePrintersRequest request)` Request to retrieve available printers.
`void`	`retrievePrintJobStatus(PrintJobStatusRequest request)` Request the status of a given print job
`void`	`sale(SaleRequest request)` Sale method, aka "purchase"
`void`	`sendMessageToActivity(MessageToActivity request)` Send a message to a running custom activity on the Clover device
`void`	`showDisplayOrder(com.clover.remote.order.DisplayOrder order)` Show the DisplayOrder on the device.
`void`	`showMessage(java.lang.String message)` Show a message on the Clover Mini screen
`void`	`showThankYouScreen()` Show the thank you screen on the device
`void`	`showWelcomeScreen()` Return the device to the Welcome Screen
`void`	`startCustomActivity(CustomActivityRequest request)` Request to start a Custom Activity on the Clover device
`void`	`tipAdjustAuth(TipAdjustAuthRequest request)` Adjust the tip for a previous Auth.
`void`	`vaultCard(java.lang.Integer cardEntryMethods)` Vault card information.
`void`	`voidPayment(VoidPaymentRequest request)` Void a transaction, given a previously used order ID and/or payment ID

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Field Detail
  - CARD_ENTRY_METHOD_MAG_STRIPE
```
public static final int CARD_ENTRY_METHOD_MAG_STRIPE
```
    See Also:
    
    Constant Field Values
  - CARD_ENTRY_METHOD_ICC_CONTACT
```
public static final int CARD_ENTRY_METHOD_ICC_CONTACT
```
    See Also:
    
    Constant Field Values
  - CARD_ENTRY_METHOD_NFC_CONTACTLESS
```
public static final int CARD_ENTRY_METHOD_NFC_CONTACTLESS
```
    See Also:
    
    Constant Field Values
  - CARD_ENTRY_METHOD_MANUAL
```
public static final int CARD_ENTRY_METHOD_MANUAL
```
    See Also:
    
    Constant Field Values
  - MAX_PAYLOAD_SIZE
```
public static final int MAX_PAYLOAD_SIZE
```
    See Also:
    
    Constant Field Values
  - CANCEL_INPUT_OPTION
```
public static final com.clover.remote.InputOption CANCEL_INPUT_OPTION
```
- Constructor Detail
  - CloverConnector
```
public CloverConnector(CloverDeviceConfiguration config)
```
    CloverConnector constructor
    
    Parameters:
    
    config - A CloverDeviceConfiguration object containing the configuration for the device
- Method Detail
  - addCloverConnectorListener
```
public void addCloverConnectorListener(ICloverConnectorListener connectorListener)
```
    Registers the provided listener to receive callbacks and events from the underlying device connection. Note that listeners MUST be registered prior to calling initializeConnection() to guarantee notification of all connection related callbacks.
    
    Specified by:
    
    addCloverConnectorListener in interface ICloverConnector
    
    Parameters:
    
    connectorListener - The listener to register
  - removeCloverConnectorListener
```
public void removeCloverConnectorListener(ICloverConnectorListener connectorListener)
```
    Remove a previously added listener. If the provided listener is not registered, this call has no effect.
    
    Specified by:
    
    removeCloverConnectorListener in interface ICloverConnector
    
    Parameters:
    
    connectorListener - The listener to remove
  - initializeConnection
```
public void initializeConnection()
```
    Description copied from interface: ICloverConnector
    
    Initialize the CloverConnector's connection and start communication with the device. Must be called before calling any other method other than to add or remove listeners
    
    Specified by:
    
    initializeConnection in interface ICloverConnector
  - sale
```
public void sale(SaleRequest request)
```
    Description copied from interface: ICloverConnector
    
    Sale method, aka "purchase"
    
    Specified by:
    
    sale in interface ICloverConnector
    
    Parameters:
    
    request - A SaleRequest object containing basic information needed for the transaction
  - acceptSignature
```
public void acceptSignature(VerifySignatureRequest request)
```
    Description copied from interface: ICloverConnector
    
    If signature is captured during a Sale, this method accepts the signature as entered
    
    Specified by:
    
    acceptSignature in interface ICloverConnector
    
    Parameters:
    
    request - Accepted request
  - rejectSignature
```
public void rejectSignature(VerifySignatureRequest request)
```
    Description copied from interface: ICloverConnector
    
    If signature is captured during a Sale, this method rejects the signature as entered
    
    Specified by:
    
    rejectSignature in interface ICloverConnector
    
    Parameters:
    
    request - Rejected request
  - acceptPayment
```
public void acceptPayment(com.clover.sdk.v3.payments.Payment payment)
```
    Description copied from interface: ICloverConnector
    
    If payment confirmation is required during a Sale, this method accepts the payment
    
    Specified by:
    
    acceptPayment in interface ICloverConnector
    
    Parameters:
    
    payment - Payment to accept
  - rejectPayment
```
public void rejectPayment(com.clover.sdk.v3.payments.Payment payment,
                          com.clover.remote.Challenge challenge)
```
    Description copied from interface: ICloverConnector
    
    If payment confirmation is required during a Sale, this method rejects the payment
    
    Specified by:
    
    rejectPayment in interface ICloverConnector
    
    Parameters:
    
    payment - Payment to reject
    
    challenge - The challenge which resulted in payment rejection
  - auth
```
public void auth(AuthRequest request)
```
    Description copied from interface: ICloverConnector
    
    Auth method to obtain an Auth payment that can be used as the payment to call tipAdjust
    
    Specified by:
    
    auth in interface ICloverConnector
    
    Parameters:
    
    request - The request details
  - preAuth
```
public void preAuth(PreAuthRequest request)
```
    Description copied from interface: ICloverConnector
    
    PreAuth method to obtain a Pre-Auth for a card
    
    Specified by:
    
    preAuth in interface ICloverConnector
    
    Parameters:
    
    request - The request details
  - capturePreAuth
```
public void capturePreAuth(CapturePreAuthRequest request)
```
    Description copied from interface: ICloverConnector
    
    Capture a previous Auth. Note: Should only be called if request's PaymentID is from an AuthResponse
    
    Specified by:
    
    capturePreAuth in interface ICloverConnector
    
    Parameters:
    
    request - The request details
  - tipAdjustAuth
```
public void tipAdjustAuth(TipAdjustAuthRequest request)
```
    Description copied from interface: ICloverConnector
    
    Adjust the tip for a previous Auth. Note: Should only be called if request's PaymentID is from an AuthResponse
    
    Specified by:
    
    tipAdjustAuth in interface ICloverConnector
    
    Parameters:
    
    request - The request details
  - vaultCard
```
public void vaultCard(java.lang.Integer cardEntryMethods)
```
    Description copied from interface: ICloverConnector
    
    Vault card information. Requests the mini capture card information and request a payment token from the payment gateway. The value returned in the response is a card, with all the information necessary to use for payment in a SaleRequest or AuthRequest
    
    Specified by:
    
    vaultCard in interface ICloverConnector
    
    Parameters:
    
    cardEntryMethods - The card entry methods allowed to capture the payment token. null will provide default values
  - voidPayment
```
public void voidPayment(VoidPaymentRequest request)
```
    Description copied from interface: ICloverConnector
    
    Void a transaction, given a previously used order ID and/or payment ID
    
    Specified by:
    
    voidPayment in interface ICloverConnector
    
    Parameters:
    
    request - The request details
  - refundPayment
```
public void refundPayment(RefundPaymentRequest request)
```
    Description copied from interface: ICloverConnector
    
    Refund a specific payment
    
    Specified by:
    
    refundPayment in interface ICloverConnector
    
    Parameters:
    
    request - The request details
  - manualRefund
```
public void manualRefund(ManualRefundRequest request)
```
    Description copied from interface: ICloverConnector
    
    Manual refund method, aka "naked credit"
    
    Specified by:
    
    manualRefund in interface ICloverConnector
    
    Parameters:
    
    request - The request details
  - retrievePendingPayments
```
public void retrievePendingPayments()
```
    Description copied from interface: ICloverConnector
    
    Used to request a list of pending payments that have been taken offline, but haven't processed yet. Will trigger an onRetrievePendingPaymentsResponse callback.
    
    Specified by:
    
    retrievePendingPayments in interface ICloverConnector
  - readCardData
```
public void readCardData(ReadCardDataRequest request)
```
    Description copied from interface: ICloverConnector
    
    Used to request card information. Specifically track1 and track2 information
    
    Specified by:
    
    readCardData in interface ICloverConnector
    
    Parameters:
    
    request - The request details
  - sendMessageToActivity
```
public void sendMessageToActivity(MessageToActivity request)
```
    Description copied from interface: ICloverConnector
    
    Send a message to a running custom activity on the Clover device
    
    Specified by:
    
    sendMessageToActivity in interface ICloverConnector
    
    Parameters:
    
    request - The request details
  - closeout
```
public void closeout(CloseoutRequest request)
```
    Description copied from interface: ICloverConnector
    
    Request a closeout of all orders.
    
    Specified by:
    
    closeout in interface ICloverConnector
    
    Parameters:
    
    request - The request details
  - print
```
public void print(PrintRequest request)
```
    Description copied from interface: ICloverConnector
    
    Request to print.
    
    Specified by:
    
    print in interface ICloverConnector
    
    Parameters:
    
    request - The request details: info and content needed to print
  - retrievePrinters
```
public void retrievePrinters(RetrievePrintersRequest request)
```
    Description copied from interface: ICloverConnector
    
    Request to retrieve available printers.
    
    Specified by:
    
    retrievePrinters in interface ICloverConnector
    
    Parameters:
    
    request - object that contains additional information to be applied during the request
  - retrievePrintJobStatus
```
public void retrievePrintJobStatus(PrintJobStatusRequest request)
```
    Description copied from interface: ICloverConnector
    
    Request the status of a given print job
    
    Specified by:
    
    retrievePrintJobStatus in interface ICloverConnector
    
    Parameters:
    
    request - object defining the print job to be queried
  - openCashDrawer
```
public void openCashDrawer(OpenCashDrawerRequest request)
```
    Description copied from interface: ICloverConnector
    
    Request that the cash drawer connected to the device be opened.
    
    Specified by:
    
    openCashDrawer in interface ICloverConnector
    
    Parameters:
    
    request - object defining the reason the cash drawer is being opened, and an optional device identifier
  - cancel
```
public void cancel()
```
    Description copied from interface: ICloverConnector
    
    Cancels the current user action on the device.
    
    Specified by:
    
    cancel in interface ICloverConnector
  - printText
```
public void printText(java.util.List<java.lang.String> messages)
```
    Description copied from interface: ICloverConnector
    
    Print simple lines of text to the Clover Mini printer
    
    Specified by:
    
    printText in interface ICloverConnector
    
    Parameters:
    
    messages - A list of text to print
  - printImage
```
public void printImage(Bitmap bitmap)
```
    Description copied from interface: ICloverConnector
    
    Print an image on the Clover Mini printer
    
    Specified by:
    
    printImage in interface ICloverConnector
    
    Parameters:
    
    bitmap - An image to print NOTE: This method is not implemented for the Java SDK. Use ICloverConnector.printImageFromURL(String) instead.
  - printImageFromURL
```
public void printImageFromURL(java.lang.String url)
```
    Description copied from interface: ICloverConnector
    
    Print an image on the Clover Mini printer
    
    Specified by:
    
    printImageFromURL in interface ICloverConnector
    
    Parameters:
    
    url - The url of an image to print
  - showMessage
```
public void showMessage(java.lang.String message)
```
    Description copied from interface: ICloverConnector
    
    Show a message on the Clover Mini screen
    
    Specified by:
    
    showMessage in interface ICloverConnector
    
    Parameters:
    
    message - The message to display
  - showWelcomeScreen
```
public void showWelcomeScreen()
```
    Description copied from interface: ICloverConnector
    
    Return the device to the Welcome Screen
    
    Specified by:
    
    showWelcomeScreen in interface ICloverConnector
  - showThankYouScreen
```
public void showThankYouScreen()
```
    Description copied from interface: ICloverConnector
    
    Show the thank you screen on the device
    
    Specified by:
    
    showThankYouScreen in interface ICloverConnector
  - displayPaymentReceiptOptions
```
public void displayPaymentReceiptOptions(java.lang.String orderId,
                                         java.lang.String paymentId)
```
    Description copied from interface: ICloverConnector
    
    Display the payment receipt screen for the orderId/paymentId combination.
    
    Specified by:
    
    displayPaymentReceiptOptions in interface ICloverConnector
    
    Parameters:
    
    orderId - The ID of the order to print a receipt for
    
    paymentId - The ID of the payment to print a receipt for
  - openCashDrawer
```
public void openCashDrawer(java.lang.String reason)
```
    Description copied from interface: ICloverConnector
    
    Will trigger cash drawer to open that is connected to Clover Mini
    
    Specified by:
    
    openCashDrawer in interface ICloverConnector
    
    Parameters:
    
    reason - Reason for opening the cash drawer
  - showDisplayOrder
```
public void showDisplayOrder(com.clover.remote.order.DisplayOrder order)
```
    Description copied from interface: ICloverConnector
    
    Show the DisplayOrder on the device. Replaces the existing DisplayOrder on the device.
    
    Specified by:
    
    showDisplayOrder in interface ICloverConnector
    
    Parameters:
    
    order - The order to display
  - removeDisplayOrder
```
public void removeDisplayOrder(com.clover.remote.order.DisplayOrder order)
```
    Description copied from interface: ICloverConnector
    
    Remove the DisplayOrder from the device.
    
    Specified by:
    
    removeDisplayOrder in interface ICloverConnector
    
    Parameters:
    
    order - The order to remove
  - dispose
```
public void dispose()
```
    Description copied from interface: ICloverConnector
    
    Will dispose of the underlying connection to the device
    
    Specified by:
    
    dispose in interface ICloverConnector
  - invokeInputOption
```
public void invokeInputOption(com.clover.remote.InputOption io)
```
    Description copied from interface: ICloverConnector
    
    Used to invoke user options on the mini such as "OK", "CANCEL", "DONE", etc.
    
    Specified by:
    
    invokeInputOption in interface ICloverConnector
    
    Parameters:
    
    io - The option to invoke
  - resetDevice
```
public void resetDevice()
```
    Description copied from interface: ICloverConnector
    
    Used to reset the device if it gets in an invalid state from POS perspective. This could cause a missed transaction or other missed information, so it needs to be used cautiously as a last resort
    
    Specified by:
    
    resetDevice in interface ICloverConnector
  - retrieveDeviceStatus
```
public void retrieveDeviceStatus(RetrieveDeviceStatusRequest request)
```
    Description copied from interface: ICloverConnector
    
    Send a message requesting the current status of the device.
    
    Specified by:
    
    retrieveDeviceStatus in interface ICloverConnector
    
    Parameters:
    
    request - The request details
  - retrievePayment
```
public void retrievePayment(RetrievePaymentRequest request)
```
    Description copied from interface: ICloverConnector
    
    Sends a request to get a payment. Only valid for payments made in the past 24 hours on the device queried.
    
    Specified by:
    
    retrievePayment in interface ICloverConnector
    
    Parameters:
    
    request - The request details
  - startCustomActivity
```
public void startCustomActivity(CustomActivityRequest request)
```
    Description copied from interface: ICloverConnector
    
    Request to start a Custom Activity on the Clover device
    
    Specified by:
    
    startCustomActivity in interface ICloverConnector
    
    Parameters:
    
    request - The request details

Class CloverConnector

Field Summary

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Field Detail

CARD_ENTRY_METHOD_MAG_STRIPE

CARD_ENTRY_METHOD_ICC_CONTACT

CARD_ENTRY_METHOD_NFC_CONTACTLESS

CARD_ENTRY_METHOD_MANUAL

MAX_PAYLOAD_SIZE

CANCEL_INPUT_OPTION

Constructor Detail

CloverConnector

Method Detail

addCloverConnectorListener

removeCloverConnectorListener

initializeConnection

sale

acceptSignature

rejectSignature

acceptPayment

rejectPayment

auth

preAuth

capturePreAuth

tipAdjustAuth

vaultCard

voidPayment

refundPayment

manualRefund

retrievePendingPayments

readCardData

sendMessageToActivity

closeout

print

retrievePrinters

retrievePrintJobStatus

openCashDrawer

cancel

printText

printImage

printImageFromURL

showMessage

showWelcomeScreen

showThankYouScreen

displayPaymentReceiptOptions

openCashDrawer

showDisplayOrder

removeDisplayOrder

dispose

invokeInputOption

resetDevice

retrieveDeviceStatus

retrievePayment

startCustomActivity