CloverConnector
4.0.0
Copyright (C) 2018 Clover Network, Inc.
|
The main CloverConnector API for connecting to Clover Payment Devices, created via a CloverConnectorFactory transport setup call More...
Public Member Functions | |
void | AddCloverConnectorListener (ICloverConnectorListener connectorListener) |
Adds a Clover Connector listener. More... | |
void | RemoveCloverConnectorListener (ICloverConnectorListener connectorListener) |
Removes a Clover Connector listener. More... | |
CloverConnector () | |
CloverConnector (CloverDeviceConfiguration config) | |
CloverConnector constructor More... | |
void | InitializeConnection () |
Initialize the connector with a given configuration More... | |
void | Sale (SaleRequest request) |
Sale method, aka "purchase" More... | |
void | AcceptSignature (VerifySignatureRequest request) |
If signature is captured during a Sale, this method accepts the signature as entered More... | |
void | RejectSignature (VerifySignatureRequest request) |
If signature is captured during a Sale, this method rejects the signature as entered More... | |
void | Auth (AuthRequest request) |
Auth method to obtain an Auth. While a Pre-Auth can also be accomplished by setting the IsPreAuth flag to true, the PreAuthRequest is the preferred request type. PreAuth functionality was retained for backward compatibility More... | |
void | PreAuth (PreAuthRequest request) |
PreAuth method to obtain a PreAuth. More... | |
void | CapturePreAuth (CapturePreAuthRequest request) |
Capture a previous Auth. Note: Should only be called if request's PaymentID is from an AuthResponse More... | |
void | TipAdjustAuth (TipAdjustAuthRequest request) |
Adjust the tip for a previous Auth. Note: Should only be called if request's PaymentID is from an AuthResponse More... | |
void | VoidPayment (VoidPaymentRequest request) |
Void a transaction, given a previously used order ID and/or payment ID TBD - defining a payment or order ID to be used with a void without requiring a response from Sale() More... | |
void | VoidPaymentRefund (VoidPaymentRefundRequest request) |
void | RefundPayment (RefundPaymentRequest request) |
Refund a specific payment More... | |
void | ManualRefund (ManualRefundRequest request) |
Manual refund method, aka "naked credit" More... | |
void | Closeout (CloseoutRequest request) |
Send a request to the server to closeout all orders. More... | |
void | ResetDevice () |
Send a request to the mini to reset. This can be used if the device gets into a non-recoverable state. More... | |
void | ShowMessage (string message) |
Show a message on the Clover Mini screen More... | |
void | SendDebugLog (string message) |
void | ShowWelcomeScreen () |
Return the device to the Welcome Screen More... | |
void | ShowThankYouScreen () |
Show the thank you screen on the device More... | |
void | VaultCard (int? CardEntryMethods) |
Vault Card information and payment token More... | |
void | ReadCardData (ReadCardDataRequest request) |
Retrieve Card Data More... | |
void | DisplayPaymentReceiptOptions (DisplayPaymentReceiptOptionsRequest request) |
Show the customer facing receipt option screen for the specified Payment. More... | |
void | ShowDisplayOrder (DisplayOrder order) |
Show the DisplayOrder on the device. Replaces the existing DisplayOrder on the device. More... | |
void | RemoveDisplayOrder (DisplayOrder order) |
Remove the DisplayOrder from the device. More... | |
void | RetrievePendingPayments () |
Request a list of pending payments from the device. Pending payments are payments taken offline that have not yet been sent to the server More... | |
void | Dispose () |
Disposes the connection to the Clover device. After this is called, the connection to the device is severed, and the CloverConnector object is no longer usable. Instantiate a new CloverConnector object in order to call InitializeConnection(). More... | |
void | InvokeInputOption (InputOption io) |
Invoke the InputOption on the device More... | |
T | GetEnumFromString< T > (string stringValue, bool isCaseInsensitive=false) |
void | OnDeviceError (CloverDeviceErrorEvent ee) |
void | AcceptPayment (Payment payment) |
If Payment confirmation is required during a transaction due to a Challenge, this method accepts the Payment. A Challenge may be triggered by a potential duplicate Payment or an offline Payment. More... | |
void | RejectPayment (Payment payment, Challenge challenge) |
If Payment confirmation is required during a transaction due to a Challenge, this method rejects the Payment. A Challenge may be triggered by a potential duplicate Payment or an offline Payment. More... | |
void | StartCustomActivity (CustomActivityRequest request) |
Starts a Custom Activity on the Clover device. Note: The Custom Activity must already be set up and configured on the Clover device. More... | |
void | SendMessageToActivity (MessageToActivity request) |
Sends a message to a Custom Activity running on a Clover device. More... | |
void | RetrieveDeviceStatus (RetrieveDeviceStatusRequest request) |
Sends a message requesting the current status of the Clover device. More... | |
void | RetrievePayment (RetrievePaymentRequest request) |
Requests the Payment information associated with the externalPaymentId passed in. Only valid for Payments made in the past 24 hours on the Clover device queried. More... | |
void | OpenCashDrawer (OpenCashDrawerRequest request) |
Opens the first cash drawer found connected to the Clover device. The reason for opening the cash drawer must be provided. More... | |
void | Print (PrintRequest request) |
Sends a print request using the PrintRequest object. Used to print text, Bitmap image objects, and images from URLs using the specified printer. More... | |
void | RetrievePrinters (RetrievePrintersRequest request) |
Queries available printers attached to the Clover device using the RetrievePrintersRequest object. More... | |
void | RetrievePrintJobStatus (PrintJobStatusRequest request) |
Queries the status of a print job using the PrintJobStatusRequest object. More... | |
void | DisplayReceiptOptions (DisplayReceiptOptionsRequest request) |
Display receipt options for a Credit, Refund, or Payment More... | |
void | RegisterForCustomerProvidedData (RegisterForCustomerProvidedDataRequest request) |
Register to receive customer data with the Clover Loyalty API More... | |
void | SetCustomerInfo (SetCustomerInfoRequest request) |
Set the Loyalty API's current customer info More... | |
void | SetLogLevel (int level) |
Set the current Log Level to filter log messages. Use constants from the LogLevel class for convenience. More... | |
Public Member Functions inherited from com.clover.remotepay.sdk.ICloverConnector | |
void | InvokeInputOption (transport.InputOption io) |
Sends a keystroke to the Clover device that invokes an input option (OK, CANCEL, DONE, etc.) on the customer's behalf. InputOptions are on the CloverDeviceEvent passed to OnDeviceActivityStart(). More... | |
Public Attributes | |
const int | CARD_ENTRY_METHOD_MAG_STRIPE = 1 | (1 << 8) | ENABLE_KIOSK_ENTRY_METHODS |
const int | CARD_ENTRY_METHOD_ICC_CONTACT = 2 | (2 << 8) | ENABLE_KIOSK_ENTRY_METHODS |
const int | CARD_ENTRY_METHOD_NFC_CONTACTLESS = 4 | (4 << 8) | ENABLE_KIOSK_ENTRY_METHODS |
const int | CARD_ENTRY_METHOD_MANUAL = 8 | (8 << 8) | ENABLE_KIOSK_ENTRY_METHODS |
MerchantInfo | MerchantInfo => merchantInfo?.Clone() |
A copy of the current CloverConnector MerchantInfo from the DeviceReady message More... | |
string | ConnectionTitle => Config?.getCloverTransport()?.Title ?? "" |
The Configured Transport's Title, indicating USB, WebSocket, etc. in a display friendly format More... | |
string | ConnectionSummary => Config?.getCloverTransport()?.Summary ?? "" |
The Configured Transport's Summary, intended to be the web connection string or similar info as appropriate More... | |
Protected Attributes | |
CloverDevice | Device |
CloverDeviceConfiguration | Config |
Properties | |
SDKInfo | SDKInfo [get, protected set] |
SDK identification for reporting More... | |
bool | IsReady [get] |
Holds the current connection state More... | |
The main CloverConnector API for connecting to Clover Payment Devices, created via a CloverConnectorFactory transport setup call
Definition at line 37 of file CloverConnector.cs.
com.clover.remotepay.sdk.CloverConnector.CloverConnector | ( | ) |
Definition at line 109 of file CloverConnector.cs.
com.clover.remotepay.sdk.CloverConnector.CloverConnector | ( | CloverDeviceConfiguration | config | ) |
CloverConnector constructor
config | A CloverDeviceConfiguration object; TestDeviceConfiguration can be used for testing |
Definition at line 118 of file CloverConnector.cs.
void com.clover.remotepay.sdk.CloverConnector.AcceptPayment | ( | Payment | payment | ) |
If Payment confirmation is required during a transaction due to a Challenge, this method accepts the Payment. A Challenge may be triggered by a potential duplicate Payment or an offline Payment.
payment | The Payment to accept. |
Implements com.clover.remotepay.sdk.ICloverConnector.
Definition at line 1289 of file CloverConnector.cs.
void com.clover.remotepay.sdk.CloverConnector.AcceptSignature | ( | VerifySignatureRequest | request | ) |
If signature is captured during a Sale, this method accepts the signature as entered
request |
Implements com.clover.remotepay.sdk.ICloverConnector.
Definition at line 326 of file CloverConnector.cs.
void com.clover.remotepay.sdk.CloverConnector.AddCloverConnectorListener | ( | ICloverConnectorListener | connectorListener | ) |
Adds a Clover Connector listener.
connectorListener | The connection listener. |
Implements com.clover.remotepay.sdk.ICloverConnector.
Definition at line 93 of file CloverConnector.cs.
void com.clover.remotepay.sdk.CloverConnector.Auth | ( | AuthRequest | request | ) |
Auth method to obtain an Auth. While a Pre-Auth can also be accomplished by setting the IsPreAuth flag to true, the PreAuthRequest is the preferred request type. PreAuth functionality was retained for backward compatibility
request |
Implements com.clover.remotepay.sdk.ICloverConnector.
Definition at line 389 of file CloverConnector.cs.
void com.clover.remotepay.sdk.CloverConnector.CapturePreAuth | ( | CapturePreAuthRequest | request | ) |
Capture a previous Auth. Note: Should only be called if request's PaymentID is from an AuthResponse
request |
Implements com.clover.remotepay.sdk.ICloverConnector.
Definition at line 577 of file CloverConnector.cs.
void com.clover.remotepay.sdk.CloverConnector.Closeout | ( | CloseoutRequest | request | ) |
Send a request to the server to closeout all orders.
request |
Implements com.clover.remotepay.sdk.ICloverConnector.
Definition at line 910 of file CloverConnector.cs.
void com.clover.remotepay.sdk.CloverConnector.DisplayPaymentReceiptOptions | ( | DisplayPaymentReceiptOptionsRequest | request | ) |
Show the customer facing receipt option screen for the specified Payment.
Implements com.clover.remotepay.sdk.ICloverConnector.
Definition at line 1138 of file CloverConnector.cs.
void com.clover.remotepay.sdk.CloverConnector.DisplayReceiptOptions | ( | DisplayReceiptOptionsRequest | request | ) |
Display receipt options for a Credit, Refund, or Payment
request | The DisplayReceiptOptionsRequest details |
Implements com.clover.remotepay.sdk.ICloverConnector.
Definition at line 1525 of file CloverConnector.cs.
void com.clover.remotepay.sdk.CloverConnector.Dispose | ( | ) |
Disposes the connection to the Clover device. After this is called, the connection to the device is severed, and the CloverConnector object is no longer usable. Instantiate a new CloverConnector object in order to call InitializeConnection().
Implements com.clover.remotepay.sdk.ICloverConnector.
Definition at line 1242 of file CloverConnector.cs.
T com.clover.remotepay.sdk.CloverConnector.GetEnumFromString< T > | ( | string | stringValue, |
bool | isCaseInsensitive = false |
||
) |
T | : | struct | |
T | : | IConvertible |
Definition at line 1274 of file CloverConnector.cs.
void com.clover.remotepay.sdk.CloverConnector.InitializeConnection | ( | ) |
Initialize the connector with a given configuration
Implements com.clover.remotepay.sdk.ICloverConnector.
Definition at line 130 of file CloverConnector.cs.
void com.clover.remotepay.sdk.CloverConnector.InvokeInputOption | ( | InputOption | io | ) |
Invoke the InputOption on the device
io |
Definition at line 1254 of file CloverConnector.cs.
void com.clover.remotepay.sdk.CloverConnector.ManualRefund | ( | ManualRefundRequest | request | ) |
Manual refund method, aka "naked credit"
request | A ManualRefundRequest object |
Implements com.clover.remotepay.sdk.ICloverConnector.
Definition at line 829 of file CloverConnector.cs.
void com.clover.remotepay.sdk.CloverConnector.OnDeviceError | ( | CloverDeviceErrorEvent | ee | ) |
Definition at line 1284 of file CloverConnector.cs.
void com.clover.remotepay.sdk.CloverConnector.OpenCashDrawer | ( | OpenCashDrawerRequest | request | ) |
Opens the first cash drawer found connected to the Clover device. The reason for opening the cash drawer must be provided.
request | Request with text specifying the reason for opening the cash drawer. |
Implements com.clover.remotepay.sdk.ICloverConnector.
Definition at line 1410 of file CloverConnector.cs.
void com.clover.remotepay.sdk.CloverConnector.PreAuth | ( | PreAuthRequest | request | ) |
PreAuth method to obtain a PreAuth.
request |
Implements com.clover.remotepay.sdk.ICloverConnector.
Definition at line 491 of file CloverConnector.cs.
void com.clover.remotepay.sdk.CloverConnector.Print | ( | PrintRequest | request | ) |
Sends a print request using the PrintRequest object. Used to print text, Bitmap image objects, and images from URLs using the specified printer.
request | The PrintRequest details. |
Implements com.clover.remotepay.sdk.ICloverConnector.
Definition at line 1430 of file CloverConnector.cs.
void com.clover.remotepay.sdk.CloverConnector.ReadCardData | ( | ReadCardDataRequest | request | ) |
Retrieve Card Data
Implements com.clover.remotepay.sdk.ICloverConnector.
Definition at line 1098 of file CloverConnector.cs.
void com.clover.remotepay.sdk.CloverConnector.RefundPayment | ( | RefundPaymentRequest | request | ) |
Refund a specific payment
request |
Implements com.clover.remotepay.sdk.ICloverConnector.
Definition at line 758 of file CloverConnector.cs.
void com.clover.remotepay.sdk.CloverConnector.RegisterForCustomerProvidedData | ( | RegisterForCustomerProvidedDataRequest | request | ) |
Register to receive customer data with the Clover Loyalty API
request |
Implements com.clover.remotepay.sdk.ICloverConnector.
Definition at line 1554 of file CloverConnector.cs.
void com.clover.remotepay.sdk.CloverConnector.RejectPayment | ( | Payment | payment, |
Challenge | challenge | ||
) |
If Payment confirmation is required during a transaction due to a Challenge, this method rejects the Payment. A Challenge may be triggered by a potential duplicate Payment or an offline Payment.
payment | The Payment to accept. |
challenge | The Challenge that resulted in Payment rejection. |
Implements com.clover.remotepay.sdk.ICloverConnector.
Definition at line 1309 of file CloverConnector.cs.
void com.clover.remotepay.sdk.CloverConnector.RejectSignature | ( | VerifySignatureRequest | request | ) |
If signature is captured during a Sale, this method rejects the signature as entered
request |
Implements com.clover.remotepay.sdk.ICloverConnector.
Definition at line 356 of file CloverConnector.cs.
void com.clover.remotepay.sdk.CloverConnector.RemoveCloverConnectorListener | ( | ICloverConnectorListener | connectorListener | ) |
Removes a Clover Connector listener.
connectorListener | The connection listener. |
Implements com.clover.remotepay.sdk.ICloverConnector.
Definition at line 101 of file CloverConnector.cs.
void com.clover.remotepay.sdk.CloverConnector.RemoveDisplayOrder | ( | DisplayOrder | order | ) |
Remove the DisplayOrder from the device.
order |
Implements com.clover.remotepay.sdk.ICloverConnector.
Definition at line 1196 of file CloverConnector.cs.
void com.clover.remotepay.sdk.CloverConnector.ResetDevice | ( | ) |
Send a request to the mini to reset. This can be used if the device gets into a non-recoverable state.
Implements com.clover.remotepay.sdk.ICloverConnector.
Definition at line 934 of file CloverConnector.cs.
void com.clover.remotepay.sdk.CloverConnector.RetrieveDeviceStatus | ( | RetrieveDeviceStatusRequest | request | ) |
Sends a message requesting the current status of the Clover device.
request | The RetrieveDeviceStatusRequest details. |
Implements com.clover.remotepay.sdk.ICloverConnector.
Definition at line 1374 of file CloverConnector.cs.
void com.clover.remotepay.sdk.CloverConnector.RetrievePayment | ( | RetrievePaymentRequest | request | ) |
Requests the Payment information associated with the externalPaymentId passed in. Only valid for Payments made in the past 24 hours on the Clover device queried.
request | The RetrievePaymentRequest details. |
Implements com.clover.remotepay.sdk.ICloverConnector.
Definition at line 1390 of file CloverConnector.cs.
void com.clover.remotepay.sdk.CloverConnector.RetrievePendingPayments | ( | ) |
Request a list of pending payments from the device. Pending payments are payments taken offline that have not yet been sent to the server
Implements com.clover.remotepay.sdk.ICloverConnector.
Definition at line 1224 of file CloverConnector.cs.
void com.clover.remotepay.sdk.CloverConnector.RetrievePrinters | ( | RetrievePrintersRequest | request | ) |
Queries available printers attached to the Clover device using the RetrievePrintersRequest object.
request | The RetrievePrintersRequest details. |
Implements com.clover.remotepay.sdk.ICloverConnector.
Definition at line 1481 of file CloverConnector.cs.
void com.clover.remotepay.sdk.CloverConnector.RetrievePrintJobStatus | ( | PrintJobStatusRequest | request | ) |
Queries the status of a print job using the PrintJobStatusRequest object.
request | The PrintJobStatusRequest details. |
Implements com.clover.remotepay.sdk.ICloverConnector.
Definition at line 1501 of file CloverConnector.cs.
void com.clover.remotepay.sdk.CloverConnector.Sale | ( | SaleRequest | request | ) |
Sale method, aka "purchase"
request | A SaleRequest object containing basic information needed for the transaction |
Implements com.clover.remotepay.sdk.ICloverConnector.
Definition at line 159 of file CloverConnector.cs.
void com.clover.remotepay.sdk.CloverConnector.SendDebugLog | ( | string | message | ) |
Definition at line 969 of file CloverConnector.cs.
void com.clover.remotepay.sdk.CloverConnector.SendMessageToActivity | ( | MessageToActivity | request | ) |
Sends a message to a Custom Activity running on a Clover device.
request | The MessageToActivity details to send to the Custom Activity. |
Implements com.clover.remotepay.sdk.ICloverConnector.
Definition at line 1354 of file CloverConnector.cs.
void com.clover.remotepay.sdk.CloverConnector.SetCustomerInfo | ( | SetCustomerInfoRequest | request | ) |
Set the Loyalty API's current customer info
request |
Implements com.clover.remotepay.sdk.ICloverConnector.
Definition at line 1578 of file CloverConnector.cs.
void com.clover.remotepay.sdk.CloverConnector.SetLogLevel | ( | int | level | ) |
Set the current Log Level to filter log messages. Use constants from the LogLevel class for convenience.
level |
Implements com.clover.remotepay.sdk.ICloverConnector.
Definition at line 1606 of file CloverConnector.cs.
void com.clover.remotepay.sdk.CloverConnector.ShowDisplayOrder | ( | DisplayOrder | order | ) |
Show the DisplayOrder on the device. Replaces the existing DisplayOrder on the device.
order |
Implements com.clover.remotepay.sdk.ICloverConnector.
Definition at line 1172 of file CloverConnector.cs.
void com.clover.remotepay.sdk.CloverConnector.ShowMessage | ( | string | message | ) |
Show a message on the Clover Mini screen
message |
Implements com.clover.remotepay.sdk.ICloverConnector.
Definition at line 954 of file CloverConnector.cs.
void com.clover.remotepay.sdk.CloverConnector.ShowThankYouScreen | ( | ) |
Show the thank you screen on the device
Implements com.clover.remotepay.sdk.ICloverConnector.
Definition at line 1010 of file CloverConnector.cs.
void com.clover.remotepay.sdk.CloverConnector.ShowWelcomeScreen | ( | ) |
Return the device to the Welcome Screen
Implements com.clover.remotepay.sdk.ICloverConnector.
Definition at line 992 of file CloverConnector.cs.
void com.clover.remotepay.sdk.CloverConnector.StartCustomActivity | ( | CustomActivityRequest | request | ) |
Starts a Custom Activity on the Clover device. Note: The Custom Activity must already be set up and configured on the Clover device.
request | The CustomActivityRequest details. |
Implements com.clover.remotepay.sdk.ICloverConnector.
Definition at line 1334 of file CloverConnector.cs.
void com.clover.remotepay.sdk.CloverConnector.TipAdjustAuth | ( | TipAdjustAuthRequest | request | ) |
Adjust the tip for a previous Auth. Note: Should only be called if request's PaymentID is from an AuthResponse
request |
Implements com.clover.remotepay.sdk.ICloverConnector.
Definition at line 627 of file CloverConnector.cs.
void com.clover.remotepay.sdk.CloverConnector.VaultCard | ( | int? | CardEntryMethods | ) |
Vault Card information and payment token
Implements com.clover.remotepay.sdk.ICloverConnector.
Definition at line 1072 of file CloverConnector.cs.
void com.clover.remotepay.sdk.CloverConnector.VoidPayment | ( | VoidPaymentRequest | request | ) |
Void a transaction, given a previously used order ID and/or payment ID TBD - defining a payment or order ID to be used with a void without requiring a response from Sale()
request | A VoidRequest object containing basic information needed to void the transaction |
Implements com.clover.remotepay.sdk.ICloverConnector.
Definition at line 678 of file CloverConnector.cs.
void com.clover.remotepay.sdk.CloverConnector.VoidPaymentRefund | ( | VoidPaymentRefundRequest | request | ) |
request |
Implements com.clover.remotepay.sdk.ICloverConnector.
Definition at line 732 of file CloverConnector.cs.
const int com.clover.remotepay.sdk.CloverConnector.CARD_ENTRY_METHOD_ICC_CONTACT = 2 | (2 << 8) | ENABLE_KIOSK_ENTRY_METHODS |
Definition at line 41 of file CloverConnector.cs.
const int com.clover.remotepay.sdk.CloverConnector.CARD_ENTRY_METHOD_MAG_STRIPE = 1 | (1 << 8) | ENABLE_KIOSK_ENTRY_METHODS |
Definition at line 40 of file CloverConnector.cs.
const int com.clover.remotepay.sdk.CloverConnector.CARD_ENTRY_METHOD_MANUAL = 8 | (8 << 8) | ENABLE_KIOSK_ENTRY_METHODS |
Definition at line 43 of file CloverConnector.cs.
const int com.clover.remotepay.sdk.CloverConnector.CARD_ENTRY_METHOD_NFC_CONTACTLESS = 4 | (4 << 8) | ENABLE_KIOSK_ENTRY_METHODS |
Definition at line 42 of file CloverConnector.cs.
|
protected |
Definition at line 49 of file CloverConnector.cs.
string com.clover.remotepay.sdk.CloverConnector.ConnectionSummary => Config?.getCloverTransport()?.Summary ?? "" |
The Configured Transport's Summary, intended to be the web connection string or similar info as appropriate
Definition at line 71 of file CloverConnector.cs.
string com.clover.remotepay.sdk.CloverConnector.ConnectionTitle => Config?.getCloverTransport()?.Title ?? "" |
The Configured Transport's Title, indicating USB, WebSocket, etc. in a display friendly format
Definition at line 66 of file CloverConnector.cs.
|
protected |
Definition at line 48 of file CloverConnector.cs.
MerchantInfo com.clover.remotepay.sdk.CloverConnector.MerchantInfo => merchantInfo?.Clone() |
A copy of the current CloverConnector MerchantInfo from the DeviceReady message
Definition at line 61 of file CloverConnector.cs.
|
get |
Holds the current connection state
Definition at line 88 of file CloverConnector.cs.
|
getprotected set |
SDK identification for reporting
Definition at line 76 of file CloverConnector.cs.