March 31, 2015

Permissions Versus Modules

As a developer, you can think of permissions and modules along similar lines: you should strive to use only the minimum of permissions necessary in order to avoid distrust from merchants, and you should select only those modules that apply to your app in order to let your app reach as many merchants as possible. However, it is important to understand the different roles the two settings play.

Permissions are how a merchant can opt in to allowing your app to read or write to specific categories of their business’ data. If a merchant has downloaded your app, they have approved each of your 'permission' types. We keep track of what permissions your app has been given, and will only allow access where permissions are present. For example, without 'Read Orders' permission, you will be unable to access a merchant’s order information through the SDK or the REST API. 

Modules are part of the upcoming app bundles, available to Clover Mini and Clover Mobile merchants. They are designed to limit your app to merchants with appropriate capabilities. Each module represents a category of resources and data which is available to merchants whose bundles include that module, and are not available to merchants whose bundles exclude it. You should use modules to indicate which features your app needs in order to minimally function. For example, if your app relies on merchant and item data, you will need to select the Merchant and Items modules. Because the Items module is not included in the Terminal Bundle, merchants on that bundle will not be able to install your app.

Note: unlike permissions, we currently do not limit API or SDK calls based on modules.

March 25, 2015

Order API Notice


A recent change to the Orders API means that unless otherwise given explicit modifiedTime or createdTime parameters, the endpoint returns only orders with a modified date within the last two weeks. This may have caused some unexpected behavior as the query dropped orders not modified within the last two weeks.

The two week limit will be removed Thursday night. In the meantime, a workaround is to include any valid modifiedTime or createdTime or clientCreatedTime parameters.

March 24, 2015

What's New with the 22 March Release

The entire Clover team is thrilled about the upcoming launch of Clover Mobile, Clover Mini, and our new merchant software plans. In the coming weeks, you can look forward to getting all of the details about these new devices, as well as how you can best utilize our new plans as a developer.

For now, we have a sneak peek of the new system as we prepare with an update to your developer dashboard.

The Developer Dashboard > Your App > Edit App menu now includes a section for setting which modules your application requires:

The new Required Modules menu

Think of these modules along the same lines as permissions. Select only the categories of data your application will require to operate.

After the upcoming release, merchants using Clover Mobile or Clover Mini will have the opportunity to register for two new kinds of merchant plans as alternatives to the Classic plan, which comes with our current Clover Station. 

Each plan will have access to a different set of modules:

Modules by Merchant Plan

Although an app's module settings will not take effect until after the coming release, we recommend that you get a head start by selecting only those categories of data needed by your app. This will ensure that your app will target the widest user base possible as we welcome a new community of Clover Mobile and Clover Mini based merchants.

March 16, 2015

What's New with the 9 March Release

With the latest release we have given the developer's Charges panel some great new functionality. It is easier than ever to review your subscription data.

  • The Developer Dashboard > Charges page now supports the export of charge data in CSV format.
The charges export dropdown

This report includes:

Charge ID
Charge Date
Install Date
Uninstall Date
Merchant ID
Merchant Name
App ID
App Name
Charge Type
System Type
Subscription Name

CSV report left side
CSV report right side

  • The Charges page also now displays monthly totals.

Charges Summary display

  • Finally, the Charge Date heading on the  Charges page, now includes both the install, and uninstall dates of the charged merchant.