> For the complete documentation index, see [llms.txt](https://features.scnd.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://features.scnd.com/v2.0/superadmin/coupon.md).

# Coupon

{% hint style="info" %} <mark style="color:blue;">Path: SBO > Coupon</mark>
{% endhint %}

* [Definition](#id-1.16.x-vouchersmanagement-voucherbundle-definition)
* [Create a Coupon code](#id-1.16.x-vouchersmanagement-voucherbundle-createavouchercode)
* [Read a Coupon](#id-1.16.x-vouchersmanagement-voucherbundle-readavoucher)
* [Update a Coupon](#id-1.16.x-vouchersmanagement-voucherbundle-updateavoucher)
* [Delete a Coupon](#id-1.16.x-vouchersmanagement-voucherbundle-deleteavoucher)
* [Related resources](#id-1.16.x-vouchersmanagement-voucherbundle-relatedresources)

## Definition <a href="#id-1.16.x-vouchersmanagement-voucherbundle-definition" id="id-1.16.x-vouchersmanagement-voucherbundle-definition"></a>

Askers use coupons to apply discounts on booking requests. Coupons are managed exclusively by authorized platform super-administrators and administrators.

<mark style="color:orange;background-color:yellow;">WHO CAN USE THIS FEATURE?</mark>

Logged-in authorized administrators

## Create a coupon code <a href="#id-1.16.x-vouchersmanagement-voucherbundle-createavouchercode" id="id-1.16.x-vouchersmanagement-voucherbundle-createavouchercode"></a>

PAth: SBO > Coupons (figure 1)

<figure><img src="/files/hFp8IoCyROnFFOmam4HR" alt=""><figcaption><p>Figure 1</p></figcaption></figure>

Click “Add a coupon” (figure 2) to be redirected to the coupon creation page.

<figure><img src="/files/7vhBy4JTRPxdOur0rOEu" alt=""><figcaption><p>Figure 2</p></figcaption></figure>

Information to fill in (figure 3):

* **Code**: Code shared with users. All characters are authorized.
* **Offerors**: Indicated which offerors are eligible for the voucher.
  * A coupon can be linked to multiple offerors or all offerors.&#x20;
    * If it is linked to one or multiple offerors, the coupon is only usable on the linked offerors' listings
    * If it isn’t related to any offerors, the voucher is usable on all listings.&#x20;
* **Categories**: Indicate which categories are eligible for the coupon.
  * A coupon can be related to multiple categories or all categories
* **Discount types**:
  * “Amount”: fixed value deducted from the booking amount.
  * “Percentage” percentage deducted from the booking amount
  * Upgrades excluded
* **Discount**: discount amount.&#x20;

According to the selected discount type, the unit value will automatically be updated.&#x20;

* **Maximum use:** maximum number of times the discount code can be used.&#x20;
  * This value is not mandatory&#x20;
  * It is considered used if the related booking is
    * &#x20;“Pending”
    * “Paid”
    * “Accepted”
    * “Cancelled by asker” (only after offeror acceptance)
  * It is not considered used if the related booking is
    * &#x20;“Expired”
    * “Cancelled” (before offeror acceptance)
    * “Decline”
* **End date**: sets the voucher’s expiration date
  * This value is not mandatory
* **Minimum amount**: sets the minimum amount for a booking request to be eligible.&#x20;
  * This value is mandatory

{% hint style="info" %} <mark style="color:blue;">It is not possible to generate a discount coupon offering a 100% discount. The highest discount allowable through a coupon is 99%.</mark>
{% endhint %}

<figure><img src="/files/8G63ex0osSACxx2t6ROJ" alt=""><figcaption><p>Figure 3</p></figcaption></figure>

Click “Add coupon“ (figure 4) to save the created coupon.

<figure><img src="/files/OScKwNKG4kQK2hGj8kZp" alt=""><figcaption><p>Figure 4</p></figcaption></figure>

## Read a coupon <a href="#id-1.16.x-vouchersmanagement-voucherbundle-readavoucher" id="id-1.16.x-vouchersmanagement-voucherbundle-readavoucher"></a>

Once the coupon is created, coupon blocks display (figure 5):

* The code name
* The creation date
* The type of the discount
* The end date
* The status
* The number of uses allowed
* The value of the discount

<figure><img src="/files/6CkXeZ5dcYpiCyJNAbrM" alt=""><figcaption><p>Figure 5</p></figcaption></figure>

## Update a coupon <a href="#id-1.16.x-vouchersmanagement-voucherbundle-updateavoucher" id="id-1.16.x-vouchersmanagement-voucherbundle-updateavoucher"></a>

Update a coupon by clicking the folder icon that appears when hovering on the voucher block.

The update process is similar to the one when creating a coupon.

{% hint style="warning" %} <mark style="color:orange;">If the coupon code has already been used at least once on the platform, the Super administrator (or administrator) cannot modify:</mark>&#x20;

* <mark style="color:orange;">The Voucher code</mark>&#x20;
* <mark style="color:orange;">The discount type</mark>&#x20;
* <mark style="color:orange;">The discount amount</mark>&#x20;
  {% endhint %}

## Delete a coupon <a href="#id-1.16.x-vouchersmanagement-voucherbundle-deleteavoucher" id="id-1.16.x-vouchersmanagement-voucherbundle-deleteavoucher"></a>

Super-administrators cannot delete coupon but they can deactivate them through the related checkboxes (figure 6).

<figure><img src="/files/gXzlZyYfSb3DBDelapf7" alt=""><figcaption><p>Figure 6</p></figcaption></figure>

## Related resources <a href="#id-1.16.x-vouchersmanagement-voucherbundle-relatedresources" id="id-1.16.x-vouchersmanagement-voucherbundle-relatedresources"></a>

**Feature configuration:**

* [Coupon feature - Configuration](/v2.0/core-concepts/coupon-feature.md)

**Business rules:**

* [Coupon feature - Business rules](/v2.0/core-concepts/coupon-feature.md)


---

# 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://features.scnd.com/v2.0/superadmin/coupon.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.
