➤ (MSC Pilot) Frequently asked questions (FAQ)

Frequently asked questions (FAQ) about multiple service charges (MSC) feature.

United States
Canada

Why do multiple service charges display with regular line items?

In Clover, line items are treated as inventory items that are added from the merchant's menu to an order. The Clover data model handles multiple service charges as order-level line items.

If a merchant opens an order with a service charge added from another Clover app, such as the Register or Dining app, third-party apps that are not updated to handle multiple service charges (MSC) may display these service charges along with the regular line items in the order.

If your app does not filter out service charges from regular line items, note the following:

  • Order totals and payment amounts will be correct.
  • Service charges are displayed on line items in any interface that returns items such as order summary views, cart views, and so on.
  • Service charges are displayed separately after the subtotal.

The Android SDK contains code snippets that help you filter out service charges from regular line items in an order.

What happens if my app does not use multiple service charge (MSC) endpoints?

The merchant's experience varies depending on whether the multiple services charges feature is activated for the merchant or not. In the initial release, the multiple service charges (MSC) feature is available to a limited set of merchants. Eventually, MSC will be activated by default so all Clover merchants can use it.

Migration matrix

Merchants with MSC feature activatedMerchants without MSC feature
App uses MSC endpoints✅ Order totals and payment amounts continue to be correct.

✅ Service charges do not display as line items in the order. Instead, the service charges are displayed in the subtotal section of any interface that lists items, such as on the order summary or in the cart.
❌ Accessing the MSC endpoints results in this error:
com.clover.sdk.v1.ClientException: status code: 400 Order Fee feature is not enabled

Temporary workaround: Your app must use the legacy endpoints to get the single service charge associated with the merchant.
App does not use MSC endpoints✅ Order totals and payment amounts continue to be correct.

❌ Service charges may display as regular line items in the order.

❌ Service charges may be added to the subtotal instead of displaying separately below the subtotal.

Example: An open order contains a service charge added from another Clover app, such as Register or Dining. If the merchant edits this order, the service charge may display along with regular line items in your app, and the cost may be included in the subtotal instead of being listed separately below the subtotal. This can cause reporting issues for the merchant.
No impact.

🚧

Pilot documentation

MSC developer documentation is not public during the pilot, so the topics do not appear in search results or in the left-navigation panel of this developer documentation portal. To navigate the MSC documentation during the pilot, use the quick links in the top-navigation menu on relevant MSC topics.