> For the complete documentation index, see [llms.txt](https://docs.perkville.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.perkville.com/integrations/integration-reference/mariana-tek/discount-coupon-rewards.md).

# Discount coupon rewards

Using Mariana Tek's API, Perkville is able to produce a batch of coupon codes for discount on purchases. These single-use coupon codes can be uploaded to Perkville and automatically distributed upon redemption of a Perkville reward. The coupon code shows up on the voucher sent to the customer.

{% hint style="warning" %}
Coupons can only be used for discounts off an entire purchase or product types in a purchase. They cannot be used to issue a free product. For example, if the coupon gives 100% off a hoodie, it'll give 100% off all hoodies on the purchase, not just one.
{% endhint %}

{% embed url="<https://docs.perkville.com/features/settings/redeeming-options#single-use-coupon-batches>" %}

The Perkville team needs the following information to develop a batch of coupon codes:

* **Discount Name**
* **Should all Mariana Tek users be allowed to use this coupon?** If you want to restrict this coupon to only some users (employees only, students only, etc.) then this is no.
* **Whether the discount is a percentage discount or a flat discount**
* **The percentage amount or flat discount amount**
* **Flat discount currency**
* **Whether the discount is for all products, only specific product classes, or only specific products**
* **The products or product class IDs the discount should be for** (if applicable)
* **Excluded products** (if applicable)

## FAQ

### Can discounts be restricted to products or locations?

Single-use percentage or fixed-dollar coupons can be restricted to products, including memberships, and can be location-specific. Give your CSR the intended product and location restrictions when requesting a batch.

### Can a coupon give away exactly one item?

Batch-created coupons cannot limit the discount to one item. A 100% hoodie discount can apply to all qualifying hoodies in the purchase. For a full free service, consider a [service credit](https://docs.perkville.com/integrations/integration-reference/mariana-tek/automated-reward-redemptions.md) instead.


---

# 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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.perkville.com/integrations/integration-reference/mariana-tek/discount-coupon-rewards.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
