> For the complete documentation index, see [llms.txt](https://docs.klai.studio/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.klai.studio/engineering-reference-docs/software-testing-overview/ux-ui-checklist/flows/entering-a-promo-code.md).

# Entering a promo code 🏷️

A reward for a user to earn a discount on their purchase, promo codes are a pre-requisite in any e-commerce website.

‍To avoid a confused customer, make sure they understand what is happening with their code - whether it works, expired or isn't applicable.

* [ ] Make promo code input field visible

  The cart or checkout are pages expected to have a promo code field. It should be in a place that can be seen when scanning towards the button to continue.
* [ ] Promo code applied successfully

  The change can be reflected using your success state colors (likely green) to indicate the code was applied.

  In the example is two different options, divided by how much information you want to show. For both, hiding the input field altogether makes it clear only one code can be entered.
* [ ] Reflect promo code effects

  This can be shown with the promo code entry as a total amount, or be represented on In item-to-item basis.

  It's important to also show or at least repeat the discount near the total at checkout.
* [ ] Promo code error

  The promo code may not be applicable, or entered incorrectly.
* [ ] Remove promo code

  In some cases, a user might not like the discount offered and prefer the original sale price of an item. Or, they found a better promo code to use.


---

# 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:

```
GET https://docs.klai.studio/engineering-reference-docs/software-testing-overview/ux-ui-checklist/flows/entering-a-promo-code.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.