Order API Notice

PLEASE NOTE:

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.

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.

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
Currency
Amount
Status
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.

What's New with the 24 February Release

With this week's release we have some new tools to help developers stay responsive to their merchant user base.

Remember to keep an eye on the Latest Releases Feed to keep up with merchant facing updates.

IMPORTANT UPCOMING CHANGE:

As of 3/1/15 Clover will be transitioning its billing structure for merchants. Payment will shift from credit card billing through BrainTree to direct deposits from the merchant's bank account. You will notice that the pending period now includes an "In Progress" step after the transaction has started processing.

Under the new system, Clover billing and disbursement will all take place on a monthly basis. Clover will charge a single fee to each merchant's bank account every month. This will include the previous month's per-action charges, new subscriptions (pro-rated), existing subscriptions for the next month and any refunds owed to the merchant.

Dashboard Updates:

• In preparation for building out our OrderType functionality, and as a teaser of things to come, order types can now be set with a number of new options. (These options will not be honored by Clover apps yet.) You can take a look at the new choices by navigating to Merchant Dashboard > Setup > Order Types and selecting Add Order Type:

The New Order Type dialogue 

New Order Type settings include:

Custom hours

Whether to display the type as an option in the Register app

Which inventory categories are available per order type

Min/Max order amounts

Special fees

Delivery radius and average delivery time

Dashboard Bug Fixes:

• The main page of App Market now displays the correct "starts at" pricing amounts for logged out users.

• New subscription tiers and pricing can now be added after an app already has active subscribers.

Webhooks Updates:

• Merchant webhook will now send UPDATE notifications when a merchant changes properties such as their business hours, phone number, or order types.

• The Webhooks server will now enforce a back off for clients returning error responses. After a threshold of 5 errors the server will begin to delay it's notifications with sequentially increasing back off times.

What's New with the 3 February Release

Time for another round of the latest from the Clover team. Leading the charge in this week's release are several new dashboard updates aimed at helping your app to look its best in the App Market.

Some of you Android developers will be excited to hear we have also increased the APK upload size limit from 10MB to 32MB.

As always, be sure to take a look at the Latest Releases Feed to catch up on all of the merchant-facing changes.

Dashboard Updates:

• Subscriptions will be ordered by price from least to most expensive on the app's details page.

• On the App Market main page, apps with multiple subscriptions will now be listed as 'Starts Free' or 'Starts at...' your lowest tier.

• Uploaded app videos are displayed at a larger size on the app's details page.

Updated pricing style on listings

New, larger app video

Dashboard Bug Fixes:

• App screenshots can now be deleted from the Edit App page

API Updates:

• The taxRates field is now expandable for the v3/merchants/{mID} endpoint

SDK Updates:

• The APK size limit for uploading Clover apps has been increased to 32MB

• The Clover SDK inventoryContract now exposes Item.MODIFIED_TIME

What's New with the 19 January Release

Hi all, for those I haven't interacted with yet I am a recent addition to the Clover team, here to help provide useful resources and support to our rapidly expanding community of 3rd party developers.

As a part of that program I will be regularly updating this blog with details about Clover's new releases likely to impact the developer community. (For merchant facing release info, check out the Latest Releases feed here.)

Here are the changes to look out for in the 19 January release:

Updates:

• We have updated our developer terms (https://www.clover.com/developer_agreement) 

New Features:

• Subscription rates and metered actions now have separate sub-listings for each country where the app will be available. From the US market, the United States is currently the only country option. The EU market has options for the United Kingdom and Ireland. 

If your pricing status has been approved, you can manage these settings by clicking the 'Add Country' button under the payment type listing. 

Please Note: Setting the price for a country signals availability for that app.

US:

EU:

If you are developing for the EU market and your pricing status has not yet been approved, you can select the countries where you intend to make your app available with the 'Availability' settings on the 'Edit App' screen

EU only:

• The App Market now supports a 'subscriptionId' URL query string which allows external links to an app with one subscription option pre-selected. (e.g. Charity Checkout's free subscription)

Deprecations:

• The "a" route www.clover.com/appmarket/a/[appId] has been deprecated.  Instead use the "apps" route www.clover.com/appmarket/apps/[appId] 

Introducing Clover Mobile

Clover Mobile, the world's first mobile, integrated POS device with EMV chip card,
NFC contactless, and on-screen PIN entry. 

Clover’s mission is to put an API on every store on the planet. This was born out of the frustrations that we as app developers targeting merchants had: it was difficult to impossible to build and distribute our innovations to small- and medium-business. We've made great strides over the past year, having sold nearly 30,000 Clover Stations through our parent company, First Data, and their merchant acquiring partners such as Bank of America, Wells Fargo, PNC, and SunTrust. We've launch the Clover App Market, where many apps are now live and many are in development.

Today we take a giant leap forward in achieving our mission: we’re proud to introduce Clover Mobile, the world’s first integrated, open, mobile POS system with all modern payment interfaces: EMV chip card reader, NFC reader, magnetic stripe reader, on-screen PIN entry, and 1D/2D barcode scanner. We believe Clover Mobile will become the “swiss-army knife” computing device in stores, and we're inviting you to develop apps for it.

A Better Terminal

The humble single-function payment terminal is the most ubiquitous device in real-world commerce. There are 17 million payment terminals sold every year worldwide. Clover Mobile may be used only as a payment terminal at a shop on day 1, but on days 2, 3, and 4 it will be used for loyalty programs, CRM, voucher and coupon redemption, employee time cards/scheduling/management/payroll, physical+mobile gift cards, inventory management, alternative payments, customer membership programs, and the full integrated POS system over time. We find that many of these apps either have payments somewhere in their flows, or are better because of the integration in some key way. We’re not picking the winners and are not so arrogant we think we can do everything ourselves: this is why we have an open API both on the device side (where you can write Android apps) and on the cloud (with our REST-ful web APIs).

Design Thinking & Technical Details

Clover Mobile is a modern tablet augmented with payment superpowers:

• Quad-core Tegra 4 SoC
• Clover’s hardened version of Android (AOSP) 4.4
• 7" 1280x800 display
• Dedicated secure processor for payment interfaces
• EMV chip card reader, NFC reader, MSR reader
• On-screen PIN entry (w/ solution for the visually impaired)
• World-class 1D/2D trigger-activated barcode scanner
• LSR rubber bezel and handle base for soft landings
• Charging base
• WiFi, Bluetooth (w/ Bluetooth LE/Smart), and optional 3G
• Bluetooth+BLE thermal receipt printer

Clover Mobile has a rather distinct feature for a tablet: a handle. We wanted to build an industrial-class device without appearing industrial. The handle makes the device easy to carry all day long while scanning barcodes, inserting chip cards, and swiping. It also provides an integrated stand for presenting the device to customers.

Start Developing Now

We'll be providing a developer hardware program soon (sign up here if you're interested). Until then, get started at www.clover.com/developers. The Android and Web APIs that exist for Clover Station all work on Clover Mobile, and there will be a number of APIs specific to Clover Mobile's unique features, primarily around secure payments. You can build any app you want, using our secure payment application.