🚧

Welcome to the Multiple Service Charges pilot!

The new Multiple Service Charges (MSC) feature lets Clover merchants add multiple service charges to an order, such as a large dining-party automatic gratuity, a special menu upsell fee, and a banquet event fee. Previously, only a single service charge was supported.

• Starting in early Q2 2024, Clover will gradually deploy the Multiple Service Charge (MSC) feature across the merchant base—not all merchants will have the feature enabled at once. As we do this, you can access APIs that let you see the list of service charges your merchants have configured and apply them to orders.
• During the pilot, you are invited to test the feature with your app in the sandbox environment.
• After the launch is complete, you will be required to use the new service charge endpoints to use ANY service charge features. The new endpoints treat service charges as line items when applied to an order.

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. You can find these topic links at the top of all the pilot documentation pages.

Multiple service charges functionality

The multiple service charges feature lets merchants add up to three multiple percentage-based service charges, such as delivery fees or large group fees to orders.

• Only merchants can create, update, or delete service charges.
• The initial release of multiple service charges does not support fee-based service charges or taxable order fees.
• The Clover code base identifies multiple service charges as ‘OrderFees’.

Using service charges in your apps

As a Clover developer, your apps can:

• Add service charges associated with a merchant to an order.
• Remove service charges from an order.
• Get all service charges associated with a merchant.
• Get a list of service charges associated with an order.

Your Clover apps cannot:

• Create service charges for a merchant.
• Update or delete service charges associated with a merchant.

Android SDK and data model changes

The Clover data model handles multiple service charges as order-level line items. Third-party apps must filter out multiple service charge line items from regular, non-service charge line items. If multiple service charges are not filtered out, they appear with regular line items in the order details.

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

Terminology

It helps to understand the terminology when working with multiple service charges.