What's new

🚧

IMPORTANT

Beginning in February 2022, Clover will no longer allow apps to send auth tokens in URLs. Instead, API tokens will need to be included in the Authorization header.

For more information, see Using API tokens.

September 2021

New colorCode property for items and categories

When creating or updating an inventory item or category, you can set a color to represent the item or category and make it easier for merchants to visually group items. This color code appears in the Register and Dining apps, as well as the Inventory page of the merchant web dashboard.

August 2021

PayPal/Venmo tender type is available

Clover US merchants can now accept PayPal and Venmo as a tender type for goods purchased in physical locations. To initiate the payment process, the merchant's POS will present a QR code which will be read by the customer's mobile PayPal/Venmo app.

To determine if a payment was processed using PayPay or Venmo, examine the payment response's tender.label field.

{
  "id": "SRQAKJNGEEXMM",
  "result": "SUCCESS",
  "order": {
    "id": "2ZWJDG42TG25Y"
  },
  "amount": 10503,
  "cashTendered": null,
  "taxAmount": 0,
  "tipAmount": 0,
  "cashbackAmount": null,
  "employee": {
    "id": "GT1SSENJXTVPY"
  },
  ...
  },
  "tender": {
    "id": "6PXWX9XNM255J",
    "editable": false,
    "enabled": true,
    "instructions": null,
    "label": "PayPal",
    "labelKey": "com.clover.paypal",
    "opensCashDrawer": false,
    "visible": true
  },
  ...
}
{
  "id": "07BZ25C9R6H5P",
  "result": "SUCCESS",
  "order": {
    "id": "CCV0B554FSMDW"
  },
  "amount": 4082,
  "cashTendered": null,
  "taxAmount": 103,
  "tipAmount": 0,
  "cashbackAmount": null,
  "employee": {
    "id": "GT1SSENJXTVPY"
  },
  ...
  },
  "tender": {
    "id": "8TZDTYDT4EAFT",
    "editable": false,
    "enabled": true,
    "instructions": null,
    "label": "Venmo",
    "labelKey": "com.clover.venmo",
    "opensCashDrawer": false,
    "visible": true
  },
  ...
}

See the new tender reference page for a list of tender types provided by Clover.

Order Printing API

We introduced a new API that allows you to send print jobs directly to a merchant's order printer.

The POST /v3/merchants/{mId}/print_event endpoint takes an order UUID and prints the order receipt using the merchant's selected receipt options.

See Printing orders with the REST API for more information.

July 2021

Ecommerce

Hosted Checkout

We've published a new codelab for the Hosted Checkout API. This interactive tutorial shows you how to set up a basic checkout integration for a merchant's website.

Developer Dashboard

Viewing billing transactions

You can now view billing transactions by either charges, refunds, or both together by selecting the relevant tab.


May 2021

APK upload limit increased to 120 MB

In response to developer feedback, Clover has increased the APK upload limit from 50 MB to 120 MB. Learn more.

Ecommerce

Additional tax support for /v1/charges

In your Ecommerce API POST /v1/charges request, you can now use the new tax_rate_uuid parameter for adding a tax rate UUID in your request. While tax_rate_uuid is the recommended parameter to use, you can also use tax_rates or tax_amount to add taxes to your charges. Learn more.


April 2021

Ecommerce API

Confirming customer information with fraud tools

When you create a card token or charge a customer's card, Clover now checks some of the submitted data against the issuer's cardholder information to verify the card is being used legitimately. These checks include the CVC/CVV, billing address first line, and postal code.

Learn more.

Setting soft descriptors

With soft descriptors, merchants provide customers with information about the business that processed a charge with the Ecommerce API. These descriptors appear on the customer's card statements and can include the business name, address, and contact information.

Learn more.

Subsequent payments with saved customer cards

When you save a card on file using /v1/customers, Clover sets the card source token as a multi-pay token for the customer. To make a payment and then subsequent payments with a saved customer card, you can use either the customer id or the multi-pay card token as the source value in your payment request.

Learn more.


February 2021

Ecommerce API

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?created.gt={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 regionsAdd metered tiers in new regions

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.Screenshot of UI showing the list containing flexible free trial options.

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.Screenshot of pop-up window that appears when you log into your developer account.

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 APIScreenshot of UI which shows the options for various ECommerce integrations - Hosted iFrame vs the API

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 appScreenshot of Ratings and Review UI of an app

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.


Did this page help you?