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 2022

Payments

Updated Payments screen on Clover 3rd Generation devices

We have introduced a new look and feel on the Payments screen of 3rd generation Clover devices. The Payments background screen is now white with small yet impactful tweaks in the displayed graphics. The payment functionality remains unchanged. These graphics enhancements will be made available on Clover 2nd generation devices, in the future.

August 2022

Payments

Auto-generated receipts for Canadian integrators

For Canadian integrators, we increased the (debit) contactless receipt required limit, above which receipts must be auto-generated, to CAD 1001.00.

Integrators now have more flexibility regarding auto receipt printing since receipts aren’t required for transactions under the limit.

Surcharging now allowed for Colorado ZIP codes

Previously, Colorado ZIP codes were excluded from US credit surcharging under Colorado law. As of July 1, 2022, eligible Colorado merchants who are approved and onboarded for US credit surcharging can now benefit from surcharging on credit transactions.

Clover device news

Clover Mini 3

The Clover Mini 3 is now available in US.
More information

Clover Station Solo in Canada

The Clover Station Solo is now available in Canada.
More information

July 2022

Private app distribution

You can distribute an approved private app by sharing a direct link to the app with the merchant. Private apps are available in any region supported by the Clover App Market.
More information

June 2022

Clover Android Payments API is now available

We released the Clover Android Payments API.

The following operations are supported:

  • Processing final and tip-adjustable payments
  • Processing pre-authorization payments
  • Capturing pre-authorized payments
  • Processing a payment reversal

More information

May 2022

App Market

Developers can now release approved private apps using a direct link

Developers can release approved private apps as "unlisted" in the App Market, and make them discoverable only with a direct link. This enables developers to self-manage their private app distribution. Learn more.

April 2022

Ecommerce

New rule added to Fraud Prevention - Transaction Limits

Merchants can now set a maximum limit allowed for a single refund using the Ecomm Fraud Prevention Transaction Limits rule. Transactions that are attempted above the configured threshold will fail. This applies to the Ecomm v1/refunds endpoint only.

858858

March 2022

Payments

Payment links

Payment links can be created from the web dashboard. The links open Clover’s Hosted Checkout to complete a payment with a credit card. The consumer can complete a payment and receive a transaction receipt.

Supported payment links are:

  • Pay Button (preset)
  • Pay Button (variable – donation button)
  • Payment Link
  • Payment QR code

Ecommerce

Hosted Checkout Re-Captcha support

Re-captcha support on Hosted Checkout payment experiences. The default is enabled for new merchants. Merchants can disable/enable the feature in Hosted Checkout Configuration.

Invoices - Additional payment fields

Addition of Tip and Convenience Fee (US) in Invoices. Fee breakdown will be included in payment experience as well as receipts.

Recurring Payments and Invoices

  • Date filter redesign to help merchants find subscriptions and invoices
  • Date filter two-year range support
  • Subscription cancellation notification to consumer
  • Addition of French language to notifications for Canadian merchants (CA)

Hosted iframe French language support

Addition of French translations to better support Hosted iframe in Canadian market

February 2022

Ecommerce

Partial refunds of transactions with surcharges

A partial refund of a transaction that has a surcharge but doesn't have tip amount, line items, or tax can now be performed from the /v1/refundsendpoint.

Ecommerce settings added to Account & Setup tab

The new Ecommerce tile under Account & Setup allows you to create new API tokens and enable fraud prevention tools.

877877

January 2022

Ecommerce

Recurring Payments and Subscriptions APIs have released

The Recurring Payments and Subscriptions APIs allow Clover merchants and developers to set up plans for recurring charges on a periodical basis, such as monthly or weekly. Customers can be charged on a finite basis (for example, a payoff installment for six months) or infinite (for example, a streaming subscription). The subscription service will process each invoice at the configured date. See Recurring Payments and Subscriptions APIs for more information.

Ecommerce API tokens have moved

Ecommerce API Tokens have been moved from Business Operations to Ecommerce on the Merchant dashboard > Setup tab.

884884

Inventory

Bulk delete tags

In the Inventory app, you can now bulk delete a maximum of 500 tags. Send a DELETE request with a query string with the parameter tagIds and a comma-separated list of one or more tagId values (/v3/merchants/{mId}/tags?tagIds={tagId1},{tagId2},{tagId3}).

Webhooks added for inventory modifier, inventory modifier group, and inventory category changes

We have added webhook messages for changes to inventory modifiers, inventory modifier groups, and inventory categories. Inventory read permission is required for these webhooks. See Using webhooks for more information.

November 2021

Bulk categories reordering endpoint

We introduced a new endpoint that allows you to bulk reorder categories.

Send a POST request to the/v3/merchants/{mId}/categories/bulk_sort_orders endpoint.

{
    "categorySortOrders": [{
        "id": "1AMQ356VYXPF8",
        "sortOrder": 2
    },
    {
    "id": "WA9VQQKCPYG5J",
        "sortOrder": 3    
    }]
}

October 2021

REST Pay Display (Beta) new device reset endpoint

We added a new endpoint, /v1/device/reset, which resets the device to an initial state and cancels any in-flight commands from the POS.
To cancel one or more in-flight commands without resetting the device, use the /v1/device/cancel endpoint.

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.

845845

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.

11721172

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.

11711171

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.

600600

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.

400400

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.

15521552

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.

500500

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.

10001000

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.

15761576

Did this page help you?