May 2023

Billing Developer Dashboard - North America Region

Added feature for bank account update

You can now add and update bank account details directly from the Developer Dashboard. Account owners and other authorized users need to complete the two-factor authentication (2FA) process to access the Account Info—Bank Details section under Developer Settings.
Once the 2FA process is complete, you can add or update the linked bank account details.

You no longer need to send an email to the Developer Relations team for bank account updates.
See Add or update bank account information for more details.

April 2023

Billing Developer Dashboard - North America Region

Developer billing—Support for refunds

• You can now issue a refund for transactions that are not disbursed or canceled, are billed in the current month, and to which no other refunds have been applied.

• Similarly, you can also cancel refunds for transactions that are in Refund status.

Developer documentation portal

Added Region icons to topics

Clover is expanding into International markets and regions across North America, Europe, and Latin America. We are adding region icons in the topic pages on our Developer Docs portal (docs.clover.com) for an easy visual reference. Use the green Regions icon at the top of each topic page to identify if a topic is relevant for your region.
For more information, see Region-specific features and limitations.

Payment flow improvement

Removed signature as required cardholder verification method

For Clover merchants in the US, Canada, and Argentina, signature verification is no longer required as a cardholder verification method (CVM). Clover merchants can still take payments with a cardholder’s signature; however, verify or reject signature is not required to complete the payment flow. In the improved payment flow:

• Verify or reject signature screen is replaced with a signature screen that does not require merchant action.
• CVM in receipts displays Signature instead of Signature Verified.

Recommendation for developers

If your app depends on signature verification, you should change your app’s code to remove or change the dependency.

For more information, see our blog.

Added a new tender

Added webhook messages for changes to inventory modifiers, inventory modifier groups, and inventory categories. Inventory read permission is required for these webhooks.

For more information, see Use webhooks.

Added reCAPTCHA to hosted checkout flow

Our hosted checkout flow now includes reCAPTCHA to better combat fraud on card-not-present transactions. You do not need to make any changes in the implementation to make this feature available to the merchants.
However, if you are using iFrame or REST API for ecommerce integrations, implement your own form of CAPTCHA to help combat fraud attempts.

Recommendation for developers

Advise your merchants to turn this feature on in the Merchant Dashboard under Account & Setup → Ecommerce → Hosted Checkout → ReCAPTCHA.

March 2023

Billing Developer Dashboard - North America Region

Enhanced search features

• Search by Merchant Name, Merchant ID and Charge ID. We have introduced an incremental search functionality that starts populating the most relevant results as soon as you enter the fourth character in the search field. This includes special characters and spaces.
  Example: If you are searching for the merchant name - Web QA Developer - as soon as you enter Web , a list of names starting with Web QA display in the search results.

• Use the Add filter button allows you to filter search results by Apps, Charge Type and Status. You can also select options in the Apps, Charge Type and/or Status drop-down menus. You can reset the filter anytime.

Updated Billing homepage and billing transaction reports

• Use the Export button to download transaction reports for the past 3 months with just a click. Last 30 Days is the default date range, which you can update the calendar icon.

• Use the drop-down menu to update the default currency from USD to GBG, EUR, or CAD.

• View Billed, Collected, Refunded and Canceled transactions for the selected date range in the transactions list

Updated billing status display

On the Billing - Transactions page, the Status column in the search results now displays only 7 revised billing status. This provides clarity to the Status column view.

See Billing status for more details.

Added slide-out panel on the Billing - Transactions page

You can click the transaction to view the details of each transaction in a slide-out panel on the Billing - Transactions page. Example: When you click a transaction with On Hold status, the reason for hold is displayed in a slide-out panel.
The slide-out panel displays a deeper insight into your transaction details including transaction status details, charge summary, and charge history.

Added Void of Refund (VoR) to Refund API - North America Region

Added backwards compatibility to the Refund API for Void of Refund (VoR) for Payments Plus merchants on the Transactions app. When a merchant mistakenly issues a refund, VoR allows merchants to void erroneous refunds for up to 25 minutes after the transaction time. Once a refund can no longer be voided, the VOID link does not display.This feature provides transparency into voids versus refunds, including potential merchant payment processing costs since voids generally are at no cost.

February 2023

Billing

Initiated review process for app subscription tiers

The Clover team needs to review your plan modification requests if you are switching to a lower priced tiers subscription model. This review process to approve or reject the new subscription tier ensures compliance with the Clover App Market pricing policies and also prevents billing outside Clover.

Ecommerce

Added split tender capability to the Ecommerce Order API

Split tender enables you to add Amount and Currency Code fields in the Ecommerce Order API to define a specified amount towards a payment. This offers flexibility to the merchants and customers in the United States (US) and Canada region to pay for an order with multiple payment methods. The Order API response displays the Partial Approval indicator and Approved Amount.

January 2023

Integrated payments

Cardholder name and card brand added to the tokenization response

Now you can access the customer and card data details by using insert/tap on the device. This can be used for managing card(s)-on-file.

Closeout for Android Payments API

Now you can manage Closeout within your app on Clover devices, without requiring merchants to use Clover’s closeout app.

November 2022

Payments

To support Payeezy migration, ACH Telecheck is available to the US Clover merchants on software-as-a-service (SaaS) plans and offers:

Check acceptance by phone

Merchants gather payment and order information over the phone — also referred to as check by phone (CBP) — to process checks. Merchants also need to obtain customer consent over the phone to process funds.

Check acceptance through the internet

Similar to CBP, merchants gather information over the internet — also referred to as internet check acceptance (ICA) — to process checks. The customer provides order and payment details and their consent using disclaimer agreements.

October 2022

App Market redesign

The App Market now has an improved layout, sorting and filtering options and new top navigation to present apps in ways that are more likely to encourage merchant engagement.

Enhanced Clover App Market home page

The Clover App Market homepage has a new look and feel, improved search functionality, better navigation and has been redesigned to enable merchants to easily find apps relevant to their needs.
The App Market home page displays:

• A main carousel with a banner and images of up to 10 apps for a prominent display.
• Secondary carousel with app tiles that display in the categories, such as Must-have Apps, New & Notable, Recently Launched, and custom collections. You can now see the app collections grouped under Recently Launched, Must-have Apps, Apps from Clover, and custom collections.
• Feature tiles, such as apps to sell online
• Improved search functionality with sorting options—your merchants can now use the search box to search by app name, developer name, and keywords. Search for apps and sort the search results by: Most relevant (default), Top rated, Most popular, and Newest. You can sort app collections by Most relevant (default), which indicates the order in which the apps are placed in a collection by a reseller or Clover representative. Other sort by options are Top rated, Most popular and Newest.

Revised app categories

The App Market redesign features reorganized categories and a refined list. Regrouped apps appear under simpler categories to target the most relevant merchant businesses and ensure smoother approval with the Clover App Market team. You can review the app categories, and if needed update yours on the Developer Dashboard to align with your target users. See the Setting App Market listings to update categories for your apps.

My Apps

Displays third-party and Clover apps that a merchant has installed. The app information includes the developer’s name and merchant subscription. Merchants can rate an app, change the subscription, or uninstall an app.

Expanded region-based availability of ratings and reviews

The ratings and reviews system is now also available for the European (EU), Canada (CA) and Latin America (LA) Clover App Market. The app rating and review feature that merchants can use in the Clover App Market creates a feedback loop between Clover merchants and developers. Read more about app ratings and reviews:

• Ratings and Reviews is Live on Clover App Market - EU
• Ratings and reviews is live on Clover App Market - Canada (CA) and Latin America (LATAM).

Integrated 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, such as Flex 3 and Mini 3. 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.

Semi-integration

REST Pay Display

Our latest semi-integrated payment solution released three new endpoints:

• Order display allows developers to display a customer’s order on the device, and update it as items are added to the cart. See more.
• Custom activities allows developers to display a custom graphic on the device, such as a merchant’s in-store promo. This feature will continue to evolve so that you can create even more interactive flows with on-device forms and two-way messaging between your point-of-sale app and our Clover devices. See more.
• Get merchant devices allows developers to retrieve a list of all activated devices that are associated with a merchant. This endpoint helps users pair to the appropriate devices in their facility, especially if there are multiple devices.

2022 Clover Code Freeze

Our annual code freeze is scheduled from Nov 17, 2022 - Jan 3, 2023. During this festive period, no new code is deployed on our platform to protect merchants from disruptions in their processes during a busy and stressful period. This freeze also extends to third-party apps built with our APIs and SDKs.
See 2022 Clover code freeze for more details.

Developer documentation

We have added new information and reorganized a few topics in our developer documentation on docs.clover.com.

Introduction

Updated the Get started page:

• Moved Clover platform illustration and text from the prior Get started topic to Clover architecture.
• Removed Create an API token topic. SeeGenerate a test API token for related information.
• Moved Make a REST API call topic under Build with REST API section to Clover REST API basics.

Launching apps

• Updated the Launch overview topic to include new checklists.
• Added Navigating the Clover App Market topic.
• Moved Manage Your APKs topics under the Platform Overview section.

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.

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.

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.

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.

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.

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.

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.

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.

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.

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.