Clover made the following API updates for August 2023.

Inventory APIs

Added offset and limit parameters to the following endpoints. This lets you search your line items results with a specific limit and offset:

• Get all tags
• Get all inventory without a revenue class
• Get all item groups
• Get all tax rates

offset Position of the first line item returned in the search results. Indicates the number of line items that are excluded from the search results.limit Maximum number of line items returned in the search result.

Order APIs

Added taxRate and items parameters to the Create or delete association between items and tax rates endpoint. taxRate indicates the name of the tax rate anditems indicates items associated with the tax rate. This update lets you assign a name to the tax rate and associate items with it.

Clover made the following API updates for July 2023.

Payments and Orders APIs

Clover is enforcing a 90-day window for API calls to the following endpoints.

• Get all payments for an order
• Get all payments
• Get all payments under an employee
• Get all authorizations

We discovered an issue caused by developer apps that aren't using a date/time filter when sending GET requests to Clover Payments and Orders endpoints. Some of these apps are causing high server loads and performance issues.

If your app expects orders or payments for a time frame greater than 90 days, you need to make additional API calls that include filter query parameters for the additional time frames.

As a best practice, use the createdTime filter query parameter value in your API calls to reduce payload sizes and server loads. Create the filter within the 90-day time frame.

Example:

filter=createdTime>=[unix-time]&filter=createdTime\<=[unix-time]

Contact developer relations if you have questions.

Token APIs

Introduced the Create an ACH token API. This API creates a single-use token that indicates Automated Clearing House (ACH) details. Use single-pay tokens for single payments, like create a charge or pay for an order endpoint.

Clover made the following API updates for June 2023.

Inventory APIs

Added offset and limit capabilities to the /v3/merchants/{mId}/items endpoint.

offset Position of the first line item returned in the search results. Indicates the number of line items that are excluded from the search results.limit Maximum number of line items returned in the search result.

See Get all inventory items.

Clover made the following API updates for May 2023.

Merchant APIs

Added reseller identifier (reseller_id) to the Get a single merchant endpoint response. This helps merchants identify reseller information.

Payment APIs

Removed the following search filter fields from the Get all payments for an order, Get all payments, and Get all payments under an employee endpoints.

• voidPaymentRef
• voidReasonDetails
• voidReason
• voidPaymentRef.id
• cardTransaction.last4
• cashTendered
• voidPaymentRef.createdTime
• cardTransaction.transactionNo
• voidPaymentRef.employeeId
• paymentRefundId
• paymentAttributes.type
• merchantId
• deletedTime
• tipAmount
• order.id
• paymentAttributes.value
• paymentAttributes.uuid
• voidReasonDetails
• cardTransaction.captured
• cardTransaction.currency
• taxAmount
• orderType.databaseId
• developerApp.package

Order APIs

Updated the Gets a list of orders endpoint. The search results for orders list is restricted to the last 90 days if the search filter fields include:

• deletedTime
• externalReferenceId
• createdTime
• total
• payType
• title
• note
• state
• manualTransaction
• cardTransaction.last4
• testMode
• touched

Clover made the following API updates for April 2023.

Updated the /v3/merchants/{mId}/orders/{orderId}/payments endpoint. This allows you to log external tenders for bookkeeping purposes.

See Create a payment record on an order.

Clover made the following API updates for March 2023.

For Clover merchants in the US, Canada, and Argentina, signature verification is no longer required as a cardholder verification method (CVM). The verify or reject signature screen is replaced with a signature screen that does not require merchant action. CVM in receipts now displays “Signature” instead of “Signature Verified.”

For more information, see our blog.

Clover made the following API updates for January 2023.

Added a new payment option to /v1/charges and /v1/orders/{orderId}/pay. This function allows merchants to accept a split-tender payment when the card presented by the customer doesn't have sufficient funds to complete a transaction.

Clover made the following API updates for November 2022.

Added a new payment method to /v1/tokens. The merchant collects check data over the phone and enters it into the system. The check-by-phone (CBP) data is sent to the Automatic Clearing House (ACH) and is similar to CBP. Merchants can gather information over the internet, also referred to as internet check acceptance (ICA), which processes it and electronically deposits the money into the merchant’s account.

See ACH TeleCheck for more details.

Clover made the following API updates for June 2022.

Clover Android Payments API is now available and supports the following operations: 

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

See Using Clover Android Payments API.

Clover made the following API updates for March 2022.

Added a new rule to v1/refunds for fraud prevention—transaction limits. With this enhancement, merchants can now set a maximum limit for a single refund using the Ecomm Fraud Prevention Transaction Limits rule. Transactions that are attempted above the configured threshold will fail.