# 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="https://2306631548-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fn4EIoqjZx1xWQIo6LnjB%2Fuploads%2FMvhlbyEyEbcuca3UIK6H%2Fimage.png?alt=media&#x26;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&#x26;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&#x26;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)

**Business rules:**

* [Coupon feature - Business rules](https://features.scnd.com/v2.0/core-concepts/coupon-feature)
