➤ (MSC Pilot) Frequently asked questions (FAQ)
Frequently asked questions (FAQ) about multiple service charges (MSC) functionality.
Why do multiple service charges appear with regular line items?
In Clover, line items are treated as inventory items to be added to an order. Inventory items are available in the merchant’s menu to create orders. 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 Register or Dining, the service charge may appear with the regular line items in the order on a third-party app that has not changed.
If your app does not filter out service charges from the regular line items:
- 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 appear below the subtotal.
The Android SDK contains code snippets that help you to filter out service charges from regular line items in an order.
What happens if my app does not use multiple service charge (MSC) endpoints?
Here is what you can expect your merchants to experience during the migration period if you do or do not upgrade your app. The experience varies depending on whether the merchant has MSC enabled or not. However, MSC will eventually be enabled by default, so all merchants can use it.
Migration matrix
| Merchants with MSC enabled | Merchants without MSC enabled | |
|---|---|---|
| App uses MSC endpoints | ✅ Order totals and payment amounts will continue to be correct. ✅ Service charges will not be displayed as line items in the order. Instead, the service charges will be 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 will result in this error: com.clover.sdk.v1.ClientException: status code: 400 Order Fee feature is not enabled Temporary workaround: Your app must rely on the legacy endpoints to get the single service charge associated with the merchant. |
| App does NOT use MSC endpoints | ✅ Order totals and payment amounts will continue to be correct. ❌ Service charges may appear as regular line items in the order. ❌ Service charges may be added to the subtotal instead of appearing below the subtotal. Example: Let's say 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 appear along with regular line items in your app, and the cost may be included in the subtotal instead of being listed separately after the subtotal. This can cause reporting issues for merchants. | No impact |
Pilot documentation
MSC documentation is not public during the pilot, so the topics will not appear in searches or in the left-navigation panel. To help you navigate the MSC documentation during the pilot, we added some top-navigation quick links. Look for the topic links at the top of all the pilot documentation pages.
Updated 8 days ago