We made the following API updates for March 2026.

Platform API

Order API

Added server-side limit for line items per order

To ensure system stability and optimal performance, we added a server-side limit on the number of line items allowed per order for third-party applications. You can now add up to 2,500 line items to a single order. Requests that exceed this limit return an error.

Affected endpoints:

• Create a new line item
• Create multiple line items
• Create an atomic order

Inventory API

Added support for subcategories

To help merchants organize their inventory more effectively, we updated the Inventory API to support subcategories. You can now group items at a more granular level within an existing parent category.

Affected endpoints:

• Create a subcategory
• Update subcategory information
• Delete a subcategory
• View subcategories in a category
• View items in a subcategory
• Create or delete associations between items and categories

Added server-side limit for bulk inventory updates

To align with the new line item limits and maintain optimal performance, we added a server-side limit for bulk inventory updates for third-party applications. You can now include a maximum of 2,500 items per request.

Affected endpoint: Update existing inventory items

Multiple service charge (MSC) Pilot APIs

Order API

Added server-side limit for line items per order

To ensure system stability and optimal performance, we added a server-side limit on the number of line items allowed per order for third-party applications. You can now add up to 2,500 line items to a single order. Requests that exceed this limit return an error.

Affected endpoints:

• Create a new line item
• Create multiple line items

Clover made the following API updates for August 2025.

Platform API

Inventory API

Added age-restriction-related flag for items and related attributes

To help merchants comply with legal requirements for selling age-restricted items—Alcohol, Tobacco, Over-the-counter (OTC) products, and Pharmacy products, such as vitamins and supplements—we have updated the Inventory API.

• isAgeRestricted (boolean): A flag to indicate that an item requires age verification at the time of sale.
• id (string): The unique identifier for the age restriction rule.
• name (string): The name of the restriction category.
• minimumAge (integer): The minimum age required for purchase.

Affected endpoints:

• Create an item
• Update an item
• Get an item
• Get all items

Orders API

Added age-restriction details to order and line item endpoints

To help merchants comply with legal requirements for selling age-restricted items—Alcohol, Tobacco, Over-the-counter (OTC) products, and Pharmacy products, such as vitamins and supplements—we have updated the Order API.

• isAgeRestricted (boolean): A flag to indicate if the line item is age-restricted.
• ageRestrictedType (string): The name of the restriction category for the item.
• minimumAge (integer): The minimum age required to purchase the item in the line item.

Affected endpoints:

• Get all line items for an order
• Create a new line item
• Get a line item
• Create multiple line items

Clover made the following API updates for April 2025.

Ecommerce

Corrected intent name and tutorial link

Updated the Create a charge and Pay for an order endpoints as follows:

• Corrected the intent name to save_credentials_on_file.
• Updated the Save a card for future transactions link in the stored_credentials object.

Clover made the following API updates for February 2025.

Platform API

Implemented Date Range Restriction for Payment Data Retrieval

Updated the GetPayments API to restrict data fetching to a 90-day date range when no DateTime filter is provided in the request.

Android Payments API

Added Tender Options and Bypass Tenders Example

Updated the Accept a payment documentation to include a new TenderOptions section and a new example for Bypass Tenders and go straight to card payment.

Clover made the following API updates for January 2025.

Platform API

Order API

Updated Order API discount amount parameter

Updated the amount parameter definition under the discount object to include that it accepts a negative value and 0 (zero).

Affected endpoints:

• Create online order
• Checkout online order
• Create atomic order
• Checkout atomic order

Clover made the following API updates for November 2024.

Ecommerce

Token API

Added Create an Apple Pay token endpoint to support wallet

Introduced Create an Apple Pay^® wallet token endpoint. This endpoint is:

• Unique, single-use code that represents an Apple Pay wallet.
• Securely processes payments without exposing the actual wallet details or directly handling sensitive information.

Use this token as the payment source in single-payment endpoints, such as create a charge or pay for an order.

Clover made the following API updates for October 2024.

Ecommerce API

Token API

Added a new attribute to the endpoint—Create Clover token from an external token

Added token_type attribute under the external_token object of the Create Clover token from an external token endpoint.

Introduced a new endpoint—Create an Apple Pay token

Introduced the Create an Apple Pay token endpoint to create an Apple Pay^® payment token for the digital wallet. Use this token with endpoints like create a charge or pay for an order.

Clover made the following API updates for September 2024.

Core payments

Added Android payment APIs

Added new APIs to Clover Android payments. These APIs offer an Intent-based solution to support third-party applications running on Clover devices. For details, see the following tutorials:

• Issue a manual refund
• Read a card
• Incremental authorization
• Request a tip
• Select a receipt
• Adjust a tip
• Closeout

Ecommerce

Updated Ecommerce APIs for TransArmor^® tokens

Updated Ecommerce APIs for TransArmor token to provide:

• Additional layer of security to protect cardholder data during transactions.
• Limited requirement of the regeneration of payment tokens.

To support the (TransArmor) TA token, Clover has:

• Introduced the Create Clover token from an external token endpoint.
• Added intent parameter to create a charge and pay for an order endpoints. Use this parameter to create a new TA token.

Fixed missing response body issue

Fixed an issue with the following endpoints to display the response bodies:

• Charges
  • Create a charge
  • Get charges
  • Get a charge
  • Capture a charge
• Customers
  • Create a card-on-file customer
  • Revoke a payment source
  • Update a customer
• Refunds
  • Create a refund
  • Get refunds list
  • Get a refund
• Orders
  • Get orders
  • Create an order
  • Get an order
  • Pay for an order
  • Return an order

Clover made the following API updates for July 2024.

Ecommerce

Gift card API

Updated the parameter name from card_number to number of the Create a gift card token endpoint.

Charge API

To comply with the RCL 31/32 upgrade, Clover added the following new fields under the installment_info object of the Create a charge endpoint.

• total_count
• total_amount
• sequence_number
• amount_type
• interval
• interval_count

Clover made the following API updates for June 2024.

Platform API

Order API

Removed the following body parameters from the update a line item endpoint. These parameters are no longer supported while updating a line item for an order.

• id
• item
• colorCode
• name
• alternateName
• price
• priceWithModifiers
• priceWithModifiersAndItemAndOrderDiscounts
• unitQty
• unitName
• exchangedLineItem
• createdTime
• orderClientCreatedTime
• discounts
• orderLevelDiscounts
• exchanged
• modifications
• tags
• refunded
• refund
• isRevenue
• taxRates
• payments
• revenueAmount
• quantitySold
• printGroup