Multiple service charges feature—now available in sandbox

Clover merchants can now set up multiple service charges per order. The new functionality provides an easy way for Clover merchants to add multiple types of order fees to an order, such as:

Large dining-party automatic gratuity
Special menu upsell fee
Banquet event fee

As Clover third-party developers, you can view the service charges your merchants have configured and apply them to orders. The new multiple service charge endpoints treat service charges as line items that you place after the subtotal on the order receipt. Service charges are not taxed but are calculated after discounts. This means a percentage-based service charge calculation = (item price + modifier price - line item discounts) * (service charge %).

For example:

Multiple service charges item on an order receipt

For information about using this feature, see Multiple Service Charges

Recommendation for developers

In Q1, 2024, we announced the plan to launch the multiple service charge feature. Since then, we have reached out to affected developers and merchants to guide the transition. With the feature going live, here is what you need to know:

New implementations must exclusively use the multiple service charge endpoints for any service charge features.
Legacy endpoint for service charges is deprecated until further notice. This means:
- Your existing implementations will continue to work until the legacy endpoint is end-of-life (EOL). The EOL date is not yet determined.
- Clover will reject any new apps submitted using the legacy service charge endpoint. As a developer, you must update the app to support multiple service charges. For information about using this new functionality, see Overview of multiple service charges.
- Clover is no longer supporting legacy endpoints; there will be no bug fixes or enhancements.
Exception: This feature is not available in California due to the SB 478 law that prohibits businesses from adding automatic service charges onto customer bills. This applies to legacy and new service charge features.