What's new
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.
Current payment response | cvmResult="Signature Verified" | Customer signs and merchant verifies the signature. |
New payment response | cvmResult="Signature" | Customer signs and merchant is not required to verify the signature. |
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
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/refunds
endpoint.
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
colorCode
property for items and categoriesWhen 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
/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 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 7 days ago