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
andpercentage
values are not present in your request, their values default to0
.
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
andpercentage
values are not present in your request, their values default to0
.
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:
Permission | Request |
---|---|
Read | GET /v3/merchant/{mId}/discounts GET /v3/merchant/{mId}/discounts/{ID} |
Write | POST /v3/merchant/{mId}/discounts POST /v3/merchant/{mId}/discounts/{ID} DELETE /v3/merchant/{mId}/discounts/{ID} |
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.
Updated about 3 years ago