Order Service Charges

Applies to: Orders API

Learn how to apply service charges to an order using the Orders API.

Link to section

Overview

Building on the example order created in Order Price Adjustments, learn how the calculation phases you set on an order affect service charges applied to an order.

Square calculates and applies any discounts on the order before service charges are applied. After discounted prices are applied to the order, service charges are applied. Service charges are scoped as follows:

  • Based on the total amount of the order - If the service charge will be taxed, it's applied before taxes are calculated.
  • Apportioned based on the individual items in the order - The apportioned charge is based on a percentage or a fixed amount.
Link to section

Calculation phases

The time that the service charge calculation happens is a calculation phase. The Orders API supports any of four calculation phases for a service charge:

  • Subtotal phase - The service charge is calculated before taxes.
  • Total phase - The service charge is calculated after taxes.
  • Apportioned amount phase - The service charge is calculated after any percentage-based apportioned service charges and before taxes.
  • Apportioned percentage phase - The service charge is calculated before any amount-based apportioned service charges and taxes.
Link to section

Phase limitations