# Service charge added via UpdateOrder is not visible on Square Terminal

**URL:** <https://developer.squareup.com/forums/t/service-charge-added-via-updateorder-is-not-visible-on-square-terminal/27886>\
**Category:** Questions\
**Tags:** orders-api\
**Created:** [September 18, 2026, 12:25pm UTC](https://developer.squareup.com/forums/t/service-charge-added-via-updateorder-is-not-visible-on-square-terminal/27886 "2026-09-18T12:25:58Z")\
**Posts on this page:** 2\
**Page:** 1

<div class="post-metadata">

**Author:** ![Krupali56](https://avatars.discourse-cdn.com/v4/letter/k/a9a28c/32.png) [@Krupali56](https://developer.squareup.com/forums/u/Krupali56)\
**Post date:** [September 18, 2026, 12:25pm UTC](https://developer.squareup.com/forums/t/service-charge-added-via-updateorder-is-not-visible-on-square-terminal/27886/1 "2026-09-18T12:25:58Z")

</div>

Hello Square Team,

We created an order through the Square POS app and then used the Orders API `UpdateOrder` endpoint to add a service charge.

The service charge is correctly added:

- It appears in Square Dashboard.
- It is included in the Terminal total.
- **Issue: It is not displayed as a separate line item on the Terminal.**

**Device details:**

```auto
Model: Square Terminal (1st Gen, v2)
Device ID: 542CS145C4005573
Terminal OS: 5.67.0105
Square for Restaurants: 7.24
Square POS: 7.22
Region: UK

```

Example:

Square Dashboard:

```auto
Subtotal: £10.00
TEST GiftTree Service Charge: £1.23
Total: £11.23

```

Square Terminal:

```auto
Subtotal: £10.00
Total: £11.23

```

The Terminal API documentation mentions that `show_itemized_cart` requires Terminal software version `6.62+` [here](https://developer.squareup.com/docs/terminal-api/take-payments-for-orders).

**However, we are not using the Terminal API or creating Terminal checkouts. We only update the existing POS order using the Orders API.**

Could you please clarify:

1. What does version `6.62` refer to—Terminal OS, Square POS, or Square for Restaurants?
2. Is our OS version `5.67.0105` below the required version?
3. Why does the device show `Up to date` if version` 6.62+` is required?
4. Is version `6.62+` available for the Square Terminal (1st Gen, v2) in the UK?
5. Is displaying a service charge added through` UpdateOrder` supported in the standard Square POS/Terminal flow?

Screenshots are attached for reference.

 ![Screenshot from 2026-09-18 17-05-30](https://global.discourse-cdn.com/square/original/2X/e/e23c32dba4222ae10defea18a0574c695a911abd.jpeg)  
 ![Screenshot from 2026-09-18 17-03-57](https://global.discourse-cdn.com/square/original/2X/0/0e5b96fc9ac30edaefe260c8805361bf8e7114c6.jpeg)  
 ![Screenshot from 2026-09-18 17-02-58](https://global.discourse-cdn.com/square/original/2X/e/efab461c020e067d5182663bf0058ca918afa8c5.png)

Hopping to get response soon.  
Thank you.

---

<div class="post-metadata">

**Author:** ![ashley-square](https://avatars.discourse-cdn.com/v4/letter/a/5f9b8f/32.png) [@ashley-square](https://developer.squareup.com/forums/u/ashley-square)\
**Post date:** [September 18, 2026, 2:38pm UTC](https://developer.squareup.com/forums/t/service-charge-added-via-updateorder-is-not-visible-on-square-terminal/27886/3 "2026-09-18T14:38:14Z")

</div>

`show_itemized_cart` doesn’t apply to your flow. It’s a `DeviceCheckoutOptions` property on the Terminal API, only read when you create a checkout via `CreateTerminalCheckout`, and only active when that checkout includes an `order_id` ([docs](https://developer.squareup.com/docs/terminal-api/take-payments-for-orders)). The POS app owns this order and is driving the checkout, so that flag is never read.

On the version numbers: the docs say “Square Terminal version 6.62 or later” without specifying app vs. device OS, which I agree is ambiguous. That said, 6.62 is in the Square app version range, not the Terminal OS range. Your device reports Application: Square for Restaurants 7.25so and OS version: 5.67.0105 as separate fields on different numbering schemes. Comparing 5.67 to 6.62 isn’t like-for-like, and your OS correctly shows “Up to date.”

On the itemization: your total is correct and Dashboard itemizes the charge correctly, so the order data is fine. What’s left is how the Square for Restaurants checkout screen renders a service charge added out-of-band. That’s app display behavior, not an Orders API issue, so it’s outside what the API docs cover.

Two things worth noting. The Terminal API docs do state that order updates aren’t supported once a checkout is `IN_PROGRESS` and may cause unexpected behavior; different flow from yours, but it suggests modifying an order mid-checkout isn’t a fully supported pattern in general.

If you want to confirm it’s specific to the API path, could you add the same service charge directly in the app and see whether it itemizes?