> For the complete documentation index, see [llms.txt](https://docs.podplay.app/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.podplay.app/payments/customer-payments/apply-a-manual-discount-when-charging-a-customer.md).

# Apply a Discount

### Overview

Staff can now apply discounts directly in the Charge Customer window — for example to comp an item after a service issue, honor a price match, or apply a manager-approved courtesy discount. You can discount a single item in the cart or apply one discount to the whole order. Every discount requires a short reason, which is saved with the order for reporting.

Key points about this feature:

* You can discount **one item** or the **whole order** (percent off, or a fixed amount off) — but not both on the same order
* A **Reason** is always required and is stored with the order — it is visible to staff on the order details, but Customers never see it
* A manual discount **replaces** any automatic discount (such as a member discount) on that item — the two do not stack
* Discounts can never bring an item below free ($0)

### Discount a Single Item

* Open the Charge Customer window (for example, from the cart on the Shop page)
* Find the item in the cart and click the **Apply discount** link below its name
* Choose **Percentage** or **Amount** from the dropdown, then enter the value
* Enter a **Reason** (required)
* Click **Apply**

\[SCREENSHOT NEEDED: Charge Customer cart with the discount popover open below an item's name, showing the % and $ fields and the Reason field]

The discount appears as gray text below the item's name, including the reason (for example, **20% discount (price match)** or **$5 discount (service issue)**). To remove the discount, click the **x** next to it.

\[SCREENSHOT NEEDED: Cart line showing the gray discount text with reason below the item name, with the remove x visible]

**PLEASE NOTE:** If the item quantity is more than one, the discount applies to **every unit** of that item.

### Discount the Whole Order

* Open the Charge Customer window and add the items to the cart
* Below the **Subtotal** row, click the **Apply discount** link
* Choose **Percentage** or **Amount** from the dropdown, then enter the value
* Enter a **Reason** (required)
* Click **Apply**

\[SCREENSHOT NEEDED: Apply Discount modal with the Discount percentage field and Reason text area filled in]

The order summary now shows a **Discounts** row with the percentage and reason, and the total updates automatically. To remove it, click the **x** next to the Discounts row.

\[SCREENSHOT NEEDED: Charge Customer order summary showing the Discounts row with percentage, reason, and updated total]

### Tips

* An order can have item discounts or one order-wide discount, never both. If a discount already exists at the other level, the popover asks you to clear it first — see [Updated Manual Discount Controls](https://github.com/pingpod/pingpod-web-v2/tree/main/applications/web-admin/payments/updated-manual-discount-controls.md)
* Some older product types cannot be discounted; the **Apply discount** link will not appear below those items
* Discounted orders keep a record of who applied the discount and why, so always write a reason a manager would understand later

### Related Updates

* [Updated Manual Discount Controls](https://github.com/pingpod/pingpod-web-v2/tree/main/applications/web-admin/payments/updated-manual-discount-controls.md)

**PLEASE NOTE:** This feature must be enabled for your facility and requires permission to charge Customers on their behalf. If you don't see the discount options, please contact your PodPlay CSM.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.podplay.app/payments/customer-payments/apply-a-manual-discount-when-charging-a-customer.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
