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