> 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

Defining and managing the use of Coupons

{% 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="https://2306631548-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fn4EIoqjZx1xWQIo6LnjB%2Fuploads%2FMvhlbyEyEbcuca3UIK6H%2Fimage.png?alt=media&amp;token=50890098-afb2-4190-b170-f0df21810ccc" 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="https://2306631548-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fn4EIoqjZx1xWQIo6LnjB%2Fuploads%2Fo7IHFFR8qnY2q2Xx1kTi%2Fimage.png?alt=media&amp;token=9134e176-ce14-4316-91c8-56bcb9d0abc3" 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="https://content.gitbook.com/content/n4EIoqjZx1xWQIo6LnjB/blobs/PzavLRi4L8Htclse9x6R/6988694809.png" alt=""><figcaption><p>Figure 3</p></figcaption></figure>

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

<figure><img src="https://2306631548-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fn4EIoqjZx1xWQIo6LnjB%2Fuploads%2FLrcTwyq1GXkfeW71THqN%2Fimage.png?alt=media&amp;token=d3a774e3-5aad-4425-8eac-b3300d41e014" 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="https://content.gitbook.com/content/n4EIoqjZx1xWQIo6LnjB/blobs/gzeKEcXMRyIMURXO7mN9/image.png" 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="https://content.gitbook.com/content/n4EIoqjZx1xWQIo6LnjB/blobs/vqVnNlmpTRa8xrmbLVF1/image.png" 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](https://features.scnd.com/v2.0/core-concepts/coupon-feature.md)

**Business rules:**

* [Coupon feature - Business rules](https://features.scnd.com/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 by asking a question.

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

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