Release v329

Merge pull request #122 from clover/r329

Release 329

Release v328

Merge pull request #118 from clover/r328

Release 328

Release v326

Merge pull request #115 from clover/r326

Release 326

Release v323

Merge pull request #114 from clover/r323

Update for r323 Example Activity

Release v322

Merge pull request #108 from clover/r322

Release 322

Release v320

Merge pull request #106 from clover/r320

Release 320

Release v316/316.1

Merge pull request #104 from clover/r316

Release 316

Release v306

The following data model changes, new features, improvements, deprecations, and bug fixes are available in the release of Clover Android SDK v306.

Data model changes

Added classes for ItemOverride, ModifierOverride, and LayoutOverride.

New features and improvements

Added:

• Batch details to the refund details page.
• New column in theorders.order_fee table named service_charge_uuid.

Semi-integration

Enabled printing of TipSuggestion overrides.

Restaurant Solutions

Added:

• defaultPosMenu in response to menu sync API. This lets the device discover if the menu is defaultPosMenu.
• menuId in the menu and category tables.
• Method fireLineItems() to OrderConnector to directly fire the line items to the printer in case of Auto-Coursing.

Payments—Core Processing App

Added a pre-auth start screen to the Station Duo Register app. The screen message instructs the customer to present their card.

Payments

Batched the following reference number details on the refund details page:

• Batch ID
• Batch date and time
• Funding date

Added:

• New attribute when creating pre-auth—Payment.paymentAttribute.createAuth = true in ServiceFeeRequest params.
• New service fee API on Auth server.

Point of sale

Added public helper methods in OrderCalc to use order fee calculation APIs from Calc.

Clover Android SDK

New features and improvements

Updated:

• OrderService and OrderUpdateListeners to support applying or removing order fees from the order.
• Clover Android SDK to allow parameters EXTRA_TRANSMIT_UPC_A_PREAMBLE and EXTRA_TRANSMIT_UPC_A_CHECK_DIGIT to pass when starting a barcode scanner app.

Added:

• Support for orderId in PayRequestBuilder.
• New OrderConnector.capturePreauthorization().
• PAYMENT_TYPE and CREATE_AUTH to PayIntent.
• TipAdjust() builder for TipAdjustRequestIntentBuilder.
• Option to the install_apps.py script to use -s or --serial arguments to specify a device. This is sometimes easier than setting the ANDROID_SERIAL environment variable.

Bug fixes

Added:

• Payment ID to receipt contract.
• isSquareDisplay() method to Platform2 to identify square displays. A display is considered square if its aspect ratio is less than or equal to 4/3rds.

Release v304

SDK 304

clover-android-sdk

Data model changes

The following data model changes, new features, improvements, deprecations, and bug fixes are available since the release of Clover Android SDK v293.

Payments

Added a reason column to the credit_refund table in the orders database. This revision updates the CreditRefund class in com.clover.sdk.v3.payments to support that column.

Restaurant Solutions

Added:

• Classes for multiple menu overrides—ItemOverride, ModifierOverride, LayoutOverride.
• Support for multiple devices for Auto Coursing.
• device_id in the print group POJO and changed it to type string.

New features and improvements

Added:

• New parameter in the RegionalExtras class for the merchant ID for Argentina.
• Orders API for a refund by amount (Transaction App).
  POST /v3/merchants/{mid}/orders/{orderId}/refunds

  {  
    "refunds": { "elements": [{ "amount": 1234, "payment": { "id": "ID1" } }] }
    "includeTip": true
  }

Semi-integration

Added:

• Email marketing opt-in for remote receipts.
• Capability for an integrator to prompt for a receipt for payment, credit, and refund. The developer needs to provide the payment ID and indicate whether it is a merchant or customer-facing prompt.
• TipOptions to CloseoutRequestIntentBuilder.

Payments

• Updated void_on_refund API with deletedTime field changes.
• Added:
  • EXTRA_EMPLOYEE_NAME so that it is returned as an intent data result to apps like payments, which request manager and admin override.
  • Support for tenders for Partial Refund By Amount.
  • Extra constant in CardTransactionConstants for ORIGINAL_AMOUNT for partial payment card transaction.
  • New void reason USER_CANCEL_SYNC for a synchronous void call.
  • RequestTip intent builder for prompting a customer for an on-screen tip amount.
  • MANAGER_ID and MANAGER_NAME to payIntent.
  • addAuthorization to OrderConnector.
  • TenderOptions to PaymentRequestIntentBuilder.
  • Ability to retrieve open payments through the Payments API.
  • labelKey field in the anomaly_reasons_avsc in the schema-tool for locale support and merchant reference and updated the AnomalyReasons.java artifact in clover-android-sdk.
• Removed VoidPreauthRequestIntentBuilder and PaymentRefundRequestIntentBuilder to use ReversePaymentRequestIntentBuilder.

Point of sale

Updated addItem broadcast Intent to send a broadcast when items are removed from an order. The broadcast contains a list of line-item universally unique identifiers (UUIDs) and their corresponding inventory-item UUIDs, the same as when items are added to an order. This feature does not require the receiving app to be running to get the notification.

Clover Android SDK

Updated the Clover Android SDK to allow parameters EXTRA_TRANSMIT_UPC_A_PREAMBLE and EXTRA_TRANSMIT_UPC_A_CHECK_DIGIT to pass when starting a barcode scanner app.

Android apps

Clover may temporarily block or permanently remove Receipt Registration providers who repeatedly fail to respond. Make sure your Receipt Registration provider responds within the documented time limit of two seconds.

Bug fixes

Payments

• Fixed an issue where the manual entry option was missing on some devices. Revised PayIntent for Payments manual card entry without EBT tender selection from custom tender buttons.
• Added EXTRA_EXIT_IN_CUSTOMER_MODE to have Billsplit enable CustomerMode on a normal successful exit.
• Removed the deprecated warning from EXTRA_ORDER_ID. It is not deprecated.

Release v293

SDK 293

clover-android-sdk

Data model changes

• Added partner_tax to the tax_type enum to display partner taxes (non-editable by the merchant).

New features and improvements

Payments API

• Updated OrderStateService and OrderStateReceiver classes to enable next-gen modeled customer identification process.

Added:

• TipAdjustRequestIntentBuilder to allow tip adjustment on an existing pre-auth and capture the payment for the final amount.
• RetrieveCreditRequestIntentBuilder class to retrieve a previously processed credit on a Clover device.
• creditId and refundId parameters to RetrieveCreditRequestIntentBuilder.

Semi-integration

• Removed static class from SessionContentObserver to static designation.

Bug fixes

Payments

• Defined ‘PURCHASING_CARD’ to the Module enum.
• Added remoteReceipts to enable or disable print/SMS/email receipts instead of cloverShouldHandleReceipts.