Release Notes - May 16th, 2018

We have released the following improvements and bug fixes to the Clover Sandbox environments:

Improvements

New Discounts API Endpoint

We are introducing a new discounts REST API endpoint. With this endpoint, you can create, modify, and delete discounts for Clover merchant inventory:

• Get all discounts: You can request for all discount elements and also apply filtering, sorting, and pagination.

GET /v3/merchant/{mId}/discounts

**Sample response**:

{
  "elements": [
      {
         "id": "CPVNDXVTAKQY8",
         "name": "discount",
         "amount": 0,
         "percentage": 0
      },
      {
         <ELEMENT_2>
      },    .
            .
            .
      {
         <ELEMENT_n>
      }
   ]
}

• Get a single discount: You can request for a discount element by specifying its UUID.

GET /v3/merchant/{mId}/discounts/{ID}

• Create a discount: When you create a new discount, a UUID for the discount is automatically generated. If the amount and percentage values are not present in your request, their values default to 0.

POST /v3/merchant/{mId}/discounts

**Sample request**:

{
  "name": "discount",
  "amount": 0,
  "percentage": 0
}

• Update a discount: You can update a discount by specifying its UUID. If the amount and percentage values are not present in your request, their values default to 0.

POST /v3/merchant/{mId}/discounts/{ID}

• Delete a discount: You can delete a discount by specifying its UUID.

DELETE /v3/merchant/{mId}/discounts/{ID}

To use the discounts API endpoint, the following inventory permissions must be set in your app's Settings > Required Permissions page on the Developer Dashboard:

Setting notes using Developer Pay API (US Only)

We are introducing a new note parameter in the pay REST API endpoint schema. The parameter accepts string values, and you can use it for storing order-related additional information, such as customer ID.

Remote Pay SDK Updates

The remote pay SDK for iOS has been updated to v1.4.3 (https://github.com/clover/remote-pay-ios/releases).

Bug Fixes

Accepting tip amounts in custom tender gift card transactions

When customers want to pay for a transaction using a gift card on a custom tender device, they can choose to add a tip amount to the transaction. Our bug fix now adds the tip amount to the transaction and correctly charges the gift card.

Please test these changes in your Clover Sandbox environments. For questions and feedback, please use https://community.clover.com.

To receive more 3rd party developers communication from Clover, sign up here.