Clover Platform Docs

What's new

February 2021


Filtering Ecommerce API requests by UNIX time

For any Ecommerce API request, the created or modified time in the JSON response is in the Unix time format. You can now filter any Ecommerce GET request by created time in the Unix time format.

For example, to retrieve all charges created after a specified Unix timestamp, send a GET request to /v1/charges?{unix-time}.

November 2020

Developer Dashboard

Review failed disbursements with new Disburse Failed status

You can now identify which payments Clover couldn't disburse to you using the Disburse Failed status. To ensure you receive deposits from Clover update your bank information. Learn more.

September 2020

Track Days Since Merchant Not Active

The billing_info endpoint now includes the daysLapsed field. This is the number of days since the merchant's account was in an active status. Learn more.

Developer Dashboard

Expand App Availability in New Regions

When you make your published app available in new regions, you can now add metered pricing. Learn more.

Add metered tiers in new regions

July 2020

Developer Dashboard

Change Price on Metered Events

You can now change the price for a metered event. Existing merchants will still see the old price until they uninstall the app. You must inform merchants of the price changes. Contact App Market business with your request and detailed justification for why you need to change your metered price. Our team will review the request and work with you to update the price.

For example, if the price of a commodity changes, you can work with Clover App Market to change the metered event price for your app. Learn more.

June 2020

Take App Payments in UK with Tyl by NatWest

You can now take app payments in the UK with our new channel partner Tyl by NatWest. Your payments will be funded in UK GBP and foreign exchange and fees may be assessed by your bank. See the announcement to learn more.

Restrict Apps for Healthcare Merchants in US

If your apps use customer or inventory read-write permissions, newly boarded US-based merchants in healthcare will not be able to install or use those apps. Examples of merchant categories with protected health information are ambulances, chiropractors, hospitals, or drug stores.

These merchants will not see the Install button for such apps on the Clover App Market. Learn more.

Gain Insights Into Your App's Performance

Leverage the metrics on the Developer Dashboard to gain visibility into your merchant app installs and revenue earned over a period of time. You can:

  • Drill down from the Overview page to view the performance of your apps in the past 12 months.
  • Analyze trends, and how installs break down across tiers, countries, and devices.
  • Track merchant attrition and new installations and take action to improve your apps to increase your install base.
  • Review the revenue generated in the last 12 months and which apps are performing best on the Billing > Statements page.

Learn more.

May 2020

Bulk Export API

Use the Export API to obtain bulk payment and order data from merchants who have installed your app. This service does not run in real-time, so your chance of running into API limit restrictions is less. Learn more.

Developer Dashboard

Extend Trial Period for Metered Pricing

You can now provide extended trial periods for apps using the metered pricing tiers. In the Pricing & Distribution page of your paid app, in the Free Trial section, select an option from 14 days to 90 days to extend various offers for merchants to try your apps. Learn more.

Define App Categories

Use App Categories to target specific merchant businesses and ensure a smooth approval with Clover's App Market team. App categories allow Clover to categorize the requirements for the target businesses your app is designed for. The selected category appears on the Market Listing page for your app. Learn more.

Apr 2020

Developer Dashboard

Choose Free Trial Period Days for Your App

You can now choose from the extended options we provide for offering a free trial period for your apps. In the Pricing & Distribution page of your paid app, in the Free Trial section, select an option from 14 days to 90 days to extend various offers for merchants to try your apps. Learn more.

Screenshot of UI showing the list containing flexible free trial options.

View a Sample Functional Video

See an example of a functional video and description to refer when you submit your app for approval. The video should help our team visualize your app's functional flow and how it benefits the merchant. Providing a helpful video is key to a smoother app approval process with Clover's App Market team. Learn more.

Enable Two-Factor Authentication

Ensure your developer account is secure by enabling two-factor authentication if you process credit cards. It is critical in these times to protect merchants and their data.

When you log in to your account, you will now be required to enable two-factor authentication if you haven't already done so. Learn more.

Screenshot of pop-up window that appears when you log into your developer account.

Mar 2020

Manage Ecommerce Settings for Apps

If you select certain permissions for payments data—such as amounts, orders, payment types, or refunds—you can configure your ecommerce settings to state whether your app uses the API or hosted iframe. This selection has an impact on your PCI compliance burden. Learn more.

Screenshot of UI which shows the options for various ECommerce integrations - Hosted iFrame vs the API

Clover App Market

Use Ratings and Reviews Without Login

Clover merchants can now see the Rate This App button without login. When you send your app URL to merchants for reviews, they log in to their account and submit a review for your app. This feature is currently available only in the US. Learn more.

Screenshot of Ratings and Review UI of an app

Developer Dashboard

Add Functional Video and Functional App Description

The app approval process now requires you to provide a functional video that describes how merchants will use your app. You can upload a functional video and provide the functional workflow of your app for Clover to efficiently work with you through the approval of your apps. You can also edit the video and description for new apps on the Overview page. Learn more.

View New App Approvals in Overview Page

View the app approval details such as description and video directly from the Overview page for your new apps. View Legal, Privacy Policy, and Market Listing sections for apps in the Pending approval status. Learn more.

Add or Change App Types

Use the App Types section to choose if your app uses an existing point-of-sale and if it will be Public & Semi-integrated or Not Semi-integrated. You can also set an app as Private and later decide to change it to Public. You can change the App Type at any time. You can now also see the App Type in your App Cards on the Overview page. Learn more.

View App Installs Over 12 Months

You can now get review metrics for installs of your apps for a period greater than 12 months. Learn more.

Jan 2020

Leverage the Powerful Ecommerce API

Build seamless payment experiences in your apps and distribute them on the always-growing Clover App Market with our new Ecommerce features and SDKs. Learn more.

Developer Dashboard

Review Customer Permissions

Gain visibility into customer read-write permissions on your apps to be aware of customer data collected. Learn more.

Log Into Developer Accounts Without Test Merchant

You can now log in to an account that has no test merchant linked to it. Learn more.

Search Help Documentation from Dashboard

Search our help documentation repository directly from the Developer Dashboard. Click Help and then click in the search box. Enter your search term and see the results show up.

Updated about a month ago

What's new

Suggested Edits are limited on API Reference Pages

You can only suggest edits to Markdown body content, but not to the API spec.