Release 228.3

SDK v228.3

clover-android-sdk

Data model changes

The following objects were updated:

• CardTransaction - added currency
• CreditRequest - added paymentCard
• IdentityDocument - added id, createdTime, modifiedTime, deletedTime, and payment
• Payment - added attributes
• PendingPaymentEntry - added externalId and tipAmount
• TipSuggestion - added amount (as an alternative to percentage)
• TransactionInfo - added emergencyFlag and reversalStandRefNum

New features

• The ImagePrintJob2 class was added to replace the now-deprecated ImagePrintJob. The new class does not use the device’s built-in storage, so merchants will not need to do anything to remove old image data.
• The Lockscreen class was added to make it easier for apps to lock and unlock the device programmatically. The EmployeeConnector#login() and EmployeeConnector#logout() methods have been deprecated and should be replaced with Lockscreen#unlock() and Lockscreen#lock(), respectively. You can see a basic implementation in the examples repo: LockScreenTestActivity.java
• New methods were added to OrderCalc. getPriceWithoutVAT() and getPriceWithVAT() allow you to more easily retrieve line item pricing data when an item can be sold with or without VAT. getServiceChargeBeforeRefunds() returns the gross service charge. getLineExtendedPrice() returns the line item price without any discounts or modifiers.
• The SDK now contains a full content provider contract for inventory. See com.clover.sdk.v3.inventory.InventoryContract for more information.
• StaticReceiptPrintJob was updated so receipt footer images can be added from a URI.
• A ServiceFeeConnector was added to allow payment apps to easily perform two fee-related actions: payServiceFee and refundServiceFee. See the documentation for complete details: ServiceFeeConnector.

Deprecations

• The CashDrawer#open methods have been deprecated because calls to these methods fail silently or crash applications in some cases. New CashDrawer#open2 methods have been added as replacements. Be sure to read the CashDrawer documentation for the new methods and understand what the return values indicate.
• The EmployeeConnector#login and EmployeeConnector#logout methods have been deprecated and should be replaced with Lockscreen#unlock and Lockscreen#lock, respectively.

clover-android-sdk-examples

The following samples have been created or updated for v228.3:

• Lockscreen (android/sdk/examples/LockScreenTestActivity.java)
• Order with custom items (android/sdk/examples/CustomItemTestActivity.java)
• Printers (android/sdk/examples/PrintTaskTestActivity.java)
• Receipts from URIs (android/sdk/examples/ImagePrinterActivity.java)

clover-android-connector-sdk (Payment Connector)

Data model changes

The following objects were updated:

• TransactionType - added nine new constants

Release 221.9

clover-android-sdk

Data model changes

The following objects were added:

• DeviceTotalStats

The following objects were updated:

• BatchDetail - added deviceTotals
• Guest - added name, order, and table
• Credit - added merchant and externalReferenceId
• GatewayTxState - added EXTERNAL
• IdentityDocument - added id, payment, createdTime, deletedTime, and modifiedTime
• Payment - added voidPaymentRef
• Refund - added cardTransaction, merchant and externalReferenceId
• TransactionInfo - added cardSymbol
• VoidReason - added USER_CUSTOMER_CANCEL

Bug fix

• Corrected a resource leak encountered when creating orders

clover-android-connector-sdk (Payment Connector)

New features

• The resetDevice() method has been added to the interface. This allows apps to reboot a device in an invalid state, but it should not be relied upon to safely exit the payment flow due to the possibility of missed information from the device. This method is supported on Clover Flex, Clover Mini, and Clover Mobile.

Deprecations

• The PaymentConnector (Context, Account, IPaymentConnectorListener) constructor has been deprecated and should be replaced with PaymentConnector (Context, Account, IPaymentConnectorListener, String). The fourth parameter in the new constructor is your app’s remote application ID (RAID), a unique value used by Clover to provide better troubleshooting and support for integrated applications. In the near future, apps not supplying a RAID will experience delayed payment processing times.

Release 219.5

clover-android-sdk

Data model changes

The following objects were added:

• DefaultMid
• MccSource
• MerchantGatewayEntitlementConfiguration
• RegionalExtras

The following objects have been updated:

• MerchantGatewayEntitlement - added entitlementConfigurations
• TokenRequest - added merchant and transactionInfo
• TransactionInfo - added isTokenBasedTx, origTransactionSequenceCounter, reversalReason, and transactionSequenceCounterUpdate
• TransactionSettings - added regionalExtras

Bug fix

• Added intents to properly process pre-auth transactions on Station and Station 2018

Removals

• The v1 AppConnector and AppIntent classes have been removed. As a result, apps will no longer be able to use the AppConnector#notify methods to push message. Two REST API endpoints are available as replacements:

  • POST /v3/apps/{aId}/merchants/{mId}/notifications
  • POST /v3/apps/{aId}/devices/{dId}/notifications

clover-android-connector-sdk (Payment Connector)

New features

• Support for regionalExtras was added to the relevant transaction types. This data can be used by developers targeting merchants in Argentina. See Supporting regional payment flows for more information.

Bug fix

• Fixed an issue where an existing order could not be attached to a payment made by the Payment Connector (sale, auth, or pre-auth)

clover-android-loyalty-kit

Bug fix

• Fixed an issue where the LoyaltyDataTypes#removeListedType() method did not actually remove the type.

Release 215

Merge pull request #63 from clover/r215

R215

Release 213

NEW

• com.clover.sdk.util.Platform2 class
  Introduced the new class to provide a future-proof method of building apps across both current and future Clover devices

DEPRECATED

• com.clover.sdk.util.Platform class

NOTE: The new Platform2 class is a partial replacement because we will deprecate the older Platform class by June 2019. For that duration, both the Platform2 and Platform classes will be available with Clover Android SDK. For details, see the announcement on Developer Docs.

Release 210.1

210.1

Release 191.6

Fixes to CashDrawer Permissions

Release 137

r137

Release 133

r133

Release 132

r132